RUM 및 트레이스 연결

1. RUM 브라우저 모니터링을 설정합니다.

2. RUM SDK를 시작합니다. 브라우저 애플리케이션이 호출한 내부 자사 출처 목록을 사용해 allowedTracingUrls 초기화 파라미터를 설정합니다.

   npm 설치:

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

   CDN 설치:

   window.DD_RUM.init({
      clientToken: '<CLIENT_TOKEN>',
      applicationId: '<APPLICATION_ID>',
      site: '<http://datadoghq.com|datadoghq.com>',
      //  service: 'my-web-application',
      //  env: 'production',
      //  version: '1.0.0',
      allowedTracingUrls: ["<https://api.example.com>", /https:\/\/.*\.my-api-domain\.com/, (url) => url.startsWith("<https://api.example.com>")]
      sessionSampleRate: 100,
      sessionReplaySampleRate: 100, // if not included, the default is 100
      trackResources: true,
      trackLongTasks: true,
      trackUserInteractions: true,
    })
   

   RUM을 트레이스에 연결하려면 service 필드에서 브라우저 애플리케이션을 지정해야 합니다.

   allowedTracingUrls는 전체 URL(<scheme>://<host>[:<port>]/<path>[?<query>][#<fragment>])과 일치합니다. 다음 유형을 허용합니다.

   • string: 해당 값으로 시작하는 모든 URL과 일치합니다. https://api.example.com은 https://api.example.com/v1/resource와 일치합니다.
   • RegExp: 제공된 RegExp 및 URL을 사용해 테스트를 실행합니다.
   • function: 파라미터로 URL을 평가합니다. boolean 세트를 true로 반환하면 일치를 나타냅니다.

3. (선택 사항) traceSampleRate 초기화 파라미터를 설정하여 정의된 백엔드 트레이스의 비율을 유지합니다. 설정하지 않으면 브라우저 요청에서 오는 트레이스 100%가 Datadog에 전송됩니다. 예를 들어, 백엔드 트레이스 20%를 유지하려면 다음을 수행해야 합니다.

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

참고: traceSampleRate은 RUM 세션 샘플링에 영향을 미치지 않습니다. 백엔드 트레이스만 선별됩니다.

1. RUM Android 모니터링을 설정합니다.

2. Android 트레이스 수집을 설정합니다.

3. 모듈 수준 build.gradle파일의 dd-sdk-android-okhttp라이브러리에 그래들 종속성을 추가합니다:

   dependencies {
       implementation "com.datadoghq:dd-sdk-android-okhttp:x.x.x"
   }
   

4. 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 트레이싱이 활성화됩니다.

5. (선택 사항) traceSampler 파라미터를 설정해 정의된 백엔드 트레이스를 유지합니다. 설정하지 않은 경우 애플리케이션 요청에서 기인한 트레이스 20%가 Datadog에 전송합니다. 백엔드 트레이스 100%를 유지하려면 다음을 수행합니다.

    val okHttpClient = OkHttpClient.Builder()
       .addInterceptor(DatadogInterceptor(traceSampler = RateBasedSampler(100f)))
       .build()

참고: traceSamplingRate는 RUM 세션 샘플링에 영향을 미치지 않습니다. 백엔드 트레이스만 선별됩니다.

1. RUM iOS 모니터링을 설정합니다.

2. iOS 애플리케이션에서 호출한 내부 자사 출처 목록을 사용해 trackURLSession(firstPartyHosts:) 빌더 함수를 호출합니다.

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

3. 글로벌 Tracer 초기화:

   Global.sharedTracer = Tracer.initialize(
       configuration: Tracer.Configuration(...)
   )
   

4. 설정의 URL 세션 초기화:

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

   기본적으로 목록화된 호스트의 모든 하위 도메인이 추적됩니다. 예를 들어 example.com을 추가하면 또한 api.example.com 및 foo.example.com 트레이싱이 활성화됩니다.

   트레이스 ID 주입은 URLRequest를 URLSession에 제공할 때 작동합니다. 분산된 트레이싱은 URL 개체를 사용할 때 작동하지 않습니다.

5. (선택 사항) tracingSamplingRate 초기화 파라미터를 설정해 정의된 백엔드 트레이스의 비율을 유지합니다. 설정하지 않으면 애플리케이션 요청에서 오는 트레이스 20%가 Datadog로 전송됩니다.

   백엔드 트레이스 100%를 유지하려면 다음을 수행합니다.

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

참고: tracingSamplingRate은 RUM 세션 샘플링에 영향을 미치지 않습니다. 백엔드 트레이스만 선별됩니다.

1. RUM React Native Monitoring을 설정합니다.

2. firstPartyHosts 초기화 파라미터를 설정해 React Native 애플리케이션에서 호출한 내부 자사 출처 목록을 정의합니다.

   const config = new DatadogProviderConfiguration(
       // ...
   );
   config.firstPartyHosts = ["example.com", "api.yourdomain.com"];
   

   기본적으로 목록화된 호스트의 모든 하위 도메인을 추적합니다. 예를 들어 example.com을 추가하면 또한 api.example.com 및 foo.example.com 트레이싱을 활성화합니다.

3. (선택 사항) resourceTracingSamplingRate 초기화 파라미터를 설정해 정의된 백엔드 트레이스의 비율을 유지합니다. 설정하지 않으면 애플리케이션 요청에서 오는 트레이스 20%가 Datadog로 전송됩니다.

   백엔드 트레이스 100%를 유지하려면 다음을 수행합니다.

   const config = new DatadogProviderConfiguration(
       // ...
   );
   config.resourceTracingSamplingRate = 100;
   

   참고: resourceTracingSamplingRate은 RUM 세션 샘플링에 영향을 미치지 않습니다. 백엔드 트레이스만 선별됩니다.

1. RUM Flutter Monitoring을 설정합니다.

2. 자동 리소스 추적에서 지침을 따라 Datadog 추적 HTTP 클라이언트 패키지를 포함하고 HTTP 추적을 활성화합니다. 이를 통해 초기화에 다음 변경 사항을 포함해 Flutter 애플리케이션에 호출한 내부 자사 출처 목록을 추가합니다.

   final configuration = DdSdkConfiguration(
     // ...
     // added configuration
     firstPartyHosts: ['example.com', 'api.yourdomain.com'],
   )..enableHttpTracking()
   

1. 애플리케이션에서 페이지에 방문합니다.
2. 브라우저 개발자 도구에서 네트워크 탭으로 이동합니다.
3. 연결하려는 리소스 요청에 대한 요청 헤더가 Datadog의 연결 헤더를 포함하는지 확인합니다.

1. Android Studio에서 애플리케이션을 실행합니다.
2. 애플리케이션에서 화면으로 이동합니다.
3. Android Studio의 네트워크 검사기를 엽니다.
4. RUM 리소스의 요청 헤더를 확인하고 요청한 헤더가 SDK로 설정되었는지 체크합니다.

1. Xcode에서 애플리케이션을 실행합니다.
2. 애플리케이션에서 화면으로 이동합니다.
3. Xcode의 네트워크 연결 및 HTTP 트래픽 계측을 엽니다.
4. RUM 리소스의 요청 헤더를 확인하고 요청한 헤더가 SDK로 설정되었는지 체크합니다.

1. Xcode(iOS)나 Android Studio(Android)에서 애플리케이션을 실행합니다.
2. 애플리케이션에서 화면으로 이동합니다.
3. Xcode의 네트워크 연결 및 HTTP 트래픽 계측 또는 Android Studio의 네트워크 검사기를 엽니다.
4. RUM 리소스의 요청 헤더를 확인하고 요청된 헤더가 SDK로 설정되었는지 체크하세요.

1. 원하는 IDE 또는 flutter run을 사용하여 애플리케이션을 실행합니다.
2. 애플리케이션에서 화면으로 이동합니다.
3. Flutter의 개발자 도구를 열고 네트워크 보기로 이동합니다.
4. RUM 리소스의 요청 헤더를 확인하고 요청된 헤더가 SDK로 설정되었는지 체크하세요.

참고: OpenTelemetry를 사용하는 Next.js/Vercel 등 백엔드 프레임워크를 사용하는 경우 다음 단계를 따르세요.

1. 위에 설명된 대로 RUM을 설정해 APM과 연결하세요.

2. allowedTracingUrls를 다음과 같이 수정하세요.

   import { datadogRum } from '@datadog/browser-rum'
   
   datadogRum.init({
       ...otherConfig,
       allowedTracingUrls: [
         { match: "https://api.example.com", propagatorTypes: ["tracecontext"]}
       ]
   })
   

   위에서 설명된 단순한 형식으로 사용할 때 match는 동일한 파라미터 유형(string, RegExp 또는 function)을 허용합니다.

   propagatorTypes은 원하는 전파기에 대해 문자열 목록을 허용합니다.

   • datadog: Datadog 전파기(x-datadog-*)
   • tracecontext: W3C 트레이스 컨텍스트 (traceparent)
   • b3: B3 single header (b3)
   • b3multi: B3 multiple headers (X-B3-*)

1. 위에 설명된 대로 RUM을 설정해 APM과 연결하세요.

2. 다음과 같이 trackURLSession(firstPartyHosts:) 대신 trackURLSession(firstPartyHostsWithHeaderTypes:)를 사용하세요.

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

   trackURLSession(firstPartyHostsWithHeaderTypes:)는 Dictionary<String, Set<TracingHeaderType>>을 파라미터로 사용합니다. 키는 호스트이며 값은 지원되는 트레이싱 헤더 유형 목록입니다.

   목록의 TracingHeaderType은 다음 트레이싱 헤더 유형을 나타냅니다.

   • .datadog: Datadog 전파기(x-datadog-*)
   • .tracecontext: W3C 트레이스 컨텍스트(traceparent)
   • .b3: B3 단일 헤더 (b3)
   • .b3multi: B3 다수 헤더 (X-B3-*)

1. 위에 설명된 대로 RUM을 설정해 APM과 연결하세요.

2. 다음과 같이 사용할 추척 헤더 유형과 내부 자사 출처 목록을 사용해 OkHttpClient 인터셉터를 설정하세요.

   val tracedHosts = mapOf("example.com" to setOf(TracingHeaderType.TRACECONTEXT), 
                         "example.eu" to setOf(TracingHeaderType.DATADOG))
   
   val okHttpClient = OkHttpClient.Builder()
       .addInterceptor(DatadogInterceptor(tracedHosts))
       .addNetworkInterceptor(TracingInterceptor(tracedHosts))
       .eventListenerFactory(DatadogEventListener.Factory())
      .build()
   

   TracingHeaderType은 다음 추적 헤더 유형을 나타내는 목록입니다.

   • .DATADOG: Datadog 전파기(x-datadog-*)입니다.
   • .TRACECONTEXT: W3C 트레이스 컨텍스트(traceparent)
   • .B3: B3 단일 헤더(b3)
   • .B3MULTI: B3 다수 헤더(X-B3-*)

1. RUM을 설정해 APM과 연결하세요.

2. 다음과 같이 사용할 추적 헤더 유형과 내부 자사 출처 목록을 사용해 RUM SDK를 설정하세요.

   const config = new DatadogProviderConfiguration(
       // ...
   );
   config.firstPartyHosts = [
       {match: "example.com", propagatorTypes: PropagatorType.TRACECONTEXT},
       {match: "example.com", propagatorTypes: PropagatorType.DATADOG}
   ];
   

   PropagatorType은 다음 추적 헤더 유형을 나타내는 목록입니다.

   • PropagatorType.DATADOG: Datadog 전파기(x-datadog-*)
   • PropagatorType.TRACECONTEXT: W3C 트레이스 컨텍스트 (traceparent)
   • PropagatorType.B3: B3 단일 헤더 (b3)
   • PropagatorType.B3MULTI: B3 다수 헤더 (X-B3-*)

1. 위에 설명된 대로 RUM을 설정해 APM과 연결하세요.

2. 다음과 같이 firstPartyHosts 대신 firstPartyHostsWithTracingHeaders를 사용하세요.

   final configuration = DdSdkConfiguration(
     // ...
     // added configuration
     firstPartyHostsWithTracingHeaders: {
       'example.com': { TracingHeaderType.tracecontext },
     },
   )..enableHttpTracking()
   

   firstPartyHostsWithTracingHeaders는 Map<String, Set<TracingHeaderType>>을 파라미터로 사용합니다. 키는 호스트이고 값은 지원되는 추적 헤더 유형 목록입니다.

   목록의 TracingHeaderType은 다음 트레이싱 헤더 유형을 나타냅니다.

   • TracingHeaderType.datadog: Datadog 전파기(x-datadog-*)
   • TracingHeaderType.tracecontext: W3C 트레이스 컨텍스트 (traceparent)
   • TracingHeaderType.b3: B3 단일 헤더 (b3)
   • TracingHeaderType.b3multi: B3 다수 헤더 (X-B3-*)

x-datadog-trace-id

실제 사용자 모니터링 SDK에서 생성됩니다. Datadog에서 트레이스를 RUM 리소스와 연결하도록 허용하세요.

x-datadog-parent-id

실제 사용자 모니터링 SDK에서 생성됩니다. Datadog가 트레이스에서 최초 스팬을 생성하도록 허용하세요.

x-datadog-origin: rum

실제 사용자 모니터링에서 생성된 트레이스가 APM 인덱스 스팬 개수에 영향을 미치지 않도록 하세요.

x-datadog-sampling-priority: 1

에이전트가 트레이스를 유지하도록 하세요.

traceparent: [version]-[trace id]-[parent id]-[trace flags]

version: 현재 사양은 버전이 00로 설정되어 있다고 간주합니다.

trace id: 128비트 트레이스 ID, 16진법 32자입니다. 소스 트레이스 ID는 64비트로 APM과의 호환성을 유지합니다.

parent id: 64비트 스팬 ID, 16진법 16자입니다.

trace flags: 샘플링된 (01) 또는 샘플링 안 된 (00)

예:

traceparent: 00-00000000000000008448eb211c80319c-b7ad6b7169203331s-01

b3: [trace id]-[span id]-[sampled]

trace id: 64비트 트레이스 ID, 16진법 16자입니다.

span id: 64비트 스팬 ID, 16진법 16자입니다.

sampled: 참(1) 또는 거짓(0)

b3 단일 헤더 예시:

b3: 8448eb211c80319c-b7ad6b7169203331-1

b3 다수 헤더 예시:

X-B3-TraceId: 8448eb211c80319c

X-B3-SpanId: b7ad6b7169203331

X-B3-Sampled: 1