Layanan Pemantauan Aplikasi Waktu Nyata (ARMS) memungkinkan Anda menyesuaikan pengaturan aplikasi Java pada tab Konfigurasi Kustom di halaman detail aplikasi, seperti mengonfigurasi kebijakan pengambilan sampel atau mengubah saklar agen.
Untuk informasi tentang cara menggunakan API ARMS guna mengonfigurasi pengaturan ini, lihat SaveTraceAppConfig.
Prasyarat
Agen ARMS telah diinstal pada aplikasi tersebut.
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 Daftar Aplikasi untuk melihat halaman detail aplikasi baru.
Prosedur
Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih .
Pada halaman Applications, pilih wilayah di bilah navigasi atas, lalu klik nama aplikasi.
Di bilah navigasi atas, pilih .
Konfigurasikan parameter dan klik Save.
Ikon di kolom Language menunjukkan bahasa penulisan aplikasi.
: Aplikasi Java
: Aplikasi Go
: Aplikasi Python
Tanda hubung (-): aplikasi yang dipantau di Managed Service for OpenTelemetry.
Pengaturan pengambilan sampel
Pada bagian Sampling Settings, Anda dapat mengonfigurasi kebijakan pengambilan sampel dan satu atau beberapa nama antarmuka. Untuk informasi selengkapnya, lihat Pilih mode pengambilan sampel jejak untuk agen ARMS V3.2.8 dan versi lebih baru.
Pengaturan saklar agen
Pada bagian Probe switch settings, Anda dapat mengaktifkan atau menonaktifkan pemantauan aplikasi serta memilih plugin yang ingin digunakan.
Pengaktifan atau penonaktifan pemantauan aplikasi berlaku langsung tanpa perlu me-restart aplikasi. Jika Anda menonaktifkan pemantauan aplikasi, sistem tidak dapat memantau aplikasi tersebut. Lakukan dengan hati-hati.
Jika Anda mengubah saklar plugin, Anda harus me-restart aplikasi secara manual agar perubahan tersebut berlaku.

Pengaturan profiling thread
Pada bagian Thread Analysis Settings, Anda dapat mengaktifkan atau menonaktifkan saklar utama analisis thread.
Pengaturan asosiasi log aplikasi
Pada bagian Application log Association configuration, Anda dapat mengonfigurasi sumber log yang ingin diasosiasikan dengan aplikasi serta menentukan apakah TraceId dan SpanId akan diisi secara otomatis ke dalam log. Untuk informasi selengkapnya, lihat Analisis log.

Automatically Fill TraceID dan Automatically Fill SpanId: secara otomatis menyisipkan TraceId dan SpanId ke dalam log tanpa perlu mengubah file konfigurasi log.
Effect konfigurasi:
Seperti yang ditunjukkan pada gambar berikut, log4j, log4j2, dan logback secara otomatis mencetak TraceId dan SpanId dalam log tanpa mengubah file konfigurasi log.

Log MDC add traceId: menentukan apakah akan mendapatkan TraceId melalui
org.slf4j.MDC.get(“EagleEye-TraceID”), yang secara default tidak didukung oleh agen ARMS V4.x.
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 dengan awalan /service/demo/ ditampilkan sebagai satu objek. Ambang batas konvergensi adalah jumlah minimum URL yang dapat memicu konvergensi URL. Misalnya, jika ambang batas diatur ke 100, URL hanya akan dikonvergensikan ketika terdapat 100 URL yang memenuhi ekspresi reguler dari aturan tersebut. Untuk informasi selengkapnya, lihat Kebijakan konvergensi ARMS.

Pemantauan Arthas
Pada bagian Arthas monitoring, Anda dapat mengaktifkan atau menonaktifkan fitur diagnostik Arthas serta menentukan alamat IP tempat Anda ingin melakukan diagnostik Arthas. Untuk informasi selengkapnya, lihat Diagnostik Arthas.

