개요

주요 버전의 모바일 RUM, 로그 및 트레이스 SDK 간 마이그레이션을 수행하려면 이 가이드를 참조하세요. 각 SDK의 기능 및 성능에 대한 자세한 내용은 각 SDK 설명서를 참조하세요.

버전 1에서 버전 2로

버전 1에서 버전 2로의 마이그레이션은 monolith SDK에서 모듈형 아키텍처로의 마이그레이션을 나타냅니다. RUM, 트레이스, 로그, 세션 재생 등은 각각 개별 모듈을 가지고 있으므로 애플리케이션에 필요한 것만 통합할 수 있습니다.

SDK v2는 iOS SDK, Android SDK 및 기타 Datadog 제품 간의 통합 API 레이아웃 및 이름 정렬 기능을 제공합니다.

SDK v2를 통해 Android 및 iOS 애플리케이션에서 [모바일 세션 재생][1]을 사용할 수 있습니다.

버전 1에서 버전 2로의 마이그레이션은 monolith SDK에서 모듈형 아키텍처로의 마이그레이션을 나타냅니다. RUM, 트레이스, 로그, 세션 재생 등은 각각 개별 모듈을 가지고 있으므로 애플리케이션에 필요한 것만 통합할 수 있습니다.

SDK v2는 iOS SDK, Android SDK 및 기타 Datadog 제품 간의 통합 API 레이아웃 및 이름 정렬 기능을 제공합니다.

SDK v2를 통해 Android 및 iOS 애플리케이션에서 [모바일 세션 재생][1]을 사용할 수 있습니다.

버전 1에서 버전 2로 마이그레이션하면 성능이 향상됩니다.

모듈

아티팩트는 버전 2에서 모듈화됩니다. 다음 아티팩트를 채택하세요:

  • RUM: com.datadoghq:dd-sdk-android-rum:x.x.x
  • 로그: com.datadoghq:dd-sdk-android-logs:x.x.x
  • 트레이스: com.datadoghq:dd-sdk-android-trace:x.x.x
  • 세션 재생: com.datadoghq:dd-sdk-android-session-replay:x.x.x
  • WebView 추적: com.datadoghq:dd-sdk-android-webview:x.x.x
  • OkHttp 계측: com.datadoghq:dd-sdk-android-okhttp:x.x.x

참고: NDK 충돌 보고와 WebView 추적을 사용하는 경우 이벤트를 RUM과 로그에 각각 보고하기 위해 RUM과 로그 아티팩트를 추가해야 합니다.

아티팩트가 더 이상 존재하지 않으므로 Gradle 빌드 스크립트에서 com.datadoghq:dd-sdk-android 아티팩트에 대한 참조를 제거해야 합니다.

참고: 다른 모든 아티팩트의 Maven 좌표는 동일하게 유지됩니다.

v2는 Android API 19(KitKat)를 지원하지 않습니다. 지원되는 최소 SDK는 이제 API 21(Lollipop)입니다. Kotlin 1.7이 필요합니다. SDK 자체는 Kotlin 1.8로 컴파일되므로 Kotlin 1.6 이하의 컴파일러는 SDK 클래스 메타데이터를 읽을 수 없습니다.

다음과 같은 오류가 발생하는 경우:

A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable
Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt found in modules kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and kotlin-stdlib-jdk8-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.20)

빌드 스크립트에 다음 규칙을 추가합니다(자세한 내용은 관련 스택 오버플로우 문제에서 확인):

dependencies {
    constraints {
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.10") {
            because("kotlin-stdlib-jdk7 is now a part of kotlin-stdlib")
        }
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.10") {
            because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
        }
    }
}

SDK 설정 방법에 대한 예시는 Android 샘플 애플리케이션을 참조하세요.

라이브러리는 v2에서 모듈화됩니다. 다음 라이브러리를 채택하세요.

  • DatadogCore
  • DatadogLogs
  • DatadogTrace
  • DatadogSessionReplay
  • DatadogRUM
  • DatadogWebViewTracking

