ARMS agent V4.x sepenuhnya kompatibel dengan OpenTelemetry sumber terbuka dan dibangun di atas fondasi OpenTelemetry Java agent. Semua fitur dari Java agent asli dipertahankan, dengan beberapa perubahan kecil pada beberapa fitur. Topik ini menjelaskan perubahan-perubahan tersebut dan dampaknya terhadap ARMS agent V4.x, serta peningkatan volume data pemantauan.
Perubahan dan dampak
Secara default, instrumentasi metode untuk Spring-managed Beans dinonaktifkan, dan hanya metode dalam Controllers yang diinstrumen.
Dampak:
Setelah pembaruan, metode kelas yang dianotasi dengan anotasi @Service dan @Component tidak dapat ditampilkan dalam tumpukan metode jejak.
Pengecualian yang dilemparkan dalam metode kelas yang dianotasi dengan anotasi @Service dan @Component tidak dapat dipantau.
Nama metrik terkait pemantauan thread pool dan connection pool telah diubah. Untuk informasi lebih lanjut, lihat Pemantauan thread pool dan connection pool.
Dampak:
Jika Anda telah mengonfigurasi aturan peringatan untuk pemantauan thread pool di Pemantauan Aplikasi, Anda harus mengonfigurasi ulang aturan peringatan setelah ARMS agent diperbarui.
Di halaman Create Application Monitoring Alert Rule, atur Metric Type ke Thread_Pool_Version_2 dan buat aturan peringatan baru.
Jika dasbor kustom dikonfigurasikan berdasarkan metrik thread pool, data dasbor kosong setelah ARMS agent diperbarui.
Peningkatan volume metrik menyebabkan peningkatan biaya bayar sesuai pemakaian.
Nama metrik untuk memantau penundaan pesan diubah menjadi arms_mq_delay_seconds.
Dampak: Jika dasbor kustom dikonfigurasikan berdasarkan metrik tersebut, data dasbor kosong setelah ARMS agent diperbarui.
Penyebaran otomatis konteks jejak dalam panggilan asinkron tidak memerlukan konfigurasi nama paket.
Konsumen kustom tidak perlu dikonfigurasi secara manual untuk RabbitMQ, begitu juga metode konsumsi kustom untuk Kafka.
ID jejak tidak lagi dapat diperoleh menggunakan metode
MDC.get("EagleEye-TraceID"), sedangkan asosiasi ID jejak dengan log tidak terpengaruh.Dampak: ID jejak yang diperoleh menggunakan metode
MDC.get("EagleEye-TraceID")kosong.Rentang dibuat untuk panggilan internal dalam skenario tanpa panggilan masuk.
Dampak: Lebih banyak rentang menyebabkan peningkatan biaya bayar sesuai pemakaian.
Statistik kuantil diubah dari algoritma Summary Prometheus menjadi metode distribusi bucket berdasarkan interpolasi linear.
Dampak: Data metrik kuantil tidak akurat ketika ada perbedaan besar antara distribusi durasi aktual dan bucketing.
Status rentang konsisten dengan OpenTelemetry sumber terbuka. Permintaan HTTP dengan kode status 4xx dan 5xx masuk ke status kesalahan. Permintaan HTTP dengan kode status lain masuk ke status unset, sedangkan ARMS agent sebelum V4.x menganggap permintaan ini berada dalam status ok.
Setelah ARMS agent diperbarui ke V4.x, ID jejak harus terdiri dari 32 karakter, sehingga tidak kompatibel dengan fitur Browser Monitoring lama. Kami menyarankan Anda mengintegrasikan fitur Real User Monitoring baru.
ARMS agent V4.1.12 atau lebih lama tidak kompatibel dengan thread virtual yang diperkenalkan di JDK 21. Kompatibilitas penuh akan dicapai di ARMS agent V4.3.x. Jika bisnis Anda bergantung pada thread virtual, gunakan ARMS agent V3.x sebagai gantinya.
Jika Anda menggunakan arms-sdk untuk menambahkan baggage di spring-cloud-gateway dengan filter, ketika agent diperbarui ke V4.2.x dan spring-bean-plugin diaktifkan di tab Custom Configurations halaman detail aplikasi, fitur baggage pass-through tidak berfungsi.
Peningkatan data pemantauan
Setelah ARMS agent diperbarui dari V3.x ke V4.x, data metrik mungkin meningkat dalam kasus-kasus berikut:
Data rentang dan metrik meningkat karena panggilan internal menghasilkan rentang dalam skenario tanpa panggilan masuk.
Data metrik thread pool meningkat karena thread pool dapat ditentukan oleh pengguna.
Data metrik connection pool meningkat karena lebih banyak jenis connection pool didukung.
Data metrik upstream dan downstream antarmuka meningkat ketika panggilan upstream dan downstream bersifat asinkron, karena ARMS agent V4.x mendukung penyebaran otomatis.
Data metrik meningkat karena dukungan untuk berbagai plugin, seperti Lettuce, diperluas.
Di ARMS agent V4.x, metode pengumpulan dan penyimpanan data disesuaikan untuk mengumpulkan metrik tambahan dengan awalan
arms_grouped_threadketika fitur thread profiling diaktifkan. Pengaturan ini meningkatkan kinerja ketika ada banyak thread, tetapi menghasilkan data berlebihan. Untuk menonaktifkan fitur ini, lihat Thread profiling.Konsumsi batch Message Queue (MQ) sekarang membuat rentang individual per pesan (sebelumnya per batch), meningkatkan volume rentang dalam skenario throughput tinggi. Untuk mengelola beban pelaporan, sesuaikan laju pengambilan sampel atau nonaktifkan plugin MQ.