Pengaturan profiling berkelanjutan
Pada bagian Ongoing Profiling Settings, Anda dapat mengaktifkan atau menonaktifkan saklar Main switch, CPU hotspot, Memory Hotspot, dan Code Hotspot, serta menentukan alamat IP efektif atau blok CIDR efektif. Untuk informasi selengkapnya, lihat Profiling berkelanjutan untuk aplikasi Java.

Pengaturan desensitisasi informasi
Pada bagian Information desensitization, Anda dapat mengonfigurasi aturan desensitisasi untuk mendesensitisasi parameter sistem JVM, konfigurasi YAML Kubernetes, parameter input metode, variabel lingkungan Arthas, dan variabel sistem selama pengumpulan data. Setiap elemen dalam aturan merepresentasikan ekspresi reguler yang tidak membedakan huruf besar/kecil. Misalnya, password merepresentasikan ekspresi reguler .*password.*. Pisahkan beberapa elemen dengan koma (,).
Ketika agen ARMS mengumpulkan data, agen tersebut mendesensitisasi data berdasarkan kunci. Jika suatu kunci cocok dengan ekspresi reguler, nilai yang sesuai akan didesensitisasi. Seperti yang ditunjukkan pada gambar berikut, jika Anda menentukan licenseKey dalam aturan, nilai dari kunci -Darms.licenseKey akan didesensitisasi.
Pengaturan panggilan antarmuka
Pada bagian Interface call configuration, Anda dapat menentukan ambang batas untuk panggilan lambat dan menyesuaikan daftar putih pengecualian, daftar putih kode status HTTP, serta kebijakan penyaringan antarmuka tidak valid.

Ambang Batas Panggilan Lambat: Satuan: ms. Nilai default: 500. Jika waktu respons suatu permintaan melebihi ambang batas, permintaan tersebut ditandai sebagai lambat.
Daftar putih kode status HTTP:
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 mengatur daftar putih untuk mengabaikan error tersebut.
Ini hanya memengaruhi kerangka kerja HTTP yang saat ini didukung oleh Pemantauan Aplikasi.
Data yang Terpengaruh: Metrik jumlah error untuk server/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 Ikhtisar, Layanan yang Disediakan, dan Dependencies, serta status span, jumlah error, dan peringatan pada tab Trace Explorer.
Format Konten: Masukkan kode status tunggal; pisahkan beberapa kode status dengan koma (,). Pencocokan fuzzy tidak didukung.
Contoh:
403,502Nilai Default: Tidak ada
Penyaringan panggilan antarmuka tidak valid:
Jika Anda tidak ingin melihat beberapa panggilan pada tab Layanan yang Disediakan, Anda dapat memasukkan nama antarmuka yang detail panggilannya tidak perlu dilihat, sehingga disembunyikan. Agen ARMS tidak akan melaporkan data observabilitasnya.
CatatanUntuk agen ARMS untuk Java versi sebelum v4.2.0, fitur ini hanya berlaku untuk antarmuka yang muncul di tab Layanan yang Disediakan.
Untuk agen ARMS untuk Java v4.2.0 dan versi lebih baru, fitur ini berlaku untuk semua LocalRootSpan.
Data yang Terpengaruh: Semua metrik dan span yang sesuai dengan antarmuka tersebut akan diabaikan.
Fitur yang Terpengaruh: Semua metrik terkait antarmuka pada tab Ikhtisar, Layanan yang Disediakan, dan Dependencies, serta jumlah span, jumlah panggilan antarmuka, jumlah error, dan peringatan pada tab Trace Explorer.
Format Konten: Gunakan string atau ekspresi AntPath untuk mencocokkan nama lengkap antarmuka yang tidak valid. Pisahkan beberapa aturan dengan koma (,). (Ekspresi AntPath default disediakan untuk kompatibilitas dengan data yang ada dan tidak disarankan untuk dihapus. Konfigurasi baru harus ditambahkan ke aturan yang sudah ada.)
Contoh:
/api/test/*,/api/playground/createNilai Default:
//*.jpg,//.png,/**/.js,//*.jpeg,//.pdf,/**/.xlsx,//*.txt,//.docs,/**/.gif,/**/*.csvApakah nama antarmuka hulu dicatat dalam indikator panggilan antarmuka dan Apakah nama aplikasi hulu dicatat dalam indikator panggilan antarmuka:
Tujuan konfigurasi: Mengontrol apakah akan mencatat aplikasi hulu dan antarmuka hulu yang memanggil antarmuka ini dalam metrik antarmuka. Ini terutama memengaruhi apakah data ada pada jejak hulu dan hilir dalam layanan yang disediakan. Ketika suatu aplikasi memiliki banyak aplikasi hulu, pencatatan informasi ini dapat menyebabkan peningkatan signifikan pada jumlah laporan metrik, sehingga meningkatkan biaya.
Efek konfigurasi: Seperti yang ditunjukkan pada gambar, setelah menonaktifkan pencatatan aplikasi dan antarmuka hulu dalam metrik antarmuka, data yang sesuai turun menjadi 0.

