RUM とトレースの接続

1. RUM ブラウザモニタリングを設定します。

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

   import { datadogRum } from '@datadog/browser-rum'
   
   datadogRum.init({
       applicationId: '<DATADOG_APPLICATION_ID>',
       clientToken: '<DATADOG_CLIENT_TOKEN>',
       ...otherConfig,
       service: "my-web-application",
       allowedTracingOrigins: ["https://api.example.com", /https:\/\/.*\.my-api-domain\.com/]
   })
   

RUM をトレースに接続するには、service フィールドにブラウザアプリケーションを指定する必要があります。

注: allowedTracingOrigins は、<scheme> "://" <hostname> [ ":" <port> ] と定義された、ブラウザアプリケーションにより呼び出された呼び出し元と一致する Javascript 文字列および正規表現を受け入れます。

3. (オプション) tracingSampleRate 初期化パラメータを構成して、バックエンドトレースの定義されたパーセンテージを保持するように設定します。設定しない場合、ブラウザのリクエストから来るトレースの 100% が Datadog に送信されます。バックエンドトレースの 20% を保持する場合:

   import { datadogRum } from '@datadog/browser-rum'
   
   datadogRum.init({
       ...otherConfig,
       tracingSampleRate: 20
   })
   

注: tracingSampleRate は RUM セッションのサンプリングには影響しません。バックエンドのトレースのみがサンプリングされます。

1. RUM Android モニタリングを設定します。

2. 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 のトレースも有効になります。

3. (オプション) traceSamplingRate パラメータを構成して、バックエンドトレースの定義されたパーセンテージを保持するように設定します。設定しない場合、アプリケーションのリクエストから来るトレースの 100% が Datadog に送信されます。バックエンドトレースの 20% を保持する場合:

    val okHttpClient = OkHttpClient.Builder()
        .addInterceptor(RumInterceptor(traceSamplingRate = 100f))
       .build()

注: traceSamplingRate は RUM セッションのサンプリングには影響しません。バックエンドのトレースのみがサンプリングされます。

1. RUM iOS モニタリングを設定します。

2. 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()
   )
   

3. セットアップにあるように、URLSession を初期化します。

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

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

4. (オプション) tracingSamplingRate 初期化パラメータを設定して、バックエンドトレースの定義されたパーセンテージを保持するように設定します。設定しない場合、アプリケーションのリクエストから来るトレースの 100% が Datadog に送信されます。バックエンドトレースの 20% を保持する場合:

   Datadog.initialize(
   appContext: .init(),
   configuration: Datadog.Configuration
       .builderUsing(rumApplicationID: "<rum_app_id>", clientToken: "<client_token>", environment: "<env_name>")
       .set(tracingSamplingRate: 20)
       .build()
   )
   

注: tracingSamplingRate は RUM セッションのサンプリングには影響しません。バックエンドのトレースのみがサンプリングされます。