Application Real-Time Monitoring Service：Menyesuaikan pengaturan aplikasi

Prosedur

3. Di panel navigasi sebelah kiri, klik Application Settings. Pada halaman yang muncul, klik tab Custom Configuration.

4. Atur parameter sesuai kebutuhan dan klik Save di bagian bawah halaman.

Pengaturan laju pengambilan sampel

ARMS Pro Edition

Di bagian Sample rate setting, Anda dapat menentukan kebijakan pengambilan sampel dan antarmuka pengambilan sampel untuk jejak. Untuk informasi lebih lanjut, lihat Pilih Mode Pengambilan Sampel Jejak untuk Agen ARMS Versi Lebih Lama dari V3.2.8.

ARMS Basic Edition

ARMS Basic Edition mendukung kebijakan pengambilan sampel klien. Anda akan dikenakan biaya berdasarkan jumlah baris data yang dikumpulkan. Secara default, setiap agen ARMS mengumpulkan satu jejak per menit untuk setiap antarmuka di akun Anda secara gratis. Anda juga dapat mengklik Add Client Sampling Policy untuk menambahkan kebijakan pengambilan sampel kustom.

Setelah menetapkan kebijakan pengambilan sampel, Anda dapat menentukan apakah akan mengaktifkan kebijakan tersebut di konsol. Jika beberapa kebijakan pengambilan sampel diaktifkan, kebijakan tersebut berlaku dalam urutan berikut: pengambilan sampel default (gratis) > pembatasan aliran (antarmuka tertentu) > pengambilan sampel rasio tetap (antarmuka tertentu) > pembatasan aliran (semua antarmuka) > pengambilan sampel rasio tetap (semua antarmuka). Anda juga dapat memodifikasi pengaturan kebijakan pengambilan sampel atau menghapus kebijakan pengambilan sampel.

Sakelar agen dan tingkat log

Di bagian Agent Switch Settings, Anda dapat menghidupkan atau mematikan sakelar agen ARMS dan plugin terkait, serta mengonfigurasi tingkat log.

Pengaturan ambang batas

Di bagian Threshold Settings, Anda dapat mengonfigurasi ambang batas untuk kueri SQL lambat, waktu respons antarmuka, dan pembatasan.

Pengaturan antrian pesan

Di bagian Message Queue Configuration, Anda dapat mengonfigurasi pengaturan pemantauan terkait antrian pesan.

• Konsumen RabbitMQ Kustom: Anda dapat menentukan nama kelas untuk konsumen kustom atau nama kelas untuk konsumen internal anonim untuk melihat jejak konsumen. Pisahkan beberapa konsumen dengan koma (,).

• Metode Konsumsi Kafka Kustom: Anda dapat menentukan metode konsumsi kustom untuk melihat jejak dan data deret waktu saat Anda mengonsumsi pesan menggunakan SDK Kafka asli.

• Kafka Mengirim Pesan Otomatis Konteks Pass-through: Beberapa header secara otomatis ditambahkan dengan pesan Kafka untuk menghubungkan jejak pengiriman dengan jejak konsumsi.

Pengaturan koleksi agen

• Kumpulkan Rantai Panggilan: Kontrol apakah data jejak dilaporkan. Sakelar ini dihidupkan secara default. Jika dimatikan, data jejak tidak akan dilaporkan lagi.

• Ambang Batas Pembatasan: Tentukan jumlah maksimum permintaan yang dapat diproses agen per detik, dengan nilai default 100. Data jejak untuk permintaan yang melebihi ambang batas ini tidak akan dikumpulkan.

  Catatan

  Pengaturan pengambilan sampel jejak mengalahkan pengaturan pembatasan.

• Ambang Batas QPS Maksimum yang Dapat Ditangani Probe: Tentukan jumlah maksimum permintaan yang dapat diproses agen per detik. Perhatikan bahwa sistem dapat menyesuaikan ambang batas ini hingga 5% untuk tujuan optimasi kinerja. Permintaan yang melebihi ambang batas ini tidak akan dipantau. Untuk permintaan ini, tidak ada rentang yang dihasilkan, tidak ada data deret waktu yang dicatat, dan ID jejak tidak akan dicetak di log.

• Kumpulkan Data Panggilan Internal Tanpa Entri: Data panggilan internal tanpa titik entri umumnya merujuk pada data rentang dan data deret waktu yang dihasilkan oleh aktivitas seperti permintaan HTTP terjadwal, interaksi database, pengiriman pesan, atau panggilan RPC yang diinisiasi melalui thread pool JDK.