Apakah indikator panggilan antarmuka mencatat kode status asli:
Tujuan konfigurasi: Mencatat kode respons asli dalam metrik terkait antarmuka HTTP.
Efek konfigurasi:

Record HTTP Method Name for Interface: Saat saklar ini diaktifkan, nama operasi API pada halaman panggilan antarmuka mencakup metode HTTP. Misalnya, nama berubah dari
/api/v1/use/{userId}menjadiGET /api/v1/use/{userId}.
Pengaturan panggilan database
Pada bagian Database call configuration, Anda dapat menentukan ambang batas untuk kueri SQL lambat dan panjang retensi maksimum untuk pernyataan SQL yang dikumpulkan. Anda juga dapat menentukan apakah akan menampilkan nilai variabel dan nilai konstan dalam pernyataan SQL, serta apakah akan mencatat nilai kembali dari kueri MySQL.

Show the variable binding value in SQL: menangkap nilai variabel yang diikat ke parameter PrepareStatement. Konfigurasi ini berlaku tanpa perlu me-restart aplikasi.
Nilai variabel yang diikat ke parameter PreparedStatement akan direkam dan disimpan sebagai atribut dalam span akses database yang sesuai. Dalam atribut ini, kuncinya adalah db.bindvalue dan nilainya adalah daftar nilai variabel yang dipisahkan koma.
Konfigurasi ini berlaku untuk semua kerangka kerja berbasis JDBC yang saat ini didukung oleh ARMS.
Tipe variabel database berikut didukung: Boolean, Byte, Short, Int, Long, Float, Double, BigDecimal, Date.
Mengaktifkan konfigurasi ini akan menimbulkan overhead tambahan, yang berbanding lurus dengan jumlah variabel dalam pernyataan SQL. Di bawah skenario pengujian beban resmi (dengan satu variabel), mengaktifkan fitur ini menghasilkan overhead CPU tambahan kurang dari 0,5%, dan overhead memori yang dapat diabaikan.
Efek aktual saat diaktifkan:

Show the constant values in SQL: Pernyataan SQL dipotong tanpa pemrosesan tambahan. Konfigurasi ini berlaku tanpa perlu me-restart aplikasi. Ketika pernyataan SQL berbeda mengandung nilai konstan yang berbeda, hal ini dapat menyebabkan pernyataan SQL tampak lebih beragam dan akhirnya diagregasi menjadi
{ARMS_OTHERS}. Kami tidak merekomendasikan mengaktifkan opsi ini.
Pengaturan protokol propagasi konteks jejak
Pada bagian Trace context propagation settings, Anda dapat memilih protokol propagasi konteks jejak berdasarkan kebutuhan bisnis Anda.

