Layanan Pemantauan Aplikasi Waktu Nyata (ARMS) mendukung pemasukan jejak berbasis OpenTelemetry dari aplikasi Java. Anda dapat mengekspor jejak langsung dari aplikasi menggunakan SDK OpenTelemetry atau meneruskannya melalui OpenTelemetry Collector.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Instans ARMS yang diaktifkan
Aplikasi Java yang siap untuk diinstrumentasi
Titik akhir pemasukan jejak ARMS dan token otentikasi (token tersedia dari Konsol ACK)
Pilih metode integrasi
| Metode | Paling cocok untuk | Apa yang dilakukan |
|---|---|---|
| Agen ARMS + SDK OpenTelemetry | Mengotomatisasi instrumentasi komponen umum dengan rentang kustom untuk metode tertentu | Agen ARMS menangani komponen umum secara otomatis. Anda hanya perlu menambahkan rentang kustom dengan SDK OTel di tempat yang diperlukan. |
| SDK OpenTelemetry + eksporter Jaeger | Kontrol manual penuh atas instrumentasi | Anda menginstrumentasi setiap komponen secara eksplisit dan mengekspor jejak melalui eksporter Jaeger. Pendekatan ini sepenuhnya mengikuti standar OTel dan tidak memerlukan agen spesifik vendor. |
| OpenTelemetry Collector | Memusatkan pengumpulan jejak dari beberapa layanan | Anda men-deploy Collector sebagai pipeline pusat dan mengonfigurasi eksporter OTLP untuk meneruskan jejak ke ARMS. |
Ekspor jejak langsung dari aplikasi Anda
Gunakan agen ARMS dengan SDK OpenTelemetry untuk Java
Agen ARMS untuk Java (versi 2.7.1.3 dan lebih baru) mendukung ekstensi SDK OpenTelemetry. Agen ini secara otomatis menginstrumentasi komponen umum. Gunakan SDK OpenTelemetry untuk menambahkan rentang kustom pada metode yang tidak dicakup oleh agen.
Untuk langkah-langkah penyiapan, lihat Gunakan SDK OpenTelemetry untuk Java guna menginstrumentasi aplikasi secara manual.
Gunakan SDK OpenTelemetry dengan eksporter Jaeger
Instrumentasikan aplikasi Anda dengan SDK OpenTelemetry untuk Java dan ekspor data jejak melalui eksporter Jaeger. Pendekatan ini memberikan kontrol penuh atas komponen yang diinstrumentasi serta menggunakan API OpenTelemetry standar tanpa agen spesifik vendor.
Untuk langkah-langkah penyiapan, lihat Gunakan OpenTelemetry untuk mengirimkan data jejak aplikasi Java.
Teruskan jejak melalui OpenTelemetry Collector
Untuk mengarahkan jejak melalui OpenTelemetry Collector, konfigurasikan eksporter OTLP dalam file konfigurasi Collector Anda dengan titik akhir dan token otentikasi ARMS.
Konfigurasi eksporter Collector
Tambahkan konfigurasi berikut ke file konfigurasi Collector Anda (otel-collector-config.yaml):
exporters:
otlp:
endpoint: <endpoint>:8090
tls:
insecure: true
headers:
Authentication: <token>Parameter konfigurasi
Ganti placeholder dengan nilai Anda:
| Parameter | Deskripsi | Contoh |
|---|---|---|
<endpoint> | Titik akhir pemasukan jejak ARMS untuk wilayah Anda | http://tracing-analysis-dc-bj.aliyuncs.com:8090 |
<token> | Token otentikasi yang diperoleh di Konsol ACK | b590lhguqs@3a7*********9b_b590lhguqs@53d*****8301 |
Verifikasi dan gunakan data jejak di ARMS
Setelah aplikasi Anda mulai mengirimkan jejak, fitur-fitur berikut membantu Anda memantau dan men-debug aplikasi.
Detail jejak
Sisi kiri halaman detail jejak menampilkan urutan panggilan dan durasi setiap rentang. Sisi kanan menampilkan metrik terkait seperti kueri SQL, statistik JVM, dan metrik tingkat host.
Dasbor metrik pra-agregasi
ARMS secara otomatis menghasilkan dasbor dari data jejak, termasuk ikhtisar aplikasi, panggilan API, dan dasbor kueri database. Untuk informasi selengkapnya, lihat Ikhtisar aplikasi.
Trace Explorer
Filter dan agregasi jejak berdasarkan berbagai dimensi seperti aplikasi, alamat IP, atau API. Trace Explorer juga mendukung kueri jejak abnormal lintas layanan. Untuk informasi selengkapnya, lihat Trace Explorer.
Korelasi jejak-log
ARMS menghubungkan jejak dengan log layanan, sehingga Anda dapat langsung melompat dari rentang jejak ke entri log terkait saat melakukan troubleshooting exception. Untuk informasi selengkapnya, lihat Identifikasi exception bisnis dengan menganalisis jejak dan log.
