前提條件

已創建2.1.0及以上版本的全棧可觀測實例。具體操作，請參見創建全棧可觀測實例。

步驟一：SDK集成

在Android Studio工程的App或Module級別的build.gradle文件中添加如下配置。

// opentelemetry 協議庫
implementation(platform("io.opentelemetry:opentelemetry-bom:1.30.0"))
implementation("io.opentelemetry:opentelemetry-api")
implementation('io.opentelemetry:opentelemetry-sdk')
implementation("io.opentelemetry:opentelemetry-semconv:1.30.0-alpha")

// Android平臺崩潰捕獲
implementation 'io.github.aliyun-sls:aliyun-log-android-sdk:2.7.0@aar'
implementation 'io.github.aliyun-sls:android-crashreporter:1.0.0@aar'
implementation 'io.github.aliyun-sls:android-exporter-otlp:1.0.0@aar'
implementation 'io.github.aliyun-sls:android-otel-common:1.0.0@aar'

步驟二：權限配置

上報錯誤監控數據時需要申請網絡權限，即需要在AndroidManifest.xml文件中添加以下權限申明。

<uses-permission android:name="android.permission.INTERNET" />

步驟三：初始化SDK

private void initCrashReporter() {
    ConfigurationManager.getInstance().setProvider(
        scope -> AccessKey.accessKey(
            "${access-key-id}",
            "${access-key-secret}",
            "${access-key-token}"),
        scope -> Workspace.workspace("https://${endpoint}", "${project}", "${instanceId}"),
        scope -> {
            Environment environment = Environment.environment();
            // 設置環境信息，默認為default。一般情況下，建議debug版本設置為dev，release版本設置為pub。
            environment.setEnv("default");
            // 設置用戶ID，可選。
            //environment.setUid("123456789");
            // 設置設備ID，可選。
            //environment.setUtdid("your device id");
            return environment;
        }
    );
    // 一般情況下，建議debug版本設置為true，release版本設置為false。
    final boolean debuggable = false;
    // 完成SDK初始化。
    CrashReporter.init(context, debuggable);
}

變量說明