Secara default, agen ARMS memilih protokol propagasi konteks jejak berdasarkan apakah header permintaan mengandung header protokol tertentu.
Pada bagian ini, Anda dapat memilih protokol apa pun sebagai yang diprioritaskan. Setelah memilih dan menyimpan preferensi Anda, ARMS akan memprioritaskan pemeriksaan keberadaan header permintaan yang ditentukan oleh protokol yang dipilih. Misalnya, dengan konfigurasi berikut, agen ARMS memeriksa header 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 panggilan tiba, agen ARMS hanya akan memeriksa keberadaan header permintaan yang ditentukan oleh protokol Jaeger. Jika header tersebut tidak terdeteksi, agen tidak akan melanjutkan pemeriksaan protokol lain; sebaliknya, agen akan menghasilkan konteks jejak baru.

Tujuan konfigurasi:
Anda dapat memilih protokol propagasi konteks jejak yang diprioritaskan atau diterapkan secara paksa dalam skenario berikut:
Permintaan membawa konteks jejak dalam beberapa format, dan urutan penguraian default tidak memenuhi kebutuhan. Anda ingin menentukan protokol yang diprioritaskan untuk penguraian. Misalnya, jika permintaan membawa konteks jejak W3C dan Zipkin, secara default sistem memprioritaskan penguraian konteks jejak W3C. Anda dapat mengubah perilaku ini dengan mengatur protokol propagasi ke Zipkin, sehingga memprioritaskan protokol Zipkin.
Permintaan membawa header jejak dari protokol tertentu, tetapi Anda tidak ingin menggunakan kembali header tersebut dan lebih memilih untuk menghasilkan konteks jejak baru menggunakan protokol lain. Misalnya, jika permintaan membawa konteks jejak Zipkin, secara default sistem mengurai konteks jejak Zipkin. Dengan mengatur protokol propagasi ke W3C dan mengubah mode propagasi ke enforced, sistem akan mengabaikan konteks jejak Zipkin dan menghasilkan konteks baru sesuai spesifikasi protokol W3C. Perhatikan bahwa jika Anda tidak mengubah mode propagasi ke enforced, sistem tetap akan mencoba mengurai konteks jejak Zipkin setelah gagal mengurai konteks W3C.
Efek konfigurasi:
Setelah dikonfigurasi, setiap LocalRootSpan dalam jejak akan menyertakan atribut dengan kunci trace.protocol.type dan nilai sebagai protokol jejak saat ini yang digunakan dalam jejak tersebut.

Pengaturan antrian pesan
Pada bagian Message Queuing Configuration, Anda dapat menyesuaikan informasi konsumen.

Custom RabbitMQ consumer: Anda dapat menentukan nama kelas untuk konsumen kustom atau nama kelas untuk konsumen internal anonim untuk 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.
kafka sends automatic message pass-through context: Beberapa header ditambahkan secara otomatis ke pesan Kafka untuk mengasosiasikan jejak pengiriman dengan jejak konsumsi.
Pengaturan pengumpulan agen
Pada bagian Probe Acquisition Configuration, Anda dapat mengatur jumlah maksimum jejak yang dikumpulkan per detik oleh agen, ambang batas QPS maksimum yang dapat ditangani agen, dan tingkat log agen.