• Konfigurasi Tingkat Log: Sesuaikan tingkat log agen untuk tujuan pemecahan masalah.

Pengaturan panggilan antarmuka

• Ambang Batas Waktu Respons Antarmuka: Jika waktu respons permintaan melebihi ambang batas, permintaan tersebut ditandai sebagai lambat.

• Daftar Putih: Tentukan pengecualian yang ingin Anda kecualikan dari tab Ikhtisar dan Analisis Berbasis Skenario > Pengecualian.

• Penyaringan Pengecualian Warisan Kelas Induk: Saat diaktifkan, jika pengecualian yang dikumpulkan saat ini adalah subkelas dari kelas pengecualian yang dikonfigurasi dalam daftar putih penyaringan pengecualian, itu juga akan disaring.

  Efek konfigurasi: Pengecualian yang memenuhi kriteria penyaringan tidak akan ditampilkan di konsol ARMS.

• Filter Kode Kesalahan: Secara default, kode status HTTP lebih besar dari 400 diklasifikasikan sebagai panggilan kesalahan. Jika Anda tidak ingin kode status tertentu lebih besar dari 400 diklasifikasikan sebagai kesalahan, Anda dapat menetapkan daftar putih untuk mengabaikan kesalahan ini.

• Penyaringan Panggilan Antarmuka Tidak Valid: Masukkan nama antarmuka yang detail panggilannya tidak perlu Anda lihat, sehingga menyembunyikannya. Agen ARMS tidak akan melaporkan data observabilitas mereka.

• Apakah Nama Antarmuka Hulu Direkam dalam Indikator Panggilan Antarmuka dan Apakah Nama Aplikasi Hulu Direkam dalam Indikator Panggilan Antarmuka: Tentukan apakah akan merekam aplikasi hulu dan antarmuka hulu yang memanggil antarmuka ini dalam metrik antarmuka. Ini terutama memengaruhi apakah data ada pada jejak hulu dan hilir di layanan yang disediakan. Ketika aplikasi memiliki banyak aplikasi hulu, mencatat informasi ini dapat menyebabkan peningkatan signifikan dalam jumlah laporan metrik, sehingga meningkatkan biaya.

• Apakah Indikator Panggilan Antarmuka Mencatat Kode Status Asli: Tentukan apakah akan mencatat kode respons asli dalam metrik terkait antarmuka HTTP.

Pengaturan pemantauan kolam

• Pemantauan Kolam Thread dan Kolam Koneksi: Tentukan apakah akan memantau metrik kolam thread dalam kerangka kerja seperti Apache Tomcat, Apache Dubbo, dan High-speed Service Framework (HSF). Untuk mengaktifkan fitur ini, agen ARMS harus diperbarui ke versi terbaru.

• Kebijakan Ekstraksi Pola Nama Thread Kolam Thread: Fitur ini, secara default, mengganti semua karakter numerik dalam nama thread dari thread apa pun yang sedang berjalan dalam kolam thread dengan *. Anda juga dapat menyesuaikan ini untuk hanya mengganti karakter akhir nama thread dengan *. Di aplikasi di mana beberapa Penyedia Dubbo diinisiasi dan penyedia ini memiliki port mendengarkan yang berbeda, jika strategi default diterapkan, dua kolam thread dari dua Penyedia Dubbo dapat digabungkan menjadi satu karena template nama thread yang diekstraksi identik. Pada titik ini, menyesuaikan strategi ini dapat membantu membedakan antara dua kolam thread.

• Penyaringan Skenario Penggunaan Kolam Thread dan Penyaringan Pola Nama Thread Kolam Thread: Metrik kolam thread tertentu dapat dikecualikan berdasarkan skenario penggunaan dan pola nama thread mereka.

  Catatan

  Pengaturan ini hanya berlaku untuk agen ARMS untuk Java v4.2.0 dan yang lebih baru.

  • Skema penggunaan kolam thread merujuk pada konteks di mana thread digunakan, saat ini mendukung beberapa jenis termasuk Tomcat, Vert.x, Undertow, Dubbo, Jetty, AliyunJavaAgent, dan default. Di antaranya, AliyunJavaAgent mewakili kolam thread yang digunakan oleh agen, sementara "default" mewakili kolam thread lain yang tidak terklasifikasi.

  • Pola nama thread kolam thread menunjukkan pola yang diperoleh setelah memproses nama thread dalam kolam thread, seperti mentransformasikan bagian nama thread yang berisi angka menjadi * untuk mendapatkan pola seperti http-nio-*-exec-*.

Pengaturan atribut rentang

