Di tab Custom Configurations, Anda dapat menyesuaikan pengaturan umum seperti sakelar fitur agent dan kebijakan sampling.
Untuk mengonfigurasi pengaturan ini secara terprogram, gunakan API SaveTraceAppConfig.
Prasyarat
Agent ARMS telah diinstal pada aplikasi Anda.
Pemantauan Aplikasi menyediakan halaman detail aplikasi baru bagi pengguna yang telah mengaktifkan mode penagihan baru. Jika Anda belum mengaktifkan mode penagihan baru, klik Switch to New Version pada halaman Application List untuk mengakses halaman detail aplikasi baru.
Prosedur
-
Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih .
Di bilah navigasi atas, pilih .
Konfigurasikan parameter dan klik Save.
Pengaturan sampling
Di bagian Sampling Settings, Anda dapat mengonfigurasi kebijakan dan laju sampling untuk jejak, menentukan karakteristik antarmuka yang memerlukan full sampling, serta mengaktifkan atau menonaktifkan sampling lalu lintas rendah. Untuk informasi selengkapnya, lihat Pilih mode sampling jejak (untuk agent v3.2.8 dan versi lebih baru).
Pengaturan sakelar agen
Di bagian Agent Switch Settings, Anda dapat memulai atau menghentikan pemantauan aplikasi dan mengaktifkan/menonaktifkan sakelar plugin individual.
Perubahan untuk memulai atau menghentikan pemantauan aplikasi berlaku segera tanpa perlu restart aplikasi. Jika Anda menghentikan pemantauan aplikasi, sistem tidak dapat memantau aplikasi Anda. Lakukan dengan hati-hati. Untuk menerapkan perubahan pada sakelar plugin, Anda harus me-restart aplikasi.

Pengaturan analisis thread
Di bagian Thread Analysis Settings, Anda dapat mengaktifkan atau menonaktifkan sakelar utama untuk analisis thread.
Pengaturan asosiasi log aplikasi
Di bagian Application Log Association Settings, Anda dapat mengonfigurasi informasi sumber log untuk diasosiasikan dengan aplikasi Anda dan secara otomatis menyisipkan traceId serta spanId. Untuk informasi selengkapnya, lihat Analisis log.
Tujuan auto-filling traceId dan spanId: Saat diaktifkan, traceId dan spanId secara otomatis disisipkan ke dalam log Anda, sehingga tidak perlu melakukan perubahan manual pada file konfigurasi log Anda.
Effect:
Seperti ditunjukkan pada gambar berikut, log4j, log4j2, dan logback secara otomatis mencetak traceId dan spanId dalam log tanpa modifikasi apa pun pada file konfigurasi log.

Dukungan penambahan traceId dalam log MDC: Secara default, agent v4.x dan versi lebih baru tidak lagi mendukung pengambilan traceId menggunakan
org.slf4j.MDC.get(“EagleEye-TraceID”). Jika Anda masih perlu menggunakan metode ini, aktifkan sakelar ini.
Pengaturan konvergensi URL
Di bagian URL Convergence Settings, Anda dapat mengaktifkan atau menonaktifkan fitur konvergensi URL serta mengatur ambang batas dan aturan konvergensi. Konvergensi URL mengelompokkan serangkaian URL serupa dan menampilkannya sebagai satu item. Misalnya, serangkaian URL yang dimulai dengan /service/demo/ dikelompokkan untuk ditampilkan. Ambang batas konvergensi adalah jumlah minimum URL yang diperlukan untuk memicu konvergensi. Misalnya, jika ambang batasnya 100, URL yang sesuai dengan ekspresi reguler hanya akan dikonvergensikan ketika jumlahnya mencapai 100. Untuk informasi selengkapnya, lihat Mekanisme konvergensi ARMS.

Pemantauan Arthas
Di bagian Arthas Monitoring, Anda dapat mengaktifkan atau menonaktifkan fitur diagnostik Arthas dan mengatur alamat IP yang efektif. Untuk informasi selengkapnya, lihat Diagnostik Arthas.