Collect call chain: Mengontrol apakah data jejak dilaporkan. Secara default diaktifkan. Jika dinonaktifkan, data jejak tidak akan lagi dilaporkan.
Maximum probe link acquisition per second: Tentukan jumlah span yang dapat dilaporkan agen per detik (untuk tujuan kinerja, ambang batas efektif aktual mungkin menyimpang hingga 5% dari ambang batas yang dikonfigurasi pengguna). Span yang melebihi batas ini tidak akan dilaporkan.
Probe maximum can handle QPS threshold: Tentukan jumlah permintaan yang dapat ditangani agen per detik (untuk tujuan kinerja, ambang batas efektif aktual mungkin menyimpang hingga 5% dari ambang batas yang dikonfigurasi pengguna). Permintaan yang melebihi ambang batas ini tidak akan dipantau, yang berarti tidak ada span atau metrik yang dihasilkan untuk permintaan tersebut, dan asosiasi log dengan TraceId juga tidak akan berfungsi.
Collect internal call data without entry: Di ARMS, layanan HTTP yang disediakan oleh aplikasi, layanan RPC, tugas terjadwal yang dipicu oleh aplikasi, dan konsumsi pesan dianggap sebagai titik masuk. Panggilan database, permintaan HTTP yang dikirim dalam logika bisnis titik masuk tersebut dianggap sebagai panggilan internal dengan titik masuk. Sebaliknya, panggilan HTTP, panggilan database, panggilan NoSQL, pengiriman pesan, dan panggilan RPC yang dimulai melalui kolam thread JDK dianggap sebagai panggilan internal tanpa titik masuk. Agen ARMS V4.2.2 dan versi lebih baru mendukung penyaringan data tersebut dengan sekali klik. Seperti yang ditunjukkan pada gambar di bawah, dalam kerangka kerja Lettuce, perintah dieksekusi secara berkala secara otomatis untuk memastikan koneksi normal dengan server Redis. Panggilan semacam ini termasuk dalam panggilan internal tanpa titik masuk. Setelah menonaktifkan pengumpulan data tersebut pada titik waktu yang ditunjukkan pada gambar, data terkait menghilang.

Probe log level: Sesuaikan tingkat logging agen, yang berguna untuk pemecahan masalah.
Custom Metric Collection Configuration: Konfigurasikan metrik yang akan dikumpulkan dan didefinisikan oleh SDK OpenTelemetry.
Pengaturan penyaringan lanjutan pengecualian
Pada bagian Exception Advanced Filtering Configuration, Anda dapat mengonfigurasi aturan pengumpulan pengecualian.

Collection plug-in exception: Menentukan apakah akan mengumpulkan pengecualian plugin.
Similar exception stack differentiation depth: Kedalaman stack ini digunakan untuk mengidentifikasi jenis pengecualian yang serupa. Nilai default: 2. Memodifikasi konfigurasi ini dapat menghasilkan perilaku statistik yang tidak terduga, jadi harap berhati-hati.
Exception filtering whitelist: Jika Anda tidak ingin melihat pengecualian tertentu pada tab Analisis Berbasis Skenario > Pengecualian, Anda dapat memasukkan nama kelas lengkap pengecualian yang tidak boleh dihitung sebagai pengecualian, sehingga disembunyikan.
Data yang Terpengaruh: Metrik jumlah pengecualian (arms_exception_requests_count_raw, arms_exception_requests_seconds_raw) dan informasi pengecualian dalam span.
dan informasi pengecualian dalam span.
Fitur yang Terpengaruh: Metrik untuk pengecualian yang sesuai pada tab Analisis Berbasis Skenario > Pengecualian, serta informasi Pengecualian dalam Span dan peringatan jumlah Pengecualian untuk pengecualian yang sesuai pada tab Trace Explorer.
Format Konten: Gunakan nama kelas lengkap untuk mengidentifikasi pengecualian yang perlu disaring. Pisahkan beberapa pengecualian dengan koma (,).
Contoh:
java.lang.InterruptedException,java.lang.IndexOutOfBoundsExceptionNilai Default: Tidak ada
Exception filtering parent class inheritance: Saat diaktifkan, jika pengecualian yang dikumpulkan saat ini merupakan subkelas dari kelas pengecualian yang dikonfigurasi dalam daftar putih penyaringan pengecualian, pengecualian tersebut juga akan disaring.
Efek konfigurasi: Pengecualian yang memenuhi kriteria penyaringan tidak akan ditampilkan di konsol ARMS.
Exception message filtering: Setelah dikonfigurasi, pengecualian dari tipe tertentu yang bidang pesannya memenuhi kondisi yang dikonfigurasi juga akan disaring.
Nama pengecualian: menentukan pengecualian mana yang diterapkan filter.
Kondisi pesan: kondisi pesan pengecualian, yang dapat berupa startsWith, endsWith, atau contains.
Kata kunci pesan: string kata kunci.
Efek konfigurasi: Pengecualian yang memenuhi kriteria penyaringan tidak akan ditampilkan di konsol ARMS.
Pengaturan pemantauan kolam
Pada bagian Pooled Monitoring Configuration, Anda dapat mengonfigurasi aturan pengumpulan untuk kolam thread dan kolam koneksi.

