Application Real-Time Monitoring Service：Sesuaikan pengaturan untuk aplikasi Java

Prasyarat

Agen ARMS telah diinstal untuk aplikasi tersebut.

Akses fitur

1. Masuk ke ARMS console. Di panel navigasi sebelah kiri, pilih Application Monitoring > Application List.

3. Di bilah navigasi atas, pilih Configuration > Custom Configurations.

4. Atur parameter konfigurasi kustom dan klik Save.

Pengaturan sampling

Pada bagian Sampling Settings, Anda dapat mengonfigurasi kebijakan sampling, laju sampel, dan fitur untuk full sampling antarmuka. Anda juga dapat mengaktifkan atau menonaktifkan low-traffic sampling. Untuk informasi selengkapnya, lihat Select a trace sampling mode for an agent of V3.2.8 or later.

Pengaturan switch agen

Pada bagian Agent switch settings, Anda dapat mengaktifkan atau menonaktifkan pemantauan aplikasi serta memilih plug-in yang ingin digunakan.

Pengaturan profil thread

Pada bagian Thread Profiling Settings, Anda dapat mengaktifkan atau menonaktifkan switch utama untuk profil thread.

Pengaturan asosiasi log aplikasi

Pada bagian Application Log Association Settings, Anda dapat mengonfigurasi sumber log untuk diasosiasikan dengan aplikasi dan menentukan apakah TraceId dan SpanId akan diinjeksikan secara otomatis ke dalam log. Untuk informasi selengkapnya, lihat Log analysis.

• Auto Fill TraceId and SpanId: Jika Anda mengaktifkan fitur ini, Trace ID dan Span ID akan secara otomatis diinjeksikan ke dalam log. Anda tidak perlu memodifikasi file konfigurasi log secara manual.

  Effect:

  Seperti yang ditunjukkan pada gambar berikut, log4j, log4j2, dan logback secara otomatis mencetak Trace ID dan Span ID dalam log tanpa perlu modifikasi apa pun pada file konfigurasi log.

  

• Support adding traceId in log MDC: Secara default, agen versi V4.x tidak mendukung pengambilan TraceId menggunakan metode org.slf4j.MDC.get(“EagleEye-TraceID”). Jika Anda masih perlu menggunakan metode ini, Anda dapat mengaktifkan switch ini.

Pengaturan konvergensi URL

Pada bagian URL Convergence Settings, Anda dapat mengaktifkan atau menonaktifkan konvergensi, serta menentukan ambang batas konvergensi dan aturan konvergensi. Konvergensi URL menampilkan URL yang serupa sebagai satu objek. Misalnya, URL yang diawali dengan /service/demo/ ditampilkan sebagai satu objek. Ambang batas konvergensi adalah jumlah minimum URL yang dapat memicu konvergensi URL. Sebagai contoh, jika ambang batas diatur ke 100, konvergensi URL hanya dipicu ketika minimal terdapat 100 URL yang sesuai dengan ekspresi reguler suatu aturan. Untuk informasi selengkapnya, lihat ARMS convergence policies.

Pemantauan Arthas

Pada 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 selengkapnya, lihat Arthas diagnostics.

Pengaturan profiling berkelanjutan

Pada bagian Continuous Profiling Settings, Anda dapat mengaktifkan atau menonaktifkan switch utama serta switch untuk CPU Hotspot, Memory Hotspot, dan Code Hotspot. Anda juga dapat menentukan alamat IP atau Blok CIDR tempat pengaturan ini diterapkan. Untuk informasi selengkapnya, lihat Continuous profiling for Java applications.

Pengaturan desensitisasi informasi

Pada bagian Information Desensitization Settings, Anda dapat menetapkan aturan desensitisasi untuk mendesensitisasi konten seperti parameter sistem JVM, K8s YAML, parameter input metode, variabel lingkungan Arthas, dan variabel sistem selama pengumpulan data. Elemen dalam aturan dipisahkan dengan koma, dan setiap elemen merepresentasikan ekspresi reguler yang tidak membedakan huruf besar/kecil. Misalnya, password setara dengan ekspresi reguler .*password.*.

