Topik ini menjelaskan cara mengumpulkan data pemantauan pengalaman pengguna dari perangkat Android ke aplikasi Full-stack Observability.
Prasyarat
Sebuah instance Full-stack Observability telah dibuat, dengan versi 2.1.0 atau lebih baru. Untuk informasi lebih lanjut, lihat Buat Sebuah Instance.
Langkah 1: Integrasikan SDK
Tambahkan pengaturan berikut ke file build.gradle di tingkat aplikasi atau modul proyek Android Studio Anda:
// Tentukan pustaka protokol 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")
// Tangkap crash pada platform 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'Langkah 2: Konfigurasikan izin
Untuk mengunggah data pemantauan kesalahan, Anda harus meminta izin jaringan. Tambahkan deklarasi izin berikut ke file AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />Langkah 3: Inisialisasi 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();
// Configure the environment information. The default value is default. In most cases, we recommend you set this parameter to dev if you use the debug version and to pub if you use the release version.
environment.setEnv("default");
// The user ID. This parameter is optional.
//environment.setUid("123456789");
// The device ID. This parameter is optional.
//environment.setUtdid("your device id");
return environment;
}
);
// In most cases, we recommend that you set this parameter to true if you use the debug version and to false if you use the release version.
final boolean debuggable = false;
// Complete SDK initialization.
CrashReporter.init(context, debuggable);
}Variabel
Variabel | Deskripsi | Contoh |
| Titik akhir proyek Layanan Log Sederhana. Tentukan titik akhir dalam format | cn-hangzhou.log.aliyuncs.com |
| Nama proyek Layanan Log Sederhana. | test-project |
| ID instance Full-stack Observability. Untuk informasi lebih lanjut, lihat Buat sebuah instance. | test-traces |
| ID AccessKey akun Alibaba Cloud Anda. Kami sarankan Anda menggunakan pasangan AccessKey dari Pengguna Resource Access Management (RAM) yang hanya memiliki izin tulis pada proyek Layanan Log Sederhana. Pasangan AccessKey terdiri dari ID AccessKey dan Rahasia AccessKey. Untuk informasi lebih lanjut tentang cara memberikan izin tulis pada proyek tertentu kepada pengguna RAM, lihat Gunakan kebijakan kustom untuk memberikan izin kepada pengguna RAM. Untuk informasi lebih lanjut tentang cara mendapatkan pasangan AccessKey, lihat Pasangan AccessKey. | Tidak ada |
| Rahasia AccessKey akun Alibaba Cloud Anda. Kami sarankan Anda menggunakan pasangan AccessKey dari pengguna RAM yang hanya memiliki izin tulis pada proyek Layanan Log Sederhana. | Tidak ada |