Pengaturan profiling berkelanjutan
Di bagian Continuous Profiling Settings, Anda dapat mengaktifkan atau menonaktifkan sakelar utama, hotspot CPU, hotspot memori, dan fitur hotspot kode, serta menentukan alamat IP atau Blok CIDR yang efektif. Untuk informasi selengkapnya, lihat Profiling berkelanjutan untuk aplikasi Java.

Pengaturan desensitisasi informasi
Di bagian Information Desensitization Settings, Anda dapat mengonfigurasi aturan desensitisasi. Agent mendesensitisasi konten seperti parameter sistem JVM, file YAML Kubernetes, parameter input metode, serta variabel lingkungan dan sistem Arthas selama pengumpulan. Dalam aturan desensitisasi, elemen-elemen dipisahkan oleh koma (,), dan setiap elemen merepresentasikan ekspresi reguler yang tidak peka huruf besar/kecil. Misalnya, password setara dengan ekspresi reguler .*password.*.
Saat agent mengumpulkan data, ia memfilter kunci data terhadap ekspresi yang ditentukan. Jika suatu kunci cocok dengan ekspresi, agent menganggapnya sensitif dan mendesensitisasi nilainya. Pada gambar berikut, aturan desensitisasi diatur ke licenseKey, yang mendesensitisasi informasi untuk kunci -Darms.licenseKey.
Gambar berikut menunjukkan efek dari mengaktifkan desensitisasi alamat IP:
Pengaturan panggilan antarmuka
Di bagian Interface Call Settings, Anda dapat mengonfigurasi kebijakan seperti ambang batas panggilan lambat, daftar putih pengecualian, daftar putih kode status HTTP, dan penyaringan panggilan antarmuka yang tidak valid.

Ambang Batas Panggilan Lambat: Nilai default adalah 500 ms. Panggilan antarmuka ditandai sebagai panggilan lambat jika waktu responsnya melebihi ambang batas ini.
Daftar putih kode status HTTP:
Secara default, panggilan dengan kode status HTTP 400 atau lebih tinggi dianggap sebagai error. Jika Anda tidak ingin kode status tertentu diklasifikasikan sebagai error, Anda dapat menambahkannya ke daftar putih untuk mengabaikan error tersebut.
Pengaturan ini hanya berlaku untuk framework HTTP yang saat ini didukung oleh pemantauan aplikasi.
Data yang terpengaruh: Metrik jumlah error untuk server dan klien HTTP (arms_http_requests_error_count, arms_http_client_requests_error_count, arms_app_requests_error_count) dan status span.
Fitur yang terpengaruh: Jumlah error pada tab Overview, Provided Services, dan Dependencies, serta status span dan peringatan jumlah error pada halaman Trace Explorer.
Format: Masukkan satu kode status. Untuk memasukkan beberapa kode status, pisahkan dengan koma (,). Pencocokan wildcard tidak didukung.
Contoh:
403,502Nilai default: Tidak ada
Penyaringan panggilan antarmuka tidak valid:
Jika Anda tidak ingin melihat panggilan tertentu pada tab Provided Services, Anda dapat memasukkan nama antarmuka yang ingin dikecualikan. Agent tidak melaporkan data observabilitas untuk antarmuka tersebut, sehingga disembunyikan dari halaman.
CatatanUntuk versi agent Java sebelum 4.2.0, fitur ini hanya berlaku untuk antarmuka yang muncul di Provided Services.
Untuk agent Java v4.2.0 dan versi lebih baru, fitur ini berlaku untuk semua LocalRootSpan.
Data yang terpengaruh: Semua metrik dan span untuk antarmuka yang ditentukan diabaikan.
Fitur yang terpengaruh: Semua metrik untuk antarmuka yang ditentukan pada tab Overview, Provided Services, dan Dependencies, serta jumlah span, volume panggilan, jumlah error, dan peringatan panggilan lambat untuk antarmuka tersebut pada halaman Trace Explorer.
Format: Gunakan string atau ekspresi AntPath untuk mencocokkan nama lengkap antarmuka yang tidak valid. Pisahkan beberapa aturan dengan koma (,). Ekspresi AntPath default disediakan untuk kompatibilitas mundur. Kami menyarankan agar Anda tidak menghapusnya. Tambahkan konfigurasi baru ke aturan yang sudah ada.
Contoh:
/api/test/*,/api/playground/createNilai default:
/**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csvRecord upstream interface name for interface call metrics dan Record upstream application name for interface call metrics:
Tujuan: Pengaturan ini terutama memengaruhi ketersediaan data untuk jejak hulu dan hilir di Provided Services. Untuk aplikasi dengan banyak koneksi hulu, mengaktifkan ini dapat meningkatkan volume metrik yang dilaporkan dan biaya secara signifikan.
Effect: Seperti ditunjukkan pada gambar, setelah Anda menonaktifkan pencatatan aplikasi dan antarmuka hulu untuk metrik panggilan antarmuka, data terkait turun menjadi nol.

Record original status code for interface call metrics:
Tujuan: Mencatat kode respons asli dalam metrik yang terkait dengan antarmuka HTTP.
Effect:

Record HTTP Method Name for Interface: Jika Anda mengaktifkan sakelar ini, nama antarmuka yang diperluas pada halaman Provided Services mencakup nama metode permintaan HTTP. Misalnya, nama antarmuka berubah dari
/api/v1/use/{userId}menjadiGET /api/v1/use/{userId}.
Pengaturan panggilan database
Di bagian Database Call Settings, Anda dapat mengatur ambang batas untuk kueri SQL lambat, menentukan panjang maksimum untuk pernyataan SQL yang dikumpulkan, mengonfigurasi apakah akan menampilkan nilai binding variabel dan nilai konstan dalam pernyataan SQL, serta apakah akan mencatat ukuran nilai kembalian kueri MySQL.

Show variable binding values in SQL: Pengaturan ini mencatat nilai variabel yang di-binding ke parameter PreparedStatement. Pengaturan ini berlaku tanpa perlu restart aplikasi.
Agent menyimpan nilai-nilai ini dalam atribut db.bindvalue dari span akses database terkait sebagai daftar yang dipisahkan koma.
Pengaturan ini didukung oleh semua framework berbasis JDBC yang saat ini didukung oleh ARMS.
Jenis variabel database berikut didukung untuk pengaturan ini: Boolean, Byte, Short, Int, Long, Float, Double, BigDecimal, dan Date.
Mengaktifkan sakelar ini menimbulkan overhead tambahan yang sebanding dengan jumlah variabel dalam pernyataan SQL. Dalam skenario uji stres resmi (dengan satu variabel), mengaktifkan sakelar ini menghasilkan overhead CPU tambahan kurang dari 0,5%, dan overhead memori tambahan dapat diabaikan.
Gambar berikut menunjukkan efek dari mengaktifkan sakelar ini:

Show constant values in SQL: Pengaturan ini hanya memotong pernyataan SQL tanpa pemrosesan tambahan dan berlaku tanpa perlu restart aplikasi. Ketika pernyataan SQL berbeda mengandung nilai konstan berbeda, hal ini dapat menyebabkan pernyataan tersebut divergen dan di-agregasi di bawah
{ARMS_OTHERS}. Kami menyarankan agar Anda tidak mengaktifkan opsi ini.
Pengaturan protokol propagasi konteks jejak
Di bagian Trace Context Propagation Protocol Settings, Anda dapat memilih protokol propagasi konteks jejak yang ingin digunakan.

Secara default, agent ARMS memilih protokol propagasi konteks jejak berdasarkan apakah header permintaan berisi header protokol tertentu. Untuk informasi selengkapnya, lihat Kebijakan pemilihan protokol propagasi konteks jejak ARMS.
Anda dapat memilih protokol apa pun sebagai protokol utama. Setelah memilih dan menyimpan protokol, ARMS memprioritaskan pendeteksian header permintaan yang didefinisikan oleh protokol tersebut. Misalnya, dengan konfigurasi berikut, ketika panggilan tiba, agent ARMS memeriksa header konteks protokol dalam urutan Jaeger, EagleEye, W3C, SkyWalking, lalu Zipkin.

Anda juga dapat memilih untuk menerapkan penggunaan protokol tertentu secara paksa. Misalnya, dengan konfigurasi berikut, ketika panggilan tiba, agent ARMS hanya mendeteksi header permintaan yang didefinisikan oleh protokol Jaeger. Jika header tidak ditemukan, agent tidak memeriksa protokol lain tetapi menghasilkan konteks jejak baru.

Tujuan:
Fitur ini memungkinkan Anda memilih protokol propagasi konteks jejak yang diutamakan atau diterapkan secara paksa. Kasus penggunaan umum meliputi:
Permintaan membawa konteks jejak dalam beberapa format. Jika urutan parsing default tidak memenuhi kebutuhan Anda, Anda dapat menentukan protokol untuk diprioritaskan. Misalnya, jika permintaan membawa konteks jejak W3C dan Zipkin, konteks W3C diparse terlebih dahulu secara default. Anda dapat mengatur protokol propagasi ke Zipkin untuk memprioritaskannya.
Permintaan membawa header protokol jejak, tetapi Anda tidak ingin menggunakannya kembali dan lebih memilih menghasilkan konteks jejak baru menggunakan protokol berbeda. Misalnya, jika permintaan membawa konteks jejak Zipkin, konteks tersebut diparse secara default. Dengan mengatur protokol propagasi ke W3C dan mode propagasi ke enforced, konteks jejak Zipkin diabaikan, dan konteks baru dihasilkan sesuai spesifikasi W3C. Perhatikan bahwa jika Anda tidak mengatur mode ke enforced, agent tetap mencoba mem-parse konteks Zipkin setelah gagal mem-parse konteks W3C terlebih dahulu.
Effect:
Setelah dikonfigurasi, setiap LocalRootSpan dalam jejak memiliki atribut dengan kunci trace.protocol.type dan nilai yang menunjukkan protokol jejak yang digunakan.

Pengaturan antrian pesan
Di bagian Message Queue Settings, Anda dapat menyesuaikan informasi konsumen.

Custom RabbitMQ consumer: Dengan mengatur nama kelas konsumen kustom atau kelas yang berisi konsumen inner anonim, Anda dapat melihat jejak konsumen tersebut. Pisahkan beberapa nama kelas konsumen dengan koma (,).
Custom Kafka consumption method: Dengan mendefinisikan metode konsumsi kustom, Anda dapat melihat data jejak dan metrik saat mengonsumsi pesan melalui SDK Kafka native.
Automatically propagate context for Kafka messages: Saat mengirim pesan, beberapa header secara otomatis ditambahkan ke pesan Kafka untuk menghubungkan jejak pengiriman dan konsumsi.
Pengaturan Pengumpulan Agent
Di bagian Agent Collection Settings, Anda dapat mengatur jumlah maksimum span yang dikumpulkan per detik, ambang batas QPS maksimum, dan tingkat log untuk agent.
Collect traces: Mengontrol apakah data jejak dilaporkan. Sakelar ini diaktifkan secara default. Jika dinonaktifkan, data jejak tidak lagi dilaporkan.
Maximum spans collected per second by agent: Jumlah span yang dapat dilaporkan agent per detik. Untuk alasan performa, ambang batas efektif aktual dapat menyimpang hingga 5% dari ambang batas yang dikonfigurasi. Span yang melebihi batas ini tidak dilaporkan.
Maximum QPS threshold for agent: Jumlah permintaan yang dapat diproses agent per detik. Untuk alasan performa, ambang batas efektif aktual dapat menyimpang hingga 5% dari ambang batas yang dikonfigurasi. Permintaan yang melebihi ambang batas ini tidak dipantau. Tidak ada span atau metrik yang dihasilkan untuknya, dan fitur asosiasi log dengan traceId tidak berfungsi.
Collect internal call data without an entry point: Di ARMS, layanan HTTP, layanan RPC, tugas terjadwal, dan konsumsi pesan dianggap sebagai titik masuk. Panggilan dalam logika bisnis titik masuk ini, seperti panggilan database dan permintaan HTTP keluar, dianggap sebagai panggilan internal dengan titik masuk. Sebaliknya, panggilan yang diprakarsai oleh kolam thread JDK, seperti panggilan HTTP terjadwal, panggilan database, panggilan NoSQL, pengiriman pesan, dan panggilan RPC, dianggap sebagai panggilan internal tanpa titik masuk. Mulai dari v4.2.2, Anda dapat menyaring data jenis ini dengan satu klik. Misalnya, framework Lettuce secara berkala mengeksekusi perintah untuk menjaga koneksi sehat dengan server Redis. Ini adalah panggilan internal tanpa titik masuk. Gambar berikut menunjukkan bahwa setelah pengaturan ini dinonaktifkan, data terkait tidak lagi dikumpulkan.

Agent log level: Menyesuaikan tingkat verbosity logging agent untuk tujuan troubleshooting.
Report agent logs: Memungkinkan agent melaporkan log operasionalnya ke server ARMS untuk troubleshooting cepat. Dalam kondisi normal, hanya volume log kecil yang dilaporkan per menit.
Default metric collection filter: Menyaring pelaporan jenis metrik tertentu. Jenis berikut didukung dan dapat dipilih lebih dari satu:
custom_entry: metrik kustom untuk pemantauan metode
http: metrik untuk server HTTP
http_client: metrik untuk klien HTTP
rpc: metrik untuk server RPC
rpc_client: metrik untuk klien RPC
sql: metrik terkait akses database
nosql: metrik terkait akses layanan NoSQL
cache: metrik terkait akses layanan cache
producer: metrik terkait pengiriman pesan
consumer: metrik terkait konsumsi pesan
schedule: metrik terkait layanan penjadwalan
Custom metric collection configuration: Mengonfigurasi koleksi metrik yang didefinisikan oleh OpenTelemetry SDK. Untuk informasi selengkapnya, lihat Menyesuaikan metrik menggunakan OpenTelemetry Java SDK.
Baggage to collect: Jika aplikasi Anda menggunakan baggage, pengaturan ini memungkinkan Anda menulis item baggage tertentu ke atribut span, sehingga memudahkan pencarian jejak tertentu.
Pengaturan penyaringan pengecualian lanjutan
Di bagian Advanced Exception Filtering Settings, Anda dapat mengonfigurasi aturan koleksi pengecualian.

Collect plugin exceptions: Menentukan apakah akan mengumpulkan pengecualian plugin.
Similar exception stack differentiation depth: Nilai default adalah 2. Agent menggunakan kedalaman stack ini untuk mengidentifikasi jenis pengecualian serupa. Mengubah pengaturan ini dapat menyebabkan perilaku statistik yang tidak diinginkan. Lakukan dengan hati-hati.
Exception filtering whitelist:
Jika Anda tidak ingin melihat pengecualian tertentu pada tab Exception Analysis, Anda dapat memasukkan nama kelas lengkapnya untuk mengecualikannya. Pengecualian ini tidak akan dihitung sebagai error dan disembunyikan dari halaman.
Data yang terpengaruh: Metrik jumlah pengecualian (arms_exception_requests_count_raw, arms_exception_requests_seconds_raw) dan informasi pengecualian dalam span.
Fitur yang terpengaruh: Metrik untuk anomali terkait pada tab Anomaly Analysis.
Format: Gunakan nama kelas lengkap untuk mengidentifikasi pengecualian yang akan disaring. Pisahkan beberapa nama pengecualian dengan koma (,).
Contoh:
java.lang.InterruptedException,java.lang.IndexOutOfBoundsExceptionNilai default: Tidak ada
Filter exceptions by parent class: Jika Anda mengaktifkan sakelar ini, pengecualian apa pun yang merupakan subkelas dari kelas pengecualian dalam Exception filtering whitelist juga disaring.
Effect: Pengecualian yang memenuhi kriteria filter tidak muncul di Konsol ARMS.
Exception message filtering: Setelah Anda mengonfigurasi ini, pengecualian jenis tertentu juga disaring jika bidang pesannya sesuai dengan kondisi yang dikonfigurasi.
Exception name: Menentukan pengecualian yang diterapkan filter.
Message condition: Kondisi untuk pesan pengecualian. Dapat berupa startsWith, endsWith, atau contains.
Message keyword: String kata kunci.
Effect: Pengecualian yang memenuhi kriteria filter tidak muncul di Konsol ARMS.
Pengaturan pemantauan pool
Di bagian Pool Monitoring Settings, Anda dapat mengonfigurasi aturan koleksi untuk kolam thread dan kolam koneksi.

Thread pool and connection pool monitoring: Mendukung pemantauan metrik kolam thread untuk framework seperti Tomcat, Dubbo, dan HSF. Anda harus meningkatkan agent ke versi terbaru.
Thread pool thread name pattern extraction policy: Secara default, fitur ini mengganti semua karakter numerik dalam nama thread dari thread yang sedang berjalan di pool dengan tanda bintang (
*). Anda juga dapat mengonfigurasinya untuk hanya mengganti karakter numerik di akhir nama thread dengan tanda bintang (*). Ini berguna ketika beberapa penyedia Dubbo dengan port pendengar berbeda berjalan dalam aplikasi Anda. Dengan kebijakan default, kolam thread mereka mungkin di-agregasi karena pola nama thread yang diekstraksi identik. Menyesuaikan kebijakan ini membantu membedakannya.Effect: Untuk kolam thread Tomcat khas, nama thread yang ditampilkan adalah
http-nio-*-exec-*secara default. Setelah penyesuaian, bisa menjadihttp-nio-9099-exec-*.
Thread pool usage scenario filter dan Thread pool thread name pattern filter: Menyaring metrik pemantauan untuk kolam thread tertentu berdasarkan skenario penggunaan dan pola nama thread-nya.
CatatanKonfigurasi ini hanya berlaku untuk agent Java v4.2.0 dan versi lebih baru.
Thread pool usage scenario: Konteks penggunaan thread. Skenario yang saat ini didukung meliputi Tomcat, Vert.x, Undertow, Dubbo, Jetty, AliyunJavaAgent, dan default. AliyunJavaAgent merepresentasikan kolam thread yang digunakan oleh agent, dan default merepresentasikan kolam thread lain yang tidak terklasifikasi.
Thread pool thread name pattern: Pola yang diperoleh dari pemrosesan nama thread dalam kolam thread. Misalnya, http-nio-*-exec-* adalah pola yang biasanya diperoleh dengan mengganti bagian numerik nama thread aktual dengan tanda bintang (*).
Data yang terpengaruh: Metrik kolam thread
Fitur yang terpengaruh: Tab Thread Pool Monitoring dan peringatan yang dikonfigurasi berdasarkan metrik pemantauan kolam thread.
Format:
Thread pool usage scenario filter: Skenario penggunaan yang ditampilkan pada tab pemantauan kolam thread. Pisahkan beberapa skenario dengan koma (,).
Thread pool thread name pattern filter: Pola nama thread yang ditampilkan pada tab pemantauan kolam thread. Pisahkan beberapa pola dengan koma (,). Ini menggunakan pencocokan eksak dan tidak mendukung ekspresi reguler.
Contoh:
Thread pool usage scenario filter:
AliyunJavaAgent,JettyThread pool thread name pattern filter:
Catalina-utility-*,DubboServerHandler-*-thread-*
Artinya, data dari semua kolam thread dalam skenario AliyunJavaAgent tidak dilaporkan. Dalam skenario lain, data dari kolam thread yang namanya cocok dengan pola
Catalina-utility-*juga tidak dilaporkan.Nilai default: Tidak ada
Pengaturan atribut span

Record OpenTelemetry Specification attributes: Spesifikasi OpenTelemetry mendefinisikan atribut yang harus disertakan dalam span yang dihasilkan oleh setiap jenis plugin. Untuk mengelola volume data, agent ARMS secara default tidak mencatat semua atribut tersebut. Anda dapat mengaktifkan pengaturan ini sesuai kebutuhan. Untuk informasi tentang atribut tambahan yang akan ditambahkan untuk setiap framework setelah Anda mengaktifkan pengaturan ini, lihat Spesifikasi OpenTelemetry.
Contoh berikut menunjukkan span untuk server HTTP. Atribut dalam kotak merah adalah atribut yang ditambahkan setelah sakelar ini diaktifkan.

Application tag association for spans: Mengontrol span mana yang diberi label aplikasi yang telah Anda konfigurasi pada halaman Applications. Secara default, semua span menyertakan label aplikasi. Untuk mengurangi volume data, Anda dapat memilih untuk melampirkan label aplikasi hanya pada span entri. Span entri biasanya mencakup HTTP Server, RPC Server, konsumsi pesan MQ, dan tugas terjadwal.
Gambar berikut menunjukkan efek melampirkan label hanya pada span entri. Misalnya, aplikasi memiliki label aplikasi
test1:value1.
Untuk span entri, Anda dapat melihat label terkait dalam atribut.

Span non-entri tidak menyertakan atribut
test1:value1.
Pengaturan lanjutan
Di bagian Advanced Settings, Anda dapat mengonfigurasi pengaturan seperti antarmuka yang difilter dan panjang maksimum stack metode.
Quantile statistics: Menentukan apakah akan mengaktifkan fitur statistik kuantil.
Maximum method stack length: Nilai default adalah 128, dan nilai maksimum adalah 400.
Trace compression: Menentukan apakah akan menyederhanakan panggilan berulang, seperti yang ada dalam loop for.
Maximum display length for request parameters: Panjang default adalah 512 karakter, dan panjang maksimum yang didukung adalah 2.048 karakter.
Asynchronous context propagation scan packages: Tambahkan paket pemindaian untuk propagasi asinkron guna memantau tugas asinkron. Saat objek baru dari antarmuka Runnable, Callable, dan Supplier dibuat dalam paket ini, mereka secara otomatis menangkap konteks jejak dari thread saat ini. Konteks ini kemudian digunakan saat thread asinkron dieksekusi, sehingga melengkapi keterkaitan jejak.
Include traceId in HTTP response: Hanya untuk permintaan HTTP, ini mengembalikan bidang
eagleeye-traceiddalam header respons.Root cause of JVM GC triggers: Saat diaktifkan, Anda dapat melihat akar penyebab pemicu garbage collection (GC) JVM. Anda dapat melihat detail pemantauan pada halaman JVM Monitoring. Untuk deskripsi penyebab pemicu GC, lihat Metrik terkait GC.
Salin pengaturan ke aplikasi lain
Jika Anda perlu menerapkan pengaturan yang sama ke aplikasi lain, Anda dapat menyalin konfigurasi saat ini ke aplikasi tersebut.
Salin grup pengaturan ke aplikasi lain
Di bagian pengaturan, klik Save and Bulk Copy to Other Applications.
Jika muncul kotak dialog Current settings not saved, klik OK untuk menyimpan konfigurasi untuk aplikasi saat ini, lalu klik Save and Bulk Copy to Other Applications lagi.
Di kotak dialog yang muncul, pilih aplikasi yang akan diterapkan pengaturannya, lalu klik OK.
Salin semua pengaturan ke aplikasi lain
Di bagian bawah halaman, klik Save and Bulk Copy to Other Applications.
Jika muncul kotak dialog Current settings not saved, klik OK untuk menyimpan konfigurasi untuk aplikasi saat ini, lalu klik Save and Bulk Copy to Other Applications lagi.
Di kotak dialog yang muncul, pilih aplikasi yang akan diterapkan pengaturannya, lalu klik OK.
Pengaturan default global
Anda dapat menyimpan pengaturan saat ini sebagai default global. Saat Anda membuat aplikasi baru, pengaturan ini digunakan secara default.
Di bagian bawah halaman, klik Save Current App Settings as Global Default.
Jika muncul kotak dialog Current settings not saved, klik OK untuk menyimpan pengaturan untuk aplikasi saat ini, lalu klik Save Current App Settings as Global Default lagi.
Di kotak dialog yang muncul, klik OK.
FAQ
Pengaturan sakelar aplikasi tidak berfungsi
Periksa apakah pengaturan yang ingin Anda ubah memiliki persyaratan versi, misalnya, apakah sakelar diaktifkan atau dinonaktifkan secara default mulai dari versi agent tertentu.
Jika iya, periksa apakah versi agent Anda saat ini memenuhi persyaratan tersebut. Jika tidak, klik Save untuk menerapkan perubahan. Jika iya, periksa log agent untuk mencari log listener konfigurasi terkait.
Jika tidak memiliki persyaratan versi, periksa log agent untuk memastikan apakah ada log listener konfigurasi terkait.
Untuk agent v3.x, cari kata kunci
[Diamond] receive. Jika muncul konten seperti pada gambar berikut, konfigurasi berhasil didorong.
Untuk agent v4.x, cari kata kunci
config update. Jika entri log seperti pada gambar berikut muncul, konfigurasi berhasil didorong.
Laju sampling tidak berlaku
Laju sampling aplikasi hanya memengaruhi apakah jejak yang berasal dari aplikasi itu sendiri di-sampling. Jika permintaan masuk sudah membawa konteks jejak, aplikasi memulihkan konteks tersebut dan memutuskan apakah akan melakukan sampling berdasarkan keputusan sampling dalam konteks tersebut.
Ekspresi lambda tidak didukung dalam propagasi asinkron
Kami menyarankan untuk meningkatkan ke agent v4.x, yang mendukung propagasi konteks asinkron otomatis dan tidak memerlukan perubahan kode atau konfigurasi tambahan.
Default global tidak diterapkan ke aplikasi baru
Saat Anda menyimpan pengaturan aplikasi sebagai default global, Anda hanya menyimpan snapshot pengaturan saat ini dari aplikasi tersebut. Perubahan selanjutnya pada pengaturan aplikasi tidak secara otomatis disinkronkan ke default global. Anda harus mengklik tombol simpan lagi untuk memperbarui pengaturan default global.
Konfigurasi antarmuka /error tidak berfungsi
Untuk versi agent sebelum 3.2.0, penyaringan antarmuka dilakukan saat panggilan pertama kali memasuki aplikasi. Namun, antarmuka jenis /error biasanya dialihkan ke halaman error saat terjadi kesalahan di kemudian hari dalam panggilan, sehingga penyaringan awal sudah terjadi. Hal ini mencegah filter berlaku. Masalah ini telah diperbaiki di agent v3.2.0 dan versi lebih baru.
Sakelar konvergensi URL tidak berfungsi
Bagian URL Convergence Settings pada halaman Custom Configurations hanya berlaku untuk agent v3.x. Untuk agent v4.x, konfigurasikan pengaturan ini pada halaman .
Untuk versi agent sebelum 3.x, jika aplikasi menggunakan Spring MVC, masalah ini dapat terjadi. Harap tingkatkan agent ke v3.x atau versi lebih baru.