All Products
Search
Document Center

Application Real-Time Monitoring Service:Mulai Cepat

Last Updated:Aug 29, 2026

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

  • Dapatkan titik akhir

    1. Masuk ke Konsol ARMS. Di panel navigasi kiri, klik Integration Center.

    2. Di halaman Integration Center, klik kartu OpenTelemetry pada bagian Server-side Applications.

    3. Di panel OpenTelemetry, klik tab Start Integration, lalu pilih wilayah tempat Anda ingin mengirimkan data.

      Catatan

      Saat Anda mengakses wilayah tersebut untuk pertama kalinya, resource akan diinisialisasi secara otomatis.

    4. Konfigurasikan parameter Connection Type dan Export Protocol, lalu salin titik akhirnya.

      • Connection Type: Jika layanan Anda dideploy di Alibaba Cloud dan berada di wilayah yang Anda pilih, kami menyarankan mengatur parameter ini ke Alibaba Cloud VPC Network. Jika tidak, atur ke Public Network.

      • Export Protocol: Atur parameter ini ke HTTP (disarankan) atau gRPC sesuai protokol yang didukung oleh client.

      3-新版-中文-otgrpc.jpg

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:

  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 pada ratusan framework Java. Modifikasi parameter startup JVM agar jejak dapat dikirimkan.

  3. 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.

Catatan

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.

  1. Unduh OpenTelemetry Java Agent.

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

  2. 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.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. Agen mengumpulkan dan mengirimkan data telemetri ke Managed Service for OpenTelemetry.

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

    Catatan

    Jika ikon image 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.