Ketika agen mengumpulkan data, ia menyaring kunci data berdasarkan ekspresi tersebut. Jika suatu kunci cocok dengan ekspresi, nilai yang bersesuaian dianggap sebagai data sensitif dan didesensitisasi. Seperti yang ditunjukkan pada gambar berikut, jika aturan desensitisasi diatur ke licenseKey, nilai dari kunci -Darms.licenseKey akan didesensitisasi.

Gambar berikut menunjukkan efek setelah desensitisasi IP diaktifkan:

Pengaturan panggilan antarmuka

Pada bagian Interface Call Settings, Anda dapat menentukan ambang batas untuk panggilan lambat dan mengonfigurasi daftar putih pengecualian, daftar putih kode status HTTP, serta kebijakan penyaringan panggilan antarmuka yang tidak valid.

• Slow Call Threshold: Nilai default adalah 500. Jika waktu respons suatu antarmuka melebihi ambang batas ini, antarmuka tersebut ditandai sebagai panggilan lambat.

• HTTP status code whitelist:

  Secara default, kode status HTTP yang lebih besar atau sama dengan 400 diklasifikasikan sebagai panggilan error. Jika Anda tidak ingin kode status tertentu diklasifikasikan sebagai error, Anda dapat menambahkannya ke daftar putih untuk mengabaikan jenis error tersebut.

  Hal ini hanya berlaku untuk framework HTTP yang didukung oleh Pemantauan Aplikasi.

  Affected data: Metrik jumlah error untuk sisi server atau client HTTP (arms_http_requests_error_count, arms_http_client_requests_error_count, dan arms_app_requests_error_count) serta status span.

  Affected features: Jumlah error pada tab Overview, Provided Services, dan Dependencies, serta status span dan alert jumlah error pada halaman Trace Explorer.

  Content format: Masukkan satu kode status. Pisahkan beberapa kode status dengan koma (,). Pencocokan fuzzy tidak didukung.

  Example: 403,502

  Default value: Kosong

