모바일 세션 재생 설치 및 설정

설정

모든 세션 재생 SDK 버전은 메이븐 스냅샷 리포지토리에서 확인할 수 있습니다.

Android에서 모바일 세션 재생을 설정하려면:

  1. 보기 계측이 활성화된 상태에서 Datadog Android RUM SDK 설정 및 초기화를 완료했는지 확인하세요.

  2. Datadog 세션 재생을 종속성으로 선언합니다:

build.gradle

    implementation("com.datadoghq:dd-sdk-android-rum:[datadog_version]")
    implementation("com.datadoghq:dd-sdk-android-session-replay:[datadog_version]")
    // material 지원이 필요한 경우
    implementation("com.datadoghq:dd-sdk-android-session-replay-material:[datadog_version]")
   
  1. 앱에서 세션 재생을 활성화합니다:

Application.kt

   val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    // material 확장 지원이 필요한 경우
    .addExtensionSupport(MaterialExtensionSupport()) 
    .build()
   SessionReplay.enable(sessionReplayConfig)
   

iOS용 모바일 세션 재생 설정하기:

  1. 보기 계측이 활성화된 상태에서 Datadog iOS RUM SDK 설정 및 초기화를 완료했는지 확인하세요.

  2. 패키지 매니저에 따라 Datadog 세션 재생 라이브러리를 프로젝트에 연결합니다:

    패키지 매니저설치 단계
    CocoaPodsPodfilepod 'DatadogSessionReplay'를 추가합니다.
    Swift Package Manager앱 대상에 DatadogSessionReplay 라이브러리를 종속성으로 추가합니다.
    Carthage앱 대상에 DatadogSessionReplay.xcframework를 종속성으로 추가합니다.
  3. 앱에서 세션 재생을 활성화합니다:

AppDelegate.swift

   import DatadogSessionReplay

   SessionReplay.enable(
       with: SessionReplay.Configuration(
           replaySampleRate: sampleRate
       )
   )
   

추가 설정

녹화된 세션의 샘플 속도가 표시되도록 설정

샘플 속도는 세션 재생 구성에서 필수 파라미터입니다. 이 값은 0.0에서 100.0 사이의 숫자여야 하며, 0은 어떠한 재생도 녹화되지 않음을 의미하고 100은 모든 RUM 세션에 재생이 포함됨을 의미합니다.

이 샘플 속도는 RUM 샘플 속도에 추가로 적용됩니다. 예를 들어 RUM이 80%의 샘플 속도를 사용하고 세션 재생이 20%의 샘플 속도를 사용하는 경우, 모든 사용자 세션 중 80%가 RUM에 포함되고 해당 세션 내에서는 20%만 재생을 가지고 있다는 의미입니다.

Application.kt

val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
 ...
.build()

AppDelegate.swift

var sessionReplayConfig = SessionReplay.Configuration(
    replaySampleRate: sampleRate
)

세션 재생 데이터가 전송되고 있는지 확인

앱에서 세션 재생 데이터를 보내고 있는지 확인하기 위해 Datadog SDK에서 디버그 옵션을 활성화할 수 있습니다.

Application.kt

Datadog.setVerbosity(Log.DEBUG)

AppDelegate.swift

Datadog.verbosityLevel = .debug

문제가 없다면 앱을 실행한 후 약 30초 후에 Xcode 디버그 콘솔에서 다음과 같은 로그가 나타납니다:

Xcode console

[DATADOG SDK] 🐶 → 10:21:29.812 ⏳ (session-replay) Uploading batch...
[DATADOG SDK] 🐶 → 10:21:30.442    → (session-replay) accepted, won't be retransmitted: [response code: 202 (accepted), request ID: BD445EA-...-8AFCD3F3D16]

개인정보 보호 옵션

개인정보 보호 옵션을 참조하세요.

참고 자료