Thread pool and connection pool monitoring: 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.
Thread Pool Thread Name Pattern Extraction Policy: Fitur ini, secara default, mengganti semua karakter numerik dalam nama thread dari thread apa pun yang berjalan dalam kolam thread dengan
*. Anda juga dapat menyesuaikannya agar hanya mengganti karakter akhir nama thread dengan*. Pada aplikasi tempat beberapa Dubbo Provider diinisiasi dan provider tersebut memiliki port pendengar berbeda, jika strategi default diterapkan, dua kolam thread dari dua Dubbo Provider dapat diagregasi menjadi satu karena template nama thread yang diekstraksi identik. Pada titik ini, menyesuaikan strategi ini dapat membantu membedakan kedua kolam thread tersebut.Efek konfigurasi: Mengambil kolam thread Tomcat umum sebagai contoh, nama thread kolam thread yang ditampilkan secara default adalah
http-nio-*-exec-*. Setelah penyesuaian, nama thread menjadihttp-nio-9099-exec-*.
Thread pool using scenario filtering dan Thread Pool Thread Name Pattern Filtering: Metrik kolam thread tertentu dapat dikecualikan berdasarkan skenario penggunaannya dan pola nama thread.
CatatanKonfigurasi ini hanya berlaku untuk agen ARMS untuk Java v4.2.0 dan versi lebih baru.
Skenario penggunaan kolam thread mengacu pada konteks penggunaan thread, saat ini mendukung beberapa tipe termasuk Tomcat, Vert.x, Undertow, Dubbo, Jetty, AliyunJavaAgent, dan default. Di antaranya, AliyunJavaAgent merepresentasikan kolam thread yang digunakan oleh agen, sedangkan "default" merepresentasikan kolam thread lain yang tidak terklasifikasi.
Pola nama thread kolam thread menunjukkan pola yang diperoleh setelah memproses nama thread dalam kolam thread, seperti mengubah bagian nama thread yang mengandung angka menjadi * untuk mendapatkan pola seperti http-nio-*-exec-*.
Data yang Terpengaruh: Metrik kolam thread
Fitur yang Terpengaruh: Tab Pemantauan Instans > Pemantauan Kolam Thread dan peringatan yang dipicu berdasarkan metrik terkait kolam thread.
Format Konten:
Penyaringan Skenario Penggunaan Kolam Thread: Skenario penggunaan yang ditampilkan di tab Pemantauan Instans > Pemantauan Kolam Thread. Pisahkan beberapa skenario penggunaan dengan koma (,).
Penyaringan Pola Nama Thread Kolam Thread: Pola nama thread yang ditampilkan di tab pemantauan kolam thread. Pisahkan beberapa skenario penggunaan dengan koma (,). Metode pencocokan adalah pencocokan eksak dan tidak mendukung pencocokan berbasis aturan.
Contoh:
Penyaringan Skenario Penggunaan Kolam Thread:
AliyunJavaAgent,JettyPenyaringan Pola Nama Thread Kolam Thread:
Catalina-utility-*,DubboServerHandler-*-thread-*Artinya, semua data kolam thread untuk skenario "AliyunJavaAgent" tidak akan dilaporkan. Untuk skenario lain, jika pola kolam thread cocok dengan nama seperti
Catalina-utility-*, data tersebut juga tidak akan dilaporkan.Nilai Default: Tidak ada
Atribut span