기존 DatadogCrashReportingDatadogObjc에 추가로 제공됩니다.

SPM
let package = Package(
  ...
  dependencies: [
      .package(url: "https://github.com/DataDog/dd-sdk-ios", from: "2.0.0")
  ],
  targets: [
      .target(
          ...
          dependencies: [
              .product(name: "DatadogCore", package: "dd-sdk-ios"),
              .product(name: "DatadogLogs", package: "dd-sdk-ios"),
              .product(name: "DatadogTrace", package: "dd-sdk-ios"),
              .product(name: "DatadogSessionReplay", package: "dd-sdk-ios"),
              .product(name: "DatadogRUM", package: "dd-sdk-ios"),
              .product(name: "DatadogCrashReporting", package: "dd-sdk-ios"),
              .product(name: "DatadogWebViewTracking", package: "dd-sdk-ios"),
          ]
      ),
  ]
)
CocoaPods
pod 'DatadogCore'
pod 'DatadogLogs'
pod 'DatadogTrace'
pod 'DatadogSessionReplay'
pod 'DatadogRUM'
pod 'DatadogCrashReporting'
pod 'DatadogWebViewTracking'
pod 'DatadogObjc'
Carthage

The Cartfile stays the same:

github "DataDog/dd-sdk-ios"

In Xcode, you must link the following frameworks:

DatadogInternal.xcframework
DatadogCore.xcframework

Then you can select the modules you want to use:

DatadogLogs.xcframework
DatadogTrace.xcframework
DatadogSessionReplay.xcframework
DatadogRUM.xcframework
DatadogCrashReporting.xcframework + CrashReporter.xcframework
DatadogWebViewTracking.xcframework
DatadogObjc.xcframework

참고: 충돌 보고와 WebView 추적을 사용할 경우 RUM과 로그 모듈을 추가하여 이벤트를 각각 RUM과 로그에 보고해야 합니다.

package.json에서 @datadog/mobile-react-native를 업데이트합니다:

"@datadog/mobile-react-native": "2.0.0"

iOS 파드를 업데이트합니다:

(cd ios && bundle exec pod update)

React Native 버전을 0.67 이상으로만 사용하는 경우 Java 버전 17을 사용하세요. React Native 버전을 0.67 또는 이하로 사용하는 경우 Java 버전 11을 사용하세요. Java 버전을 확인하려면 터미널에서 다음을 실행합니다:

java --version

React Native < 0.73의 경우

android/build.gradle 파일에서 Kotlin 종속성 간 충돌을 방지하도록 kotlinVersion을 지정합니다:

buildscript {
    ext {
        // targetSdkVersion = ...
        kotlinVersion = "1.8.21"
    }
}

React Native < 0.68의 경우

android/build.gradle 파일에서 Kotlin 종속성 간 충돌을 방지하도록 kotlinVersion을 지정합니다:

buildscript {
    ext {
        // targetSdkVersion = ...
        kotlinVersion = "1.8.21"
    }
}

android/build.gradle에서 5.0 이하의 com.android.tools.build:gradle 버전을 사용하는 경우 android/gradle.properties 파일을 추가합니다:

android.jetifier.ignorelist=dd-sdk-android-core

트러블슈팅

Unable to make field private final java.lang.String java.io.File.path accessible와 Android 빌드 실패

Android 빌드가 다음과 같은 오류로 실패하는 경우

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:processReleaseMainManifest'.
> Unable to make field private final java.lang.String java.io.File.path accessible: module java.base does not "opens java.io" to unnamed module @1bbf7f0e

React Native 버전과 호환되지 않는 Java 17을 사용하고 있습니다. 문제를 해결하려면 Java 11로 전환하세요.

Unsupported class file major version 61와 Android 빌드 실패

Android 빌드가 다음과 같은 오류로 실패하는 경우

FAILURE: Build failed with an exception.

