버전 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 좌표는 동일하게 유지됩니다.

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

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

기존 DatadogCrashReporting 및 DatadogObjc에 추가로 제공됩니다.

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"),
          ]
      ),
  ]
)

pod 'DatadogCore'
pod 'DatadogLogs'
pod 'DatadogTrace'
pod 'DatadogSessionReplay'
pod 'DatadogRUM'
pod 'DatadogCrashReporting'
pod 'DatadogWebViewTracking'
pod 'DatadogObjc'

github "DataDog/dd-sdk-ios"

DatadogInternal.xcframework
DatadogCore.xcframework

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 설정을 모듈별로 구성합니다.

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

• 클라이언트 토큰, 환경 이름, 변수 이름 (기본값은 빈 문자열) 및 서비스 이름(기본값은 매니페스트에서 가져온 애플리케이션 ID)을 컨스트럭터에서 제공해야 합니다.
• com.datadog.android.core.configuration.Credentials 클래스가 제거되었습니다.
• 개별 제품 설정을 위해 logsEnabled, tracesEnabled 및 rumEnabled는 컨스트럭터에서 제거됩니다(아래 참조).
• 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 변경 사항:

트레이스

트레이스 제품과 관련된 모든 클래스는 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 변경 사항:

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 변경 사항:

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 변경 사항:

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.DatadogInterceptor 및 com.datadog.android.okhttp.trace.TracingInterceptor를 생성할 수 있습니다. OkHttp 계측은 Datadog SDK가 초기화되면 이벤트를 Datadog에 보고하기 시작합니다.

com.datadog.android.okhttp.DatadogInterceptor 및 com.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 및 트레이스 기능 모두에 대한 확장 메서드를 제공합니다.

세션 재생

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

서로 다른 제품을 독립 모듈로 추출하여 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 변경 사항:

로그

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

import DatadogLogs

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

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

import DatadogLogs

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

API 변경 사항:

트레이스

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

import DatadogTrace

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

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

import DatadogTrace

let tracer = Tracer.shared()

API 변경 사항:

RUM

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

import DatadogRUM

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

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

import DatadogRUM

let monitor = RUMMonitor.shared()

API 변경 사항:

충돌 보고

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

import DatadogCrashReporting

CrashReporting.enable()

WebView 추적

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

import WebKit
import DatadogWebViewTracking

let webView = WKWebView(...)
WebViewTracking.enable(webView: webView)

세션 재생

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

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