• Dokumentasikan Atribut Konvensi Spesifikasi OTel: Spesifikasi OpenTelemetry menetapkan atribut yang harus disertakan dalam rentang yang dihasilkan oleh setiap tipe plugin. Namun, mempertimbangkan jumlah data yang dilaporkan, agen ARMS tidak mencatat atribut ini dalam rentang secara default. Anda dapat mengaktifkan ini berdasarkan kebutuhan Anda. Untuk informasi tentang atribut tambahan yang ditambahkan oleh berbagai kerangka kerja setelah diaktifkan, lihat Dokumentasi Spesifikasi OpenTelemetry.

• Dokumentasikan Atribut Konvensi Spesifikasi OTel: Spesifikasi OpenTelemetry menetapkan atribut yang harus disertakan dalam rentang yang dihasilkan oleh setiap tipe plugin. Namun, mempertimbangkan jumlah data yang dilaporkan, agen ARMS tidak mencatat atribut ini dalam rentang secara default. Anda dapat mengaktifkan ini berdasarkan kebutuhan Anda. Untuk informasi tentang atribut tambahan yang ditambahkan oleh berbagai kerangka kerja setelah diaktifkan, lihat Dokumentasi Spesifikasi OpenTelemetry.

Pengaturan lanjutan

• Method stack maximum length: Tentukan panjang maksimum tumpukan metode. Nilai default: 128. Nilai maksimum: 400. Nilai ini menunjukkan jumlah entri.

• Stack depth to distinguish same exception: Tentukan kedalaman tumpukan yang digunakan untuk membedakan pengecualian dengan tipe yang sama. Secara umum, parameter ini diatur ke kedalaman panggilan perbedaan pertama.

• Collect the maximum length of SQL: Tentukan panjang maksimum pernyataan SQL. Nilai default: 1024. Nilai valid: 256 hingga 4096. Nilai ini menunjukkan jumlah karakter.

• Collect SQL Bindings: Tentukan apakah akan menangkap nilai variabel yang terikat pada parameter PrepareStatement. Modifikasi berlaku segera tanpa perlu me-restart aplikasi. Saat ini, parameter ini hanya dapat diatur ketika nilai variabel ditetapkan untuk parameter PrepareStatement.

• Raw SQL: Tentukan apakah akan melakukan operasi selain pemotongan pada pernyataan SQL.

• Whether to record the size of the MySql Query return value: Tentukan apakah ARMS diizinkan untuk mencatat ukuran nilai balasan query MySQL.

• Trace Storage: Tentukan apakah akan menggunakan format penyimpanan baru yang mengurutkan jejak berdasarkan waktu. Secara default, sakelar ini dihidupkan.

• Inner Callstack Reduce: Tentukan apakah akan menyederhanakan panggilan duplikat seperti loop for. Modifikasi berlaku segera tanpa perlu me-restart aplikasi.

• Max Length of Input Parameters: Tentukan panjang maksimum nilai parameter input. Nilai default: 512. Nilai maksimum: 2048. Nilai ini menunjukkan jumlah karakter.

• Quantile Statistics: Tentukan apakah akan mengaktifkan statistik kuantil.

  Catatan

  Kuantil adalah nilai yang membagi distribusi probabilitas variabel acak menjadi beberapa bagian yang sama. Kuantil umum termasuk median, kuartil, dan persentil.

• Automatic pass-through asynchronous: Saat tugas asinkron dikirimkan menggunakan kolam thread, konteks asinkron secara otomatis dilewatkan.

• Asynchronous transparent transmission scan package name: Anda dapat menambahkan paket pemindaian untuk transmisi asinkron ke konfigurasi aplikasi Anda untuk memantau tugas asinkron. Setelah objek Runnable, objek Callable, atau objek Supplier dibuat, metode yang sesuai dalam paket pemindaian untuk transmisi asinkron secara otomatis menangkap konteks jejak dari thread saat ini. Kemudian, ketika thread digunakan dalam mode asinkron, metode tersebut meneruskan konteks jejak yang ditangkap ke thread. Versi agen ARMS harus v2.7.1.3 atau lebih baru.

• TraceId is returned in the request: Tentukan apakah akan mengembalikan bidang eagleeye-traceid dalam header respons untuk permintaan HTTP.

Pengaturan thread

Di bagian Thread settings, Anda dapat menghidupkan atau mematikan Thread analysis master switch.

Asosiasi log aplikasi

Aturan konvergensi URL