* What went wrong:
Could not determine the dependencies of task ':app:lintVitalRelease'.
> Could not resolve all artifacts for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform dd-sdk-android-core-2.0.0.aar (com.datadoghq:dd-sdk-android-core:2.0.0) to match attributes {artifactType=android-manifest, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}.
      > Execution failed for JetifyTransform: /Users/me/.gradle/caches/modules-2/files-2.1/com.datadoghq/dd-sdk-android-core/2.0.0/a97f8a1537da1de99a86adf32c307198b477971f/dd-sdk-android-core-2.0.0.aar.
         > Failed to transform '/Users/me/.gradle/caches/modules-2/files-2.1/com.datadoghq/dd-sdk-android-core/2.0.0/a97f8a1537da1de99a86adf32c307198b477971f/dd-sdk-android-core-2.0.0.aar' using Jetifier. Reason: IllegalArgumentException, message: Unsupported class file major version 61. (Run with --stacktrace for more details.)

5.0 이하 버전의 Android Gradle Plugin을 사용하고 있습니다. 문제를 해결하려면 android/gradle.properties 파일을 추가하세요:

android.jetifier.ignorelist=dd-sdk-android-core

Duplicate class kotlin.collections.jdk8.*와 Android 빌드가 실패

안드로이드 빌드가 다음과 같은 오류로 실패하는 경우

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:checkReleaseDuplicateClasses'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable
   > Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt found in modules jetified-kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and jetified-kotlin-stdlib-jdk8-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.20)
     Duplicate class kotlin.internal.jdk7.JDK7PlatformImplementations found in modules jetified-kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and jetified-kotlin-stdlib-jdk7-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.20)

Kotlin 종속성 간의 충돌을 방지하려면 프로젝트에 Kotlin 버전을 설정해야 합니다. android/build.gradle 파일에서 kotlinVersion을 지정하세요:

buildscript {
    ext {
        // targetSdkVersion = ...
        kotlinVersion = "1.8.21"
    }
}

또는 android/app/build.gradle 파일의 빌드 스크립트에 다음 규칙을 추가할 수 있습니다:

dependencies {
    constraints {
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.10") {
            because("kotlin-stdlib-jdk7 is now a part of kotlin-stdlib")
        }
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.10") {
            because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
        }
    }
}

SDK 초기화

서로 다른 제품을 독립 모듈로 추출하여 SDK 설정을 모듈별로 구성합니다.

com.datadog.android.core.configuration.Configuration.Builder 클래스의 변경 사항은 다음과 같습니다:

  • 클라이언트 토큰, 환경 이름, 변수 이름 (기본값은 빈 문자열) 및 서비스 이름(기본값은 매니페스트에서 가져온 애플리케이션 ID)을 컨스트럭터에서 제공해야 합니다.
  • com.datadog.android.core.configuration.Credentials 클래스가 제거되었습니다.
  • 개별 제품 설정을 위해 logsEnabled, tracesEnabledrumEnabled는 컨스트럭터에서 제거됩니다(아래 참조).
  • crashReportsEnabled 컨스트럭터 인수가 제거되었습니다. Configuration.Builder.setCrashReportsEnabled 메서드를 사용하여 JVM 충돌 보고를 활성화하거나 비활성화할 수 있습니다. 기본적으로 JVM 충돌 보고는 활성화되어 있습니다.
  • RUM, 로그 및 트레이스 제품 설정 메서드는 개별 제품 설정에 맞게 Configuration.Builder에서 제거됩니다(아래 참조).

Datadog.initialize 메서드의 인수 목록에서 Credentials 클래스가 제거되었습니다.

com.datadog.android.plugin 패키지 및 모든 관련 클래스/메서드가 제거됩니다.

로그

로그 제품과 관련된 모든 클래스는 com.datadog.android.log 패키지에 포함되어 있습니다.

로그 제품을 사용하려면 다음 아티팩트를 가져오세요:

implementation("com.datadoghq:dd-sdk-android-logs:x.x.x")

다음 스니펫을 사용하여 로그 제품을 실행할 수 있습니다:

val logsConfig = LogsConfiguration.Builder()
    ...
    .build()

Logs.enable(logsConfig)

val logger = Logger.Builder()
    ...
    .build()