Document the OTel Spec convention attributes: Spesifikasi OpenTelemetry menetapkan atribut yang harus disertakan dalam span yang dihasilkan oleh setiap tipe plugin. Namun, mempertimbangkan jumlah data yang dilaporkan, agen ARMS secara default tidak mencatat atribut ini dalam span. Anda dapat mengaktifkannya sesuai kebutuhan. Untuk informasi tentang atribut tambahan yang ditambahkan oleh berbagai kerangka kerja setelah diaktifkan, lihat dokumentasi Spesifikasi OpenTelemetry.
Contoh berikut menunjukkan span untuk server HTTP, di mana atribut dalam kotak merah adalah atribut baru yang ditambahkan setelah mengaktifkan saklar.

span Association application label configuration: Ini digunakan untuk mengontrol span mana yang akan memiliki tag yang terikat ke aplikasi di halaman Applications. Secara default, semua span menyertakan tag aplikasi. Memperhitungkan volume penggunaan, Anda dapat melampirkan tag aplikasi hanya ke span entri, seperti span server HTTP, server RPC, antrian pesan, atau tugas terjadwal.
Efek setelah mengonfigurasi untuk melampirkan ke span entri ditunjukkan pada gambar di bawah. Misalnya, sebuah aplikasi menyertakan sepasang tag seperti
test1:value1.
Untuk span entri, Anda dapat melihat atribut tag yang sesuai.

Untuk span non-entri, mereka tidak mengandung
test1:value.
Pengaturan lanjutan
Pada bagian Advanced Settings, Anda dapat mengonfigurasi pengaturan lanjutan, seperti antarmuka yang ingin dikecualikan 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.
Call chain compression: Tentukan apakah akan menyederhanakan panggilan duplikat 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: Anda dapat menambahkan paket pemindaian untuk propagasi 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 propagasi asinkron secara otomatis menangkap konteks jejak dari thread saat ini. Kemudian, ketika thread digunakan dalam mode asinkron, metode tersebut menyebarkan konteks jejak yang ditangkap ke thread tersebut.
The HTTP response contains TraceId: Tentukan apakah akan mengembalikan field eagleeye-traceid dalam header respons untuk permintaan HTTP.
JVM GC Trigger Root Cause: Tentukan apakah akan melihat akar penyebab pemicu garbage collection (GC) JVM. Anda dapat melihat detail pemantauan di halaman Pemantauan JVM. Untuk informasi tentang akar penyebab pemicu GC, lihat Metrik GC.
Salin pengaturan aplikasi ke aplikasi lain
Anda dapat menyalin pengaturan suatu aplikasi ke aplikasi lain.
Salin satu item konfigurasi ke aplikasi lain
Di bagian item konfigurasi, klik Save and bulk copy to other applications.
Jika muncul pesan Current settings not saved, klik Save untuk menyimpan konfigurasi lalu klik Save and bulk copy to other applications.
Pada kotak dialog yang muncul, pilih aplikasi tertentu atau semua aplikasi lain lalu klik OK.
Salin semua item konfigurasi ke aplikasi lain
Di bagian bawah halaman, klik Save and bulk copy to other apps.
Jika muncul pesan Current settings not saved, klik Save untuk menyimpan konfigurasi lalu klik Save and bulk copy to other applications.
Pada kotak dialog yang muncul, pilih aplikasi tertentu atau semua aplikasi lain lalu klik OK.
Terapkan pengaturan aplikasi secara global
Anda dapat menerapkan pengaturan aplikasi saat ini secara global. Jika Anda membuat aplikasi baru, pengaturan tersebut digunakan secara default.
Di bagian bawah halaman, klik Save current app settings as global default configuration.
Jika muncul pesan Current settings not saved, klik Save untuk menyimpan konfigurasi lalu klik Save current app settings as global default configuration.
Pada pesan yang muncul, klik OK.
Pertanyaan Umum
Apa yang harus saya lakukan jika pengaturan saklar di bawah pengaturan aplikasi tidak berlaku?
Periksa apakah item konfigurasi yang perlu dimodifikasi memiliki persyaratan versi, seperti saklar yang diaktifkan atau dinonaktifkan secara default setelah versi agen tertentu.
Jika ya, periksa apakah versi agen saat ini memenuhi persyaratan. Jika tidak memenuhi persyaratan, Anda mungkin perlu mengklik simpan perubahan secara manual; jika memenuhi persyaratan, periksa log agen untuk log terkait listener konfigurasi.
Jika log tersebut tidak ada, konfirmasi lebih lanjut dengan memeriksa log agen untuk entri terkait listener konfigurasi.
Untuk agen ARMS V3.x, cari kata kunci
[Diamond] receive. Jika muncul konten seperti pada gambar di bawah, berarti konfigurasi berhasil didorong.
Untuk agen ARMS V4.x, cari kata kunci
config update. Jika muncul log seperti pada gambar di bawah, berarti konfigurasi berhasil didorong.
Mengapa penyesuaian laju pengambilan sampel tidak berlaku?
Laju pengambilan sampel suatu aplikasi hanya memengaruhi apakah jejak yang menggunakan aplikasi ini sebagai titik masuk diambil sampelnya. Jika suatu permintaan sudah membawa konteks jejak, maka aplikasi akan memulihkan konteks jejak tersebut dan menentukan apakah akan diambil sampelnya berdasarkan apakah konteks jejak tersebut menyatakan pengambilan sampel.
Apa yang harus saya lakukan jika mengonfigurasi paket pemindaian transmisi asinkron tidak mendukung ekspresi lambda?
Kami menyarankan Anda meningkatkan agen ARMS ke versi 4.x, yang mendukung transmisi konteks asinkron otomatis tanpa memerlukan modifikasi kode tambahan atau perubahan konfigurasi.
Mengapa aplikasi yang baru dibuat tidak berlaku sesuai konfigurasi default global?
Setelah menyimpan konfigurasi saat ini dari Aplikasi A sebagai konfigurasi default global, hanya snapshot konfigurasi saat ini dari Aplikasi A yang disimpan sebagai default global. Perubahan selanjutnya pada konfigurasi Aplikasi A tidak akan disinkronkan ke konfigurasi default global. Anda perlu mengklik secara manual untuk menyimpan konfigurasi yang diperbarui sebagai default global agar berlaku.
Apa yang harus saya lakukan jika konfigurasi untuk antarmuka /error tidak berlaku?
Untuk versi agen sebelum 3.2.0, penyaringan antarmuka dilakukan ketika panggilan antarmuka pertama kali memasuki aplikasi. Namun, antarmuka jenis /error dialihkan secara seragam ke halaman /error ketika panggilan antarmuka mengalami error. Pada titik ini, tidak ada operasi penyaringan yang dilakukan, sehingga penyaringan antarmuka tidak berlaku. Masalah ini telah diperbaiki di agen ARMS V3.2.0 dan versi lebih baru.
Mengapa URL tetap dikonvergensikan setelah menonaktifkan konvergensi URL?
Pengaturan konvergensi URL pada tab Custom Configuration hanya berlaku untuk agen ARMS V3.x. Di agen ARMS V4.x, pilih dari bilah navigasi atas.
Untuk agen ARMS versi sebelum V3.x yang diinstal untuk aplikasi yang menggunakan Spring MVC, konvergensi URL dapat dinonaktifkan dengan meningkatkan agen ke versi 3.x atau lebih baru.