Application Real-Time Monitoring Service:Panduan Cepat

Ikhtisar

Halaman detail jejak pada konsol lama menampilkan jejak lengkap dari permintaan HTTP 404. Garis waktu di sebelah kiri menunjukkan lima rentang hirarkis: GET /** (404, 11,1 ms), ResourceHttpRequestHandler.handleRequest (85 μs), ResponseFacade.sendError (19 μs), BasicErrorController.errorHtml (4,92 ms), dan Render error (4,34 ms). Bagian atas menampilkan TraceID, waktu mulai, durasi total, dan indikator kesalahan berwarna merah. Panel Detail Rentang di sebelah kanan menampilkan nama aplikasi java-agent-usage-0.0.1-SNAPSHOT, nama antarmuka BasicErrorController.errorHtml, spanId, parentSpanId, serta atribut seperti ali.trace.component_type=98, ali.trace.flag=x-trace, dan thread.name=http-nio-8081-exec-1.

Panduan ini menggunakan OpenTelemetry Java Agent dengan aplikasi Java sebagai contoh. Prosesnya terdiri dari tiga langkah:

1. Unduh aplikasi demo: Unduh demo untuk mencoba Managed Service for OpenTelemetry, atau instrumentasi aplikasi Anda sendiri.

2. Instrumentasi aplikasi Anda dengan OpenTelemetry Java Agent: Unduh OpenTelemetry Java Agent untuk instrumentasi otomatis non-intrusif di ratusan framework Java. Ubah parameter startup JVM untuk melaporkan jejak.

3. Lihat data pemantauan: Lihat data telemetri di atau Konsol ARMS.

Langkah 1: Unduh aplikasi demo

Gunakan aplikasi demo yang disediakan atau aplikasi Java Anda sendiri.

Unduh kode demo: Demo OpenTelemetry Java Agent.

Langkah 2: Instrumentasi aplikasi

Lakukan instrumentasi otomatis aplikasi Java dengan OpenTelemetry Java Agent. Agent ini mendukung ratusan framework Java yang tercantum dalam Supported Libraries and Versions.

1. Unduh OpenTelemetry Java Agent.

   Di bagian Assets rilis terbaru, unduh file opentelemetry-javaagent.jar.

2. Ubah parameter VM dalam perintah startup Java Anda untuk melaporkan jejak.

   -javaagent:/{user.workspace}/opentelemetry-javaagent.jar    // Ganti {user.workspace} dengan path aktual tempat Anda mengunduh file tersebut.
   -Dotel.resource.attributes=service.name=<appName>     // Ganti <appName> dengan nama aplikasi Anda.
   -Dotel.exporter.otlp.headers=Authentication=<token>    // Gunakan token dari informasi titik akhir yang diperoleh pada prasyarat.
   -Dotel.exporter.otlp.endpoint=<endpoint>  // Gunakan titik akhir dari informasi titik akhir yang diperoleh pada prasyarat.

   Sebagai contoh, jika perintah startup Anda adalah:

   java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

   Untuk terhubung ke Managed Service for OpenTelemetry, perbarui perintah menjadi:

   java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

Langkah 3: Lihat data pemantauan

1. Akses aplikasi demo di localhost:8081/user/async. Agent mengumpulkan dan mengirim data telemetri ke Managed Service for OpenTelemetry.

2. Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Application Monitoring > Applications. Di halaman Applications, klik nama aplikasi tersebut. Di halaman yang muncul, lihat data jejak.

   Catatan

   Jika ikon ditampilkan di kolom Language, aplikasi tersebut terhubung ke Application Monitoring. Jika tanda hubung (-) ditampilkan, aplikasi tersebut terhubung ke Managed Service for OpenTelemetry.

   Di halaman detail aplikasi, klik tab Trace Analysis untuk melihat grafik jumlah panggilan, kesalahan, dan latensi rata-rata. Daftar jejak menampilkan detail seperti TraceID, Nama Antarmuka, Nama Aplikasi, Latensi, Status, Waktu Mulai, dan Alamat Host. Gunakan Slow Trace Analysis dan Error Trace Analysis untuk membantu Anda mengidentifikasi faktor penyebab panggilan lambat.