Instrumentasi aplikasi Java secara otomatis dengan OpenTelemetry Java agent dan kirimkan data telemetri ke Managed Service for OpenTelemetry.
Prasyarat
-
Buat Akun Alibaba CloudBuat Akun Alibaba Cloud.
-
Aktifkan Managed Service for OpenTelemetry
-
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, serta 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, dan atribut seperti ali.trace.component_type=98, ali.trace.flag=x-trace, serta thread.name=http-nio-8081-exec-1.
Panduan ini menggunakan OpenTelemetry Java agent dengan aplikasi Java sebagai contoh:
-
Unduh aplikasi demo: Unduh demo untuk mencoba Managed Service for OpenTelemetry atau instrumentasi aplikasi Anda sendiri.
-
Instrumentasi aplikasi Anda dengan OpenTelemetry Java agent: Unduh OpenTelemetry Java agent untuk instrumentasi otomatis non-intrusif pada ratusan framework Java. Modifikasi parameter startup JVM agar jejak dapat dikirimkan.
-
Lihat data pemantauan: Lihat data telemetri di atau di Konsol ARMS.
Langkah 1: Unduh aplikasi demo
Gunakan aplikasi demo yang disediakan atau aplikasi Java Anda sendiri.
Unduh kode demo: Demo OpenTelemetry Java Agent.
Paket demo berisi tiga subfolder:
-
java-agent-usage: Instrumentasi otomatis dengan OpenTelemetry Java agent (digunakan dalam panduan ini).
-
otel-sdk-usage: Instrumentasi manual menggunakan OpenTelemetry SDK untuk Java.
-
agent-sdk-usage: Instrumentasi menggunakan Java agent dan Java SDK secara bersamaan.
Langkah 2: Instrumentasi aplikasi
Agen OpenTelemetry Java menyediakan instrumentasi otomatis non-intrusif untuk ratusan framework Java yang tercantum dalam Supported Libraries and Versions.
-
Unduh OpenTelemetry Java Agent.
Di bagian Assets rilis terbaru, unduh file opentelemetry-javaagent.jar.
-
Modifikasi parameter VM dalam perintah startup Java Anda untuk mengirimkan jejak.
-javaagent:/{user.workspace}/opentelemetry-javaagent.jar // Ganti {user.workspace} dengan path aktual tempat Anda mengunduh file. -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.jarUntuk 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
-
Akses aplikasi demo di
localhost:8081/user/async. Agen mengumpulkan dan mengirimkan data telemetri ke Managed Service for OpenTelemetry. -
Login ke Konsol ARMS. Di panel navigasi kiri, pilih . Di halaman Applications, klik nama aplikasi tersebut, lalu lihat data jejak di halaman yang muncul.
CatatanJika ikon
ditampilkan di kolom Language, berarti aplikasi tersebut terhubung ke Application Monitoring. Jika tanda hubung (-) ditampilkan, berarti 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 mengidentifikasi faktor penyebab panggilan lambat.
Langkah selanjutnya
Setelah mengirimkan data ke Managed Service for OpenTelemetry, jelajahi fitur-fitur berikut di Konsol ARMS:
Managed Service for OpenTelemetry mendukung Java, Go, Python, JavaScript, .NET, C++, dan lainnya. Klien yang kompatibel mencakup OpenTelemetry, Jaeger, Zipkin, dan SkyWalking.
