RUM とトレースの接続

APM と Real User Monitoring のインテグレーションにより、Web およびモバイルアプリケーションからのリクエストを対応するバックエンドトレースにリンクできます。この組み合わせにより、1 つのレンズを通してフロントエンドとバックエンドの完全なデータを確認できます。

RUM のフロントエンドデータ、トレース ID 挿入のバックエンド、インフラストラクチャー、ログ情報を使用して、スタック内の問題をすばやく特定し、ユーザーに起こっていることを完全に理解します。

使用方法

前提条件

RUM アプリケーションの対象となるサービスに APM トレースを設定します。
サービスが HTTP サーバーを使用していること。
HTTP サーバーで、分散型トレーシングをサポートするライブラリが使用されていること。

RUM のセットアップ

Dropdown

Browser Real User Monitoring を設定します。
RUM SDK を初期化します。ブラウザアプリケーションによって呼び出される内部 (ファーストパーティ) オリジンのリストを使用して、allowedTracingOrigins 初期化パラメーターを設定します。

import { datadogRum } from '@datadog/browser-rum'

datadogRum.init({
    applicationId: '<DATADOG_APPLICATION_ID>',
    clientToken: '<DATADOG_CLIENT_TOKEN>',
    ...otherConfig,
    allowedTracingOrigins: ["https://api.example.com", /https:\/\/.*\.my-api-domain\.com/]
})

注: allowedTracingOrigins は Javascript 文字列と正規表現を受け入れます。

Android Real User Monitoring を設定します。
Android アプリケーションによって呼び出される内部 (ファーストパーティ) オリジンのリストを使用して、OkHttpClient インターセプターを構成します。

val tracedHosts =  listOf("example.com", "example.eu")

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(DatadogInterceptor(tracedHosts))
    .addNetworkInterceptor(TracingInterceptor(tracedHosts))
    .eventListenerFactory(DatadogEventListener.Factory())
    .build()

注: デフォルトでは、リストされたホストのすべてのサブドメインがトレースされます。たとえば、example.com を追加すると、api.example.com と foo.example.com のトレースも有効になります。

iOS Real User Monitoring を設定します。
iOS アプリケーションによって呼び出される内部 (ファーストパーティ) オリジンのリストを使用して、firstPartyHosts 初期化パラメーターを設定します。

Datadog.initialize(
appContext: .init(),
configuration: Datadog.Configuration
    .builderUsing(rumApplicationID: "<rum_app_id>", clientToken: "<client_token>", environment: "<env_name>")
    .set(firstPartyHosts: ["example.com", "api.yourdomain.com"])
    .build()
)

セットアップドキュメントに記載されているように URLSession を初期化します。

let session =  URLSession(
    configuration: ...,
    delegate: DDURLSessionDelegate(),
    delegateQueue: ...
)

サポートされているライブラリ

以下の Datadog トレーシングライブラリがサポートされています。

ライブラリ	最小バージョン
Python	0.22.0
Go	1.10.0
Java	0.24.1
Ruby	0.20.0
JavaScript	0.10.0
PHP	0.33.0
.NET	1.18.2

RUM リソースはどのようにトレースにリンクされていますか？

Datadog は、分散型トレーシングプロトコルを使用し、以下の HTTP ヘッダーを設定します。

ヘッダー	説明
`x-datadog-trace-id`	Real User Monitoring SDK から生成されます。Datadog がトレースを RUM リソースにリンクできるようにします。
`x-datadog-parent-id`	Real User Monitoring SDK から生成されます。Datadog がトレースから最初のスパンを生成できるようにします。
`x-datadog-origin: rum`	Real User Monitoring から生成されたトレースが、APM インデックススパン数に影響を与えないようにするため。
`x-datadog-sampling-priority: 1`	Agent がトレースを維持するようにします。
`x-datadog-sampled: 1`	Real User Monitoring SDK から生成されます。このリクエストがサンプリング用に選択されていることを示します。