• Invalid interface call filtering:

  Jika Anda tidak ingin melihat panggilan tertentu pada tab Provided Services, Anda dapat memasukkan nama antarmuka yang ingin disaring. Agen tidak akan melaporkan data observabilitas untuk antarmuka tersebut, sehingga antarmuka tersebut disembunyikan dari halaman panggilan antarmuka.

  Catatan

  • Untuk agen Java versi sebelum V4.2.0, fitur ini hanya berlaku untuk antarmuka yang muncul pada tab Provided Services.

  • Untuk agen Java versi V4.2.0 atau lebih baru, fitur ini berlaku untuk semua LocalRootSpan.

  Affected data: Semua metrik dan span yang berkaitan dengan antarmuka tersebut diabaikan.

  Affected features: Semua metrik yang berkaitan dengan antarmuka pada tab Overview, Provided Services, dan Dependencies, serta jumlah span, jumlah panggilan ke antarmuka, jumlah error, dan alert panggilan lambat pada halaman Trace Explorer.

  Content format: Gunakan string atau ekspresi AntPath untuk mencocokkan nama lengkap antarmuka yang tidak valid. Pisahkan beberapa aturan dengan koma (,). Ekspresi AntPath pada nilai default bertujuan untuk kompatibilitas dengan data historis. Kami menyarankan agar Anda tidak menghapusnya. Tambahkan konfigurasi baru setelah aturan yang sudah ada.

  Example: /api/test/*,/api/playground/create

  Default value: /**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csv

• Record upstream interface name in interface call metric dan Record upstream application name in interface call metric:

  Configuration purpose: Mengontrol apakah nama aplikasi hulu dan nama antarmuka hulu yang memanggil antarmuka ini direkam dalam metrik antarmuka. Hal ini terutama memengaruhi keberadaan data jejak hulu dan hilir pada tab Provided Services. Ketika suatu aplikasi memiliki banyak aplikasi hulu, merekam informasi ini dapat meningkatkan volume metrik yang dilaporkan secara signifikan dan menyebabkan biaya yang lebih tinggi.

  Configuration effect: Seperti yang ditunjukkan pada gambar, setelah pencatatan aplikasi hulu dan antarmuka hulu dalam metrik antarmuka dinonaktifkan, data yang bersesuaian turun menjadi 0.

  

• Record original status code in interface call metric:

  Configuration purpose: Merekam kode respons asli dalam metrik yang terkait dengan antarmuka HTTP.

  Configuration effect:

  

• Record HTTP method name for interface: Saat switch ini diaktifkan, nama antarmuka yang ditampilkan pada halaman Interface Calls mencakup nama metode permintaan HTTP. Misalnya, nama berubah dari /api/v1/use/{userId} menjadi GET /api/v1/use/{userId}.

Pengaturan panggilan database

Pada bagian Database Call Settings, Anda dapat menentukan ambang batas untuk pernyataan SQL lambat dan panjang maksimum untuk pernyataan SQL yang dikumpulkan. Anda juga dapat menentukan apakah akan menampilkan nilai binding variabel dan nilai konstan dalam pernyataan SQL, serta apakah akan mencatat ukuran nilai kembali untuk query MySQL.

• Display variable binding values in SQL: Menangkap nilai variabel yang di-bind ke parameter PreparedStatement. Konfigurasi ini berlaku tanpa perlu restart aplikasi.

  Nilai variabel yang di-bind ke parameter PreparedStatement direkam dan disimpan sebagai atribut dalam span akses database yang bersesuaian. Dalam atribut tersebut, kuncinya adalah db.bindvalue dan nilainya adalah daftar nilai variabel yang dipisahkan koma. Konfigurasi ini berlaku tanpa perlu restart aplikasi.

  • Pengaturan ini didukung oleh semua framework berbasis JDBC yang saat ini didukung oleh ARMS.

  • Tipe variabel database berikut didukung untuk pengaturan ini: Boolean, Byte, Short, Int, Long, Float, Double, BigDecimal, dan Date.

  • Mengaktifkan switch ini menimbulkan overhead tambahan, yang secara langsung sebanding dengan jumlah variabel dalam pernyataan SQL. Dalam skenario uji stres resmi (dengan satu variabel), mengaktifkan fitur ini menghasilkan overhead CPU tambahan kurang dari 0,5% dan overhead memori yang dapat diabaikan.

  Gambar berikut menunjukkan efek aktual setelah switch ini diaktifkan:

  

• Display constant values in SQL: Pengaturan ini menampilkan nilai konstan dalam pernyataan SQL tanpa pemrosesan tambahan. Konfigurasi ini berlaku tanpa perlu restart aplikasi. Jika Anda mengaktifkan opsi ini, pernyataan SQL dengan nilai konstan yang berbeda dianggap sebagai pernyataan yang berbeda. Hal ini dapat mencegah konvergensi yang benar dan menyebabkan pernyataan tersebut dikelompokkan di bawah {ARMS_OTHERS}. Kami menyarankan agar Anda tetap menonaktifkan opsi ini.

Pengaturan protokol propagasi konteks jejak

Pada bagian Trace context propagation protocol settings, Anda dapat memilih protokol propagasi konteks jejak sesuai kebutuhan Anda.

Secara default, agen ARMS memilih protokol propagasi konteks jejak berdasarkan apakah header permintaan berisi header protokol tertentu. Untuk informasi selengkapnya, lihat ARMS trace context propagation protocol selection policy.

Anda dapat memilih protokol apa pun pada halaman ini sebagai protokol utama. Setelah Anda memilih dan menyimpan preferensi, ARMS akan memprioritaskan pemeriksaan header permintaan dari protokol yang dipilih. Misalnya, dengan konfigurasi berikut, ketika permintaan diterima, agen ARMS memeriksa konteks protokol dalam urutan Jaeger, EagleEye, W3C, SkyWalking, dan Zipkin.

Anda juga dapat memilih untuk menerapkan penggunaan protokol tertentu secara paksa. Misalnya, dengan konfigurasi berikut, ketika permintaan diterima, agen ARMS hanya memeriksa keberadaan header permintaan yang ditentukan oleh protokol Jaeger. Jika header tersebut tidak terdeteksi, agen tidak memeriksa protokol lain. Sebaliknya, agen akan menghasilkan konteks jejak baru.

Configuration purpose:

Fitur ini mendukung pemilihan protokol propagasi konteks jejak yang diutamakan atau diberlakukan secara paksa. Skenario umum meliputi:

• Permintaan membawa konteks jejak dalam beberapa format, dan urutan parsing default tidak memenuhi kebutuhan Anda. Anda ingin menentukan protokol yang diprioritaskan. Misalnya, jika permintaan membawa konteks jejak W3C dan Zipkin, konteks jejak W3C diparse dengan prioritas secara default. Anda dapat mengatur protokol propagasi ke Zipkin untuk memprioritaskan protokol Zipkin.

• Permintaan membawa header protokol jejak, tetapi Anda tidak ingin menggunakannya kembali. Anda ingin menghasilkan konteks jejak baru menggunakan protokol lain. Misalnya, jika permintaan membawa konteks jejak Zipkin, konteks jejak Zipkin diparse secara default. Dengan mengatur protokol propagasi ke W3C dan mengubah mode propagasi ke Enforced, sistem akan mengabaikan konteks jejak Zipkin dan menghasilkan konteks baru yang sesuai dengan W3C. Perhatikan bahwa jika Anda tidak mengubah mode propagasi ke Enforced, sistem tetap akan mencoba mem-parse konteks jejak Zipkin setelah gagal mem-parse konteks W3C yang diprioritaskan.

Configuration effect:

Setelah dikonfigurasi, setiap LocalRootSpan dalam jejak akan menyertakan atribut dengan kunci trace.protocol.type dan nilai yang menunjukkan protokol jejak dari jejak tersebut.

Pengaturan antrian pesan

Pada bagian Message Queue Settings, Anda dapat menyesuaikan informasi konsumen.

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

• Custom Kafka consumption method: Anda dapat menentukan metode konsumsi kustom untuk melihat jejak dan metrik saat mengonsumsi pesan menggunakan SDK Kafka native.

• Automatic context pass-through for Kafka messages: Saat pesan dikirim, beberapa header secara otomatis ditambahkan ke pesan Kafka untuk mengasosiasikan jejak pengiriman dengan jejak konsumsi.

Pengaturan koleksi agen

Pada bagian Agent Collection Settings, Anda dapat mengatur jumlah maksimum jejak yang dikumpulkan per detik oleh agen, ambang batas QPS maksimum yang dapat ditangani agen, serta tingkat log agen.

• Collect traces: Mengontrol apakah data jejak dilaporkan. Fitur ini diaktifkan secara default. Jika Anda menonaktifkannya, data jejak tidak lagi dilaporkan.

• Maximum number of traces collected by the agent per second: Jumlah span yang dapat dilaporkan agen per detik. Untuk alasan performa, ambang batas efektif sebenarnya mungkin menyimpang hingga 5% dari ambang batas yang dikonfigurasi pengguna. Span yang melebihi batas ini tidak dilaporkan.

• Maximum QPS threshold that the agent can handle: Jumlah permintaan yang dapat ditangani agen per detik. Untuk alasan performa, ambang batas efektif sebenarnya mungkin menyimpang hingga 5% dari ambang batas yang dikonfigurasi pengguna. Permintaan yang melebihi ambang batas ini tidak dipantau. Artinya, tidak ada span atau metrik yang dihasilkan untuk permintaan tersebut, dan fitur asosiasi log dengan TraceId tidak berlaku.

• Collect internal call data without an entry: Di ARMS, layanan HTTP dan layanan RPC yang disediakan aplikasi, tugas terjadwal yang dipicu aplikasi, serta konsumsi pesan dianggap sebagai entri. Panggilan database dan permintaan HTTP yang dikirim dalam logika bisnis entri tersebut dianggap sebagai panggilan internal dengan entri. Sebaliknya, panggilan HTTP terjadwal, panggilan database, panggilan NoSQL, pengiriman pesan, dan panggilan RPC yang diinisiasi menggunakan kolam thread Java Development Kit (JDK) dianggap sebagai panggilan internal tanpa entri. Agen versi V4.2.2 dan lebih baru menyediakan opsi satu-klik untuk menyaring data ini. Seperti yang ditunjukkan pada gambar berikut, dalam framework Lettuce, perintah dieksekusi secara berkala untuk memastikan koneksi normal dengan sisi server Redis. Panggilan semacam ini merupakan panggilan internal tanpa entri. Setelah koleksi data panggilan internal tanpa entri dinonaktifkan pada titik waktu yang ditunjukkan pada gambar, data terkait tidak lagi dikumpulkan.

  

• Agent log level: Menyesuaikan tingkat logging agen, yang berguna untuk troubleshooting.

• Report agent logs: Menentukan apakah agen diizinkan melaporkan log operasionalnya ke sisi server ARMS untuk troubleshooting cepat. Dalam kondisi normal, hanya sejumlah kecil log yang dilaporkan per menit.

• Default metric collection filter: Menyaring pelaporan jenis metrik tertentu. Anda dapat memilih beberapa jenis dari jenis yang didukung berikut:

  • custom_entry: metrik kustom untuk pemantauan metode

  • http: metrik untuk sisi server HTTP

  • http_client: metrik untuk client HTTP

  • rpc: metrik untuk sisi server panggilan RPC

  • rpc_client: metrik untuk client panggilan RPC

  • sql: metrik terkait akses layanan 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 metrik yang akan dikumpulkan yang didefinisikan oleh OpenTelemetry SDK. Untuk informasi selengkapnya, lihat Customize metrics using the OpenTelemetry Java SDK.

• Baggage collection list: Saat bisnis Anda menggunakan baggage, pengaturan ini menulis baggage tertentu ke atribut span, sehingga memudahkan pengambilan jejak tertentu.

Pengaturan penyaringan pengecualian lanjutan

Pada bagian Advanced exception filtering settings, Anda dapat mengonfigurasi aturan koleksi pengecualian.

• Collect plug-in exceptions: Menentukan apakah pengecualian plug-in akan dikumpulkan.

• Stack depth for distinguishing similar exceptions: Nilai default adalah 2. Kedalaman stack ini digunakan untuk mengidentifikasi jenis pengecualian yang serupa. Memodifikasi konfigurasi ini dapat menyebabkan perilaku statistik yang tidak terduga. Lakukan dengan hati-hati.

• Exception filtering whitelist:

  Jika Anda tidak ingin melihat pengecualian ini pada tab Exception Analysis, Anda dapat memasukkan nama kelas lengkap dari pengecualian yang ingin diabaikan. Hal ini akan menyembunyikannya dari halaman Exception Analysis.

  Affected data: Metrik jumlah pengecualian (arms_exception_requests_count_raw dan arms_exception_requests_seconds_raw) serta informasi pengecualian dalam span.

  Affected features: Metrik untuk pengecualian yang bersesuaian pada tab Exception Analysis.

  Content format: Gunakan nama kelas lengkap untuk mengidentifikasi pengecualian yang perlu disaring. Pisahkan beberapa pengecualian dengan koma (,).

  Example: java.lang.InterruptedException,java.lang.IndexOutOfBoundsException

  Default value: Tidak ada

• Exception filtering for parent class inheritance: Jika Anda mengaktifkan switch ini, pengecualian juga akan disaring jika merupakan kelas turunan dari kelas pengecualian yang dikonfigurasi dalam daftar putih penyaringan pengecualian.

  Configuration effect: Pengecualian yang memenuhi kriteria penyaringan tidak ditampilkan di konsol ARMS.

• Exception message filtering: Setelah fitur ini dikonfigurasi, pengecualian jenis tertentu juga akan disaring jika bidang pesannya sesuai dengan kondisi yang dikonfigurasi.

  • Exception name: Menentukan pengecualian tempat filter diterapkan.

  • Message condition: Kondisi untuk pesan pengecualian. Nilainya dapat berupa startsWith, endsWith, atau contains.

  • Message keyword: String kata kunci.

  Configuration effect: Pengecualian yang memenuhi kriteria penyaringan tidak ditampilkan di konsol ARMS.

Pengaturan pemantauan pooling

Pada bagian Pooling monitoring settings, Anda dapat mengonfigurasi aturan koleksi untuk kolam thread dan kolam koneksi.

• Thread pool and connection pool monitoring: Tentukan apakah akan memantau metrik kolam thread dalam framework seperti Tomcat, Dubbo, dan High-speed Service Framework (HSF). Untuk mengaktifkan fitur ini, Anda harus meningkatkan agen 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 dalam kolam thread dengan *. Anda juga dapat menyesuaikannya agar hanya mengganti karakter akhir dari nama thread dengan *. Pada aplikasi yang menginisiasi beberapa Dubbo Provider dengan port pendengar berbeda, jika strategi default diterapkan, dua kolam thread dari dua Dubbo Provider mungkin digabungkan menjadi satu kolam thread karena template nama thread yang diekstraksi identik. Dalam kasus ini, menyesuaikan strategi membantu membedakan kedua kolam thread tersebut.

  Configuration effect: Untuk kolam thread Tomcat umum, nama thread kolam thread yang ditampilkan secara default adalah http-nio-*-exec-*. Setelah penyesuaian, nama thread menjadi http-nio-9099-exec-*.

  

• Thread pool usage scenario filtering dan Thread pool thread name pattern filtering: Metrik untuk kolam thread tertentu dapat dikecualikan dari pelaporan berdasarkan skenario penggunaan dan pola nama thread-nya.

  Catatan

  Konfigurasi ini hanya berlaku untuk agen Java versi V4.2.0 atau lebih baru.

  • Thread pool usage scenario: Skenario penggunaan thread. Saat ini, Tomcat, Vert.x, Undertow, Dubbo, Jetty, AliyunJavaAgent, dan default didukung. AliyunJavaAgent merepresentasikan kolam thread yang digunakan oleh agen, dan default merepresentasikan kolam thread lain yang tidak terklasifikasi.

  • Thread pool thread name pattern: Pola yang diperoleh setelah nama thread dalam kolam thread diproses. Misalnya, http-nio-*-exec-* umumnya diperoleh dengan mengganti bagian numerik dari nama thread aktual dengan *.

  Affected data: Metrik kolam thread

  Affected features: Tab Thread Pool Monitoring dan alert yang dikonfigurasi berdasarkan metrik pemantauan kolam thread.

  Content format:

  • Thread pool usage scenario filtering: Skenario penggunaan yang ditampilkan pada tab Thread Pool Monitoring. Pisahkan beberapa skenario penggunaan dengan koma (,).

  • Thread pool thread name pattern filtering: Pola nama thread yang ditampilkan pada tab Thread Pool Monitoring. Pisahkan beberapa skenario penggunaan dengan koma (,). Metode pencocokan adalah pencocokan eksak. Pencocokan berbasis aturan tidak didukung.

  Example:

  • Thread pool usage scenario filtering: AliyunJavaAgent,Jetty

  • Thread pool thread name pattern filtering: Catalina-utility-*,DubboServerHandler-*-thread-*

  Ini menunjukkan bahwa semua data kolam thread untuk skenario AliyunJavaAgent tidak dilaporkan. Untuk skenario lain, jika nama pola kolam thread adalah Catalina-utility-*, datanya juga tidak dilaporkan.

  Default value: Tidak ada

Pengaturan atribut span

• Record OTel Spec conventional attributes: Spesifikasi OpenTelemetry menetapkan atribut yang harus disertakan dalam span yang dihasilkan oleh setiap jenis plug-in. Namun, untuk mengurangi volume pelaporan data, agen ARMS secara default tidak mencatat atribut ini dalam span. Anda dapat mengaktifkan fitur ini sesuai kebutuhan. Untuk informasi tentang atribut tambahan yang ditambahkan oleh berbagai framework setelah fitur ini diaktifkan, lihat Spesifikasi OpenTelemetry.

  Contoh berikut menunjukkan span untuk HTTP Server. Atribut dalam kotak merah adalah atribut yang ditambahkan setelah switch ini diaktifkan.

  

• Span association application label configuration: Pengaturan ini mengontrol span mana yang memiliki label aplikasi terlampir. Label aplikasi dikonfigurasi pada halaman Applications. Secara default, semua span menyertakan label aplikasi. Untuk mengurangi volume data, Anda dapat 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 setelah Anda mengonfigurasi label untuk dilampirkan pada span entri. Misalnya, sebuah aplikasi berisi sepasang label aplikasi seperti test1:value1.

  

  Untuk span entri, Anda dapat melihat atribut label yang bersesuaian.

  

  Untuk span non-entri, atribut test1:value tidak disertakan.

  

Pengaturan lanjutan

Pada bagian Advanced Settings, Anda dapat mengonfigurasi pengaturan lanjutan, seperti antarmuka yang ingin disaring dan panjang maksimum stack metode.

• Quantile Statistics: Anda dapat mengaktifkan atau menonaktifkan statistik kuantil.

• Maximum retention length of method stack: Nilai default adalah 128 dan nilai maksimum adalah 400.

• Trace compression: Menentukan apakah akan menyederhanakan panggilan berulang, seperti untuk loop.

• Maximum display length of request input parameters: Panjang default adalah 512 karakter dan panjang maksimum adalah 2.048 karakter.

• Asynchronous pass-through scan package name: Untuk memantau tugas asinkron, Anda dapat menambahkan paket pemindaian untuk propagasi asinkron ke konfigurasi aplikasi Anda. Saat objek `Runnable`, `Callable`, atau `Supplier` dibuat, metode dalam paket pemindaian yang ditentukan secara otomatis menangkap konteks jejak dari thread saat ini. Konteks yang ditangkap ini kemudian dipropagasikan ke thread baru saat tugas asinkron dieksekusi.

• Include TraceId in HTTP response: Menentukan apakah field eagleeye-traceid akan dikembalikan dalam header respons untuk permintaan HTTP.

• JVM GC Trigger Root Cause: Menentukan apakah akan mengumpulkan akar penyebab pemicu garbage collection (GC) Java Virtual Machine (JVM). Anda dapat melihat detail pemantauan pada halaman JVM Monitoring. Untuk informasi tentang akar penyebab pemicu GC, lihat GC-related metrics.

Salin pengaturan ke aplikasi lain

Untuk menyinkronkan pengaturan yang sama ke aplikasi lain, Anda dapat menyalin pengaturan yang bersesuaian ke aplikasi lain.

Konfigurasi default global

Anda dapat menyimpan pengaturan saat ini sebagai konfigurasi default global. Saat Anda membuat aplikasi baru, pengaturan ini digunakan secara default.

1. Di bagian bawah halaman, klik Save current app settings as global default configuration.

2. 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 configuration.

3. Pada kotak dialog yang muncul, klik Confirm.

FAQ