Di bagian URL Aggregation, Anda dapat mengaktifkan atau menonaktifkan fitur konvergensi. Anda juga dapat menetapkan ambang batas konvergensi dan aturan konvergensi. Konvergensi URL berarti URL serupa ditampilkan bersama sebagai satu objek. Misalnya, URL dengan awalan /service/demo/ ditampilkan sebagai satu objek. Ambang batas konvergensi adalah jumlah minimum URL yang diperlukan untuk memicu konvergensi URL. Misalnya, jika ambang batas diatur ke 100, URL hanya dikonvergensi ketika 100 URL memenuhi ekspresi reguler aturan.

Konfigurasikan pemantauan Arthas

Di bagian Arthas monitoring, Anda dapat mengaktifkan atau menonaktifkan fitur diagnostik Arthas. Anda juga dapat menentukan alamat IP tempat Anda ingin melakukan diagnostik Arthas. Untuk informasi lebih lanjut, lihat Gunakan Diagnostik Arthas.

Profil berkelanjutan

Di bagian Continuous profiling, Anda dapat menghidupkan atau mematikan sakelar utama dan sakelar untuk hotspot CPU, hotspot memori, dan hotspot kode. Anda juga dapat menentukan alamat IP atau blok CIDR untuk profil berkelanjutan agar berlaku. Untuk informasi lebih lanjut, lihat Gunakan Fitur Profil Berkelanjutan.

Pengaturan protokol jejak

Di bagian Tracing Protocol Settings, Anda dapat memilih protokol jejak berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut tentang protokol jejak yang didukung oleh ARMS, lihat Protokol Propagasi Jejak yang Didukung.

Secara default, ketika panggilan tiba, agen ARMS memeriksa header protokol tertentu dalam urutan EagleEye, OpenTelemetry, SkyWalking, Jaeger, dan Zipkin. Jika header protokol terdeteksi, agen memulihkan konteks jejak berdasarkan protokol dan panggilan downstream berikutnya akan mencakup header protokol yang terdeteksi. Jika tidak ada header protokol yang terdeteksi, protokol EagleEye digunakan secara default.

Di bagian ini, Anda dapat menentukan protokol yang akan diprioritaskan. Setelah Anda menyimpan pengaturan, ARMS memeriksa header protokol yang ditentukan secara prioritas. Misalnya, dengan konfigurasi berikut, agen ARMS memeriksa header protokol dalam urutan Jaeger, EagleEye, OpenTelemetry, SkyWalking, dan Zipkin.

Anda juga dapat memilih untuk menggunakan satu protokol secara eksklusif. Misalnya, dengan konfigurasi berikut, ketika panggilan tiba, agen ARMS hanya memeriksa header Jaeger. Jika tidak ada header Jaeger yang ditemukan, agen tidak memeriksa header protokol lain tetapi menghasilkan konteks jejak baru.

Desensitisasi informasi

Di bagian Information desensitization, konfigurasikan aturan untuk mendesensitisasi parameter sistem JVM, konfigurasi YAML Kubernetes, parameter input metode, variabel lingkungan Arthas, dan variabel sistem selama pengumpulan data. Setiap elemen dalam aturan mewakili ekspresi reguler yang tidak peka huruf besar-kecil. Misalnya, password menunjukkan ekspresi reguler .*password.*. Pisahkan elemen dengan koma (,).

Ketika agen ARMS mengumpulkan data, agen mendesensitisasi data berdasarkan kunci. Jika kunci cocok dengan ekspresi reguler, nilai yang sesuai didesensitisasi. Seperti yang ditunjukkan pada gambar berikut, jika Anda menentukan licenseKey dalam aturan, nilai kunci -Darms.licenseKey didesensitisasi.

Sinkronkan pengaturan aplikasi ke aplikasi lain

Anda dapat menyinkronkan pengaturan aplikasi ke aplikasi lain.

Sinkronkan Item Konfigurasi Tunggal ke Aplikasi Lain

1. Di bagian item konfigurasi, klik Save and batch copy to other applications.

2. Di kotak dialog yang muncul, pilih aplikasi tertentu atau semua aplikasi lain dan klik Ok.

   

Sinkronkan Semua Item Konfigurasi ke Aplikasi Lain

1. Di bagian bawah halaman, klik Save and batch copy to other applications.

2. Di kotak dialog yang muncul, pilih aplikasi tertentu atau semua aplikasi lain dan klik Ok.

   

Terapkan pengaturan aplikasi secara global

Anda dapat menerapkan pengaturan aplikasi tertentu secara global. Jika Anda membuat aplikasi baru, pengaturan ini digunakan secara default.

1. Di bagian bawah halaman, klik Save the current application Settings to the global default Settings.

2. Di pesan yang muncul, klik Ok.