API 변경 사항:

1.x2.0
com.datadog.android.core.configuration.Configuration.Builder.setLogEventMappercom.datadog.android.log.LogsConfiguration.Builder.setEventMapper
com.datadog.android.core.configuration.Configuration.Builder.useCustomLogsEndpointcom.datadog.android.log.LogsConfiguration.Builder.useCustomEndpoint
com.datadog.android.log.Logger.Builder.setLoggerNamecom.datadog.android.log.Logger.Builder.setName
com.datadog.android.log.Logger.Builder.setSampleRatecom.datadog.android.log.Logger.Builder.setRemoteSampleRate
com.datadog.android.log.Logger.Builder.setDatadogLogsEnabled이 메서드가 제거되었습니다. Datadog에 로그를 전송할 수 없도록 com.datadog.android.log.Logger.Builder.setRemoteSampleRate(0f)를 대신 사용하세요.
com.datadog.android.log.Logger.Builder.setServiceNamecom.datadog.android.log.Logger.Builder.setService
com.datadog.android.log.Logger.Builder.setDatadogLogsMinPrioritycom.datadog.android.log.Logger.Builder.setRemoteLogThreshold

트레이스

트레이스 제품과 관련된 모든 클래스는 com.datadog.android.trace 패키지에 포함되어 있습니다(즉, 이전에 com.datadog.android.tracing에 존재했던 모든 클래스가 이동했음을 의미합니다).

트레이스 제품을 사용하려면 다음 아티팩트를 가져오세요:

implementation("com.datadoghq:dd-sdk-android-trace:x.x.x")

다음 스니펫을 사용하여 트레이스 제품을 실행할 수 있습니다:

val traceConfig = TraceConfiguration.Builder()
    ...
    .build()

Trace.enable(traceConfig)

val tracer = AndroidTracer.Builder()
    ...
    .build()

GlobalTracer.registerIfAbsent(tracer)

API 변경 사항:

1.x2.0
com.datadog.android.core.configuration.Configuration.Builder.setSpanEventMappercom.datadog.android.trace.TraceConfiguration.Builder.setEventMapper
com.datadog.android.core.configuration.Configuration.Builder.useCustomTracesEndpointcom.datadog.android.trace.TraceConfiguration.Builder.useCustomEndpoint
com.datadog.android.tracing.AndroidTracer.Builder.setSamplingRatecom.datadog.android.trace.AndroidTracer.Builder.setSampleRate
com.datadog.android.tracing.AndroidTracer.Builder.setServiceNamecom.datadog.android.trace.AndroidTracer.Builder.setService

RUM

RUM 제품과 관련된 모든 클래스는 com.datadog.android.rum 패키지에 포함되어 있습니다.

RUM 제품을 사용하려면 다음 아티팩트를 가져오세요:

implementation("com.datadoghq:dd-sdk-android-rum:x.x.x")

다음 스니펫을 사용하여 RUM 제품을 실행할 수 있습니다:

val rumConfig = RumConfiguration.Builder(rumApplicationId)
    ...
    .build()

Rum.enable(rumConfig)

API 변경 사항:

1.x2.0
com.datadog.android.core.configuration.Configuration.Builder.setRumViewEventMappercom.datadog.android.rum.RumConfiguration.Builder.setViewEventMapper
com.datadog.android.core.configuration.Configuration.Builder.setRumResourceEventMappercom.datadog.android.rum.RumConfiguration.Builder.setResourceEventMapper
com.datadog.android.core.configuration.Configuration.Builder.setRumActionEventMappercom.datadog.android.rum.RumConfiguration.Builder.setActionEventMapper
com.datadog.android.core.configuration.Configuration.Builder.setRumErrorEventMappercom.datadog.android.rum.RumConfiguration.Builder.setErrorEventMapper
com.datadog.android.core.configuration.Configuration.Builder.setRumLongTaskEventMappercom.datadog.android.rum.RumConfiguration.Builder.setLongTaskEventMapper
com.datadog.android.core.configuration.Configuration.Builder.useCustomRumEndpointcom.datadog.android.rum.RumConfiguration.Builder.useCustomEndpoint
com.datadog.android.event.ViewEventMappercom.datadog.android.rum.event.ViewEventMapper
com.datadog.android.core.configuration.VitalsUpdateFrequencycom.datadog.android.rum.configuration.VitalsUpdateFrequency
com.datadog.android.core.configuration.Configuration.Builder.trackInteractionscom.datadog.android.rum.RumConfiguration.Builder.trackUserInteractions
com.datadog.android.core.configuration.Configuration.Builder.disableInteractionTrackingcom.datadog.android.rum.RumConfiguration.Builder.disableUserInteractionTracking
com.datadog.android.core.configuration.Configuration.Builder.sampleRumSessionscom.datadog.android.rum.RumConfiguration.Builder.setSessionSampleRate
com.datadog.android.core.configuration.Configuration.Builder.sampleTelemetrycom.datadog.android.rum.RumConfiguration.Builder.setTelemetrySampleRate
com.datadog.android.rum.RumMonitor.Builder이 클래스가 제거되었습니다. Rum.enable 호출 중에 RUM 모니터가 생성되고 등록됩니다.
com.datadog.android.rum.RumMonitor.Builder.sampleRumSessionscom.datadog.android.rum.RumConfiguration.Builder.setSessionSampleRate
com.datadog.android.rum.RumMonitor.Builder.setSessionListenercom.datadog.android.rum.RumConfiguration.Builder.setSessionListener
com.datadog.android.rum.RumMonitor.addUserActioncom.datadog.android.rum.RumMonitor.addAction
com.datadog.android.rum.RumMonitor.startUserActioncom.datadog.android.rum.RumMonitor.startAction
com.datadog.android.rum.RumMonitor.stopUserActioncom.datadog.android.rum.RumMonitor.stopAction
com.datadog.android.rum.GlobalRum.registerIfAbsent이 메서드가 제거되었습니다. Rum.enable 호출 중에 RUM 모니터가 생성되고 등록됩니다.
com.datadog.android.rum.GlobalRumcom.datadog.android.rum.GlobalRumMonitor
com.datadog.android.rum.GlobalRum.addAttributecom.datadog.android.rum.RumMonitor.addAttribute
com.datadog.android.rum.GlobalRum.removeAttributecom.datadog.android.rum.RumMonitor.removeAttribute

NDK 충돌 보고

아티팩트 이름은 이전과 동일합니다: com.datadoghq:dd-sdk-android-ndk:x.x.x.

다음 스니펫을 사용하여 NDK 충돌 보고를 실행할 수 있습니다:

NdkCrashReports.enable()

이 설정은 com.datadog.android.core.configuration.Configuration.Builder.addPlugin 호출을 대체합니다.

참고: RUM 및 로그 제품을 활성화하여 각각 RUM 및 로그에서 NDK 충돌 보고서를 수신해야 합니다.

WebView 추적

아티팩트 이름은 이전과 동일하게 유지됩니다: com.datadoghq:dd-sdk-android-webview:x.x.x

다음 스니펫을 사용하여 WebView 추적을 활성화할 수 있습니다:

WebViewTracking.enable(webView, allowedHosts)

참고: WebView에서 발생하는 이벤트를 각각 RUM과 로그에서 수신하려면 RUM 및 Logs 제품을 활성화해야 합니다.

API 변경 사항:

1.x2.0
com.datadog.android.webview.DatadogEventBridge이 메서드는 internal 클래스가 되었습니다. 대신 WebViewTracking을 사용하세요.
com.datadog.android.rum.webview.RumWebChromeClient이 클래스가 제거되었습니다. 대신 WebViewTracking을 사용하세요.
com.datadog.android.rum.webview.RumWebViewClient이 클래스가 제거되었습니다. 대신 WebViewTracking을 사용하세요.

OkHttp 추적

OkHttp 추적을 사용하려면 다음 아티팩트를 가져오세요:

implementation("com.datadoghq:dd-sdk-android-okhttp:x.x.x")

OkHttp 계측은 OkHttp 클라이언트 이후에 Datadog SDK의 초기화를 지원하므로, Datadog SDK 이전에 com.datadog.android.okhttp.DatadogEventListener, com.datadog.android.okhttp.DatadogInterceptorcom.datadog.android.okhttp.trace.TracingInterceptor를 생성할 수 있습니다. OkHttp 계측은 Datadog SDK가 초기화되면 이벤트를 Datadog에 보고하기 시작합니다.

com.datadog.android.okhttp.DatadogInterceptorcom.datadog.android.okhttp.trace.TracingInterceptor 모두 원격 설정 시스템과의 통합을 통해 샘플링을 동적으로 제어할 수 있습니다.

샘플링을 동적으로 조정하려면 com.datadog.android.okhttp.DatadogInterceptor/com.datadog.android.okhttp.trace.TracingInterceptor 컨스트럭터에서 com.datadog.android.core.sampling.Sampler 인터페이스의 자체 구현을 제공합니다. 샘플링 결정을 내리기 위해 각 요청에 대해 쿼리됩니다.

dd-sdk-android-ktx 모듈 제거

사용되는 Datadog SDK 라이브러리에 대한 세분화를 개선하기 위해 dd-sdk-android-ktx 모듈을 제거합니다. 코드는 다른 모듈들 사이에 분산되어 RUM 및 트레이스 기능 모두에 대한 확장 메서드를 제공합니다.

1.x‘2.0’모듈 이름
com.datadog.android.ktx.coroutine#kotlinx.coroutines.CoroutineScope.launchTracedcom.datadog.android.trace.coroutines#kotlinx.coroutines.CoroutineScope.launchTraceddd-sdk-android-trace-coroutines
com.datadog.android.ktx.coroutine#runBlockingTracedcom.datadog.android.trace.coroutines#runBlockingTraceddd-sdk-android-trace-coroutines
com.datadog.android.ktx.coroutine#kotlinx.coroutines.CoroutineScope.asyncTracedcom.datadog.android.trace.coroutines#kotlinx.coroutines.CoroutineScope.asyncTraceddd-sdk-android-trace-coroutines
com.datadog.android.ktx.coroutine#kotlinx.coroutines.Deferred<T>.awaitTracedcom.datadog.android.trace.coroutines#kotlinx.coroutines.Deferred<T>.awaitTraceddd-sdk-android-trace-coroutines
com.datadog.android.ktx.coroutine#withContextTracedcom.datadog.android.trace.coroutines#withContextTraceddd-sdk-android-trace-coroutines
com.datadog.android.ktx.coroutine.CoroutineScopeSpancom.datadog.android.trace.coroutines.CoroutineScopeSpandd-sdk-android-trace-coroutines
com.datadog.android.ktx.sqlite#android.database.sqlite.SQLiteDatabase.transactionTracedcom.datadog.android.trace.sqlite#android.database.sqlite.SQLiteDatabase.transactionTraceddd-sdk-android-trace
com.datadog.android.ktx.tracing#io.opentracing.Span.setErrorcom.datadog.android.trace#io.opentracing.Span.setErrordd-sdk-android-trace
com.datadog.android.ktx.tracing#withinSpancom.datadog.android.trace#withinSpandd-sdk-android-trace
com.datadog.android.ktx.coroutine#sendErrorToDatadogcom.datadog.android.rum.coroutines#sendErrorToDatadogdd-sdk-android-rum-coroutines
com.datadog.android.ktx.rum#java.io.Closeable.useMonitoredcom.datadog.android.rum#java.io.Closeable.useMonitoreddd-sdk-android-rum
com.datadog.android.ktx.rum#android.content.Context.getAssetAsRumResourcecom.datadog.android.rum.resource#android.content.Context.getAssetAsRumResourcedd-sdk-android-rum
com.datadog.android.ktx.rum#android.content.Context.getRawResAsRumResourcecom.datadog.android.rum.resource#android.content.Context.getRawResAsRumResourcedd-sdk-android-rum
com.datadog.android.ktx.rum#java.io.InputStream.asRumResourcecom.datadog.android.rum.resource#java.io.InputStream.asRumResourcedd-sdk-android-rum
com.datadog.android.ktx.tracing#okhttp3.Request.Builder.parentSpancom.datadog.android.okhttp.trace#okhttp3.Request.Builder.parentSpandd-sdk-android-okhttp

세션 재생

모바일 세션 재생 설정에 대한 자세한 내용은 모바일 세션 재생 설정 및 구성을 참조하세요.

서로 다른 제품을 독립 모듈로 추출하여 SDK 설정을 모듈별로 구성합니다.

SDK를 초기화해야 제품을 활성화할 수 있습니다.

SDK 초기화의 빌더 패턴은 구조 정의에 맞게 제거되었습니다. 다음 예제는 1.x 초기화가 2.0에서 어떻게 변환되는지 보여줍니다.

V1 초기화

import Datadog

Datadog.initialize(
    appContext: .init(),
    trackingConsent: .granted,
    configuration: Datadog.Configuration
        .builderUsing(
            clientToken: "<client token>",
            environment: "<environment>"
        )
        .set(serviceName: "<service name>")
        .build()

V2 초기화

import DatadogCore

Datadog.initialize(
    with: Datadog.Configuration(
        clientToken: "<client token>",
        env: "<environment>",
        service: "<service name>"
    ),
    trackingConsent: .granted
)

API 변경 사항:

1.x2.0
Datadog.Configuration.Builder.set(serviceName:)Datadog.Configuration.service
Datadog.Configuration.Builder.set(batchSize:)Datadog.Configuration.batchSize
Datadog.Configuration.Builder.set(uploadFrequency:)Datadog.Configuration.uploadFrequency
Datadog.Configuration.Builder.set(proxyConfiguration:)Datadog.Configuration.proxyConfiguration
Datadog.Configuration.Builder.set(encryption:)Datadog.Configuration.encryption
Datadog.Configuration.Builder.set(serverDateProvider:)Datadog.Configuration.serverDateProvider
Datadog.AppContext(mainBundle:)Datadog.Configuration.bundle

로그

로그와 관련된 모든 클래스는 DatadogLogs 모듈에 있습니다. 먼저 제품을 활성화해야 합니다:

import DatadogLogs

Logs.enable(with: Logs.Configuration(...))

그런 다음 로거 인스턴스를 생성할 수 있습니다:

import DatadogLogs

let logger = Logger.create(
    with: Logger.Configuration(name: "<logger name>")
)

API 변경 사항:

1.x2.0
Datadog.Configuration.Builder.setLogEventMapper(_:)Logs.Configuration.eventMapper
Datadog.Configuration.Builder.set(loggingSamplingRate:)Logs.Configuration.eventMapper
Logger.Builder.set(serviceName:)Logger.Configuration.service
Logger.Builder.set(loggerName:)Logger.Configuration.name
Logger.Builder.sendNetworkInfo(_:)Logger.Configuration.networkInfoEnabled
Logger.Builder.bundleWithRUM(_:)Logger.Configuration.bundleWithRumEnabled
Logger.Builder.bundleWithTrace(_:)Logger.Configuration.bundleWithTraceEnabled
Logger.Builder.sendLogsToDatadog(false)Logger.Configuration.remoteSampleRate = 0
Logger.Builder.set(datadogReportingThreshold:)Logger.Configuration.remoteLogThreshold
Logger.Builder.printLogsToConsole(_:, usingFormat)Logger.Configuration.consoleLogFormat

트레이스

트레이스와 관련된 모든 클래스는 DatadogTrace 모듈에 있습니다. 먼저 제품을 활성화해야 합니다:

import DatadogTrace

Trace.enable(
    with: Trace.Configuration(...)
)

그런 다음 공유된 추적 인스턴스에 액세스할 수 있습니다:

import DatadogTrace

let tracer = Tracer.shared()

API 변경 사항:

1.x2.0
Datadog.Configuration.Builder.trackURLSession(_:)Trace.Configuration.urlSessionTracking
Datadog.Configuration.Builder.setSpanEventMapper(_:)Trace.Configuration.eventMapper
Datadog.Configuration.Builder.set(tracingSamplingRate:)Trace.Configuration.sampleRate
Tracer.Configuration.serviceNameTrace.Configuration.service
Tracer.Configuration.sendNetworkInfoTrace.Configuration.networkInfoEnabled
Tracer.Configuration.globalTagsTrace.Configuration.tags
Tracer.Configuration.bundleWithRUMTrace.Configuration.bundleWithRumEnabled
Tracer.Configuration.samplingRateTrace.Configuration.sampleRate

RUM

RUM과 관련된 모든 클래스는 DatadogRUM 모듈에 있습니다. 먼저 제품을 활성화해야 합니다:

import DatadogRUM

RUM.enable(
    with: RUM.Configuration(applicationID: "<RUM Application ID>")
)

그런 다음 공유된 RUM 모니터 인스턴스에 액세스할 수 있습니다:

import DatadogRUM

let monitor = RUMMonitor.shared()

API 변경 사항:

1.x2.0
Datadog.Configuration.Builder.trackURLSession(_:)RUM.Configuration.urlSessionTracking
Datadog.Configuration.Builder.set(rumSessionsSamplingRate:)RUM.Configuration.sessionSampleRate
Datadog.Configuration.Builder.onRUMSessionStartRUM.Configuration.onSessionStart
Datadog.Configuration.Builder.trackUIKitRUMViews(using:)RUM.Configuration.uiKitViewsPredicate
Datadog.Configuration.Builder.trackUIKitRUMActions(using:)RUM.Configuration.uiKitActionsPredicate
Datadog.Configuration.Builder.trackRUMLongTasks(threshold:)RUM.Configuration.longTaskThreshold
Datadog.Configuration.Builder.setRUMViewEventMapper(_:)RUM.Configuration.viewEventMapper
Datadog.Configuration.Builder.setRUMResourceEventMapper(_:)RUM.Configuration.resourceEventMapper
Datadog.Configuration.Builder.setRUMActionEventMapper(_:)RUM.Configuration.actionEventMapper
Datadog.Configuration.Builder.setRUMErrorEventMapper(_:)RUM.Configuration.errorEventMapper
Datadog.Configuration.Builder.setRUMLongTaskEventMapper(_:)RUM.Configuration.longTaskEventMapper
Datadog.Configuration.Builder.setRUMResourceAttributesProvider(_:)RUM.Configuration.urlSessionTracking.resourceAttributesProvider
Datadog.Configuration.Builder.trackBackgroundEvents(_:)RUM.Configuration.trackBackgroundEvents
Datadog.Configuration.Builder.trackFrustrations(_:)RUM.Configuration.frustrationsTracking
Datadog.Configuration.Builder.set(mobileVitalsFrequency:)RUM.Configuration.vitalsUpdateFrequency
Datadog.Configuration.Builder.set(sampleTelemetry:)RUM.Configuration.telemetrySampleRate

충돌 보고

충돌 보고를 활성화하려면 RUM과 로그가 각각 해당 제품에 보고하도록 활성화해야 합니다.

import DatadogCrashReporting

CrashReporting.enable()
1.x2.0
Datadog.Configuration.Builder.enableCrashReporting()CrashReporting.enable()

WebView 추적

WebViewTracking을 활성화하려면 RUM과 로그가 각각 해당 제품에 보고하도록 활성화해야 합니다.

import WebKit
import DatadogWebViewTracking

let webView = WKWebView(...)
WebViewTracking.enable(webView: webView)
1.x2.0
WKUserContentController.startTrackingDatadogEventsWebViewTracking.enable(webView:)

세션 재생

모바일 세션 재생 설정에 대한 자세한 내용은 모바일 세션 재생 설정 및 구성을 참조하세요.

SDK 초기화에는 변경이 필요하지 않습니다.

참고 자료

Additional helpful documentation, links, and articles: