Application Real-Time Monitoring Service (ARMS) menyediakan fitur Trace Explorer untuk menganalisis data jejak penuh yang tersimpan. Fitur ini memungkinkan Anda menggabungkan kondisi filter dan dimensi agregasi guna analisis real-time berdasarkan data jejak penuh yang tersimpan, sehingga memenuhi kebutuhan diagnostik kustom dalam berbagai skenario.
Prasyarat
ARMS agent telah diinstal untuk 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 Application List untuk melihat halaman detail aplikasi baru.
Prosedur
Di bilah navigasi atas, klik Trace Explorer.
Di sudut kanan atas halaman Trace Explorer, pilih rentang waktu yang ingin Anda kueri.
Tentukan kondisi filter.
Di bagian Quick Filter, kueri jejak berdasarkan status, durasi, nama aplikasi, nama span, atau alamat host.
Kondisi filter yang Anda tentukan ditampilkan di kotak pencarian.
Klik kotak pencarian di bagian atas. Di kotak dialog drop-down, konfigurasikan kondisi filter yang ada atau tambahkan kondisi filter kustom.
Di kotak pencarian, masukkan pernyataan kueri. Untuk informasi lebih lanjut tentang sintaksis, lihat Metode Penggunaan Trace Explorer.
CatatanAnda dapat mengklik ikon
di sebelah kotak pencarian untuk menyimpan kondisi filter saat ini.Anda dapat mengklik Saved View untuk melihat kondisi filter yang disimpan dan klik kondisi filter untuk melihat data jejak yang sesuai.
Anda dapat mengagregasi data yang dikueri berdasarkan dimensi tertentu.
Daftar jejak
Setelah menentukan kondisi filter, data jejak akan ditampilkan pada tab Trace Explorer. Data jejak mencakup jumlah panggilan dan jumlah kesalahan HTTP dalam diagram batang, durasi panggilan dalam kurva deret waktu, serta daftar span dan jejak.
Legenda:
Kode status HTTP dalam diagram batang di bagian atas halaman:
2XX (hijau)
3XX (kuning)
4XX (oranye)
5XX (merah)
Berasal dari bidang
attributes.http.status_codeatauattributes.http.response.status_code. Kode status HTTP menggantikan status span ketika kedua bidang tersebut ada.Bilah warna di sebelah kiri kolom TraceId dari daftar:
: statusCode=0
: statusCode=1
: statusCode=2
Indikator status span di kolom Status dari daftar:
: normalstatusCode=0(tidak dikonfigurasi)statusCode=1(normal)
: error (statusCode=2)
: pengecualian (dipicu ketika attributes.excep.idsberisi nilai)
Dalam daftar span dan jejak, Anda dapat melakukan tindakan berikut:
Klik ID jejak yang ingin Anda panggil atau klik Details di kolom Actions untuk melihat detail jejak dan tampilan topologinya. Untuk informasi lebih lanjut, lihat bagian Analisis Jejak Gagal dan Lambat.
Klik Logs di kolom Actions untuk melihat log jejak. Untuk informasi lebih lanjut, lihat Gunakan Fitur Analisis Log.
Klik ikon
untuk memperluas semua span di bawah ID jejak. Secara default, root span ditampilkan untuk setiap ID jejak dalam daftar jejak.Klik ikon
di sudut kanan atas untuk menambahkan atau menyembunyikan bidang daftar.Gerakkan pointer ke atas jejak dan klik ikon
untuk menambahkan nilai parameter saat ini sebagai kondisi filter.
Grafik sebaran
Di tab Scatter plot, titik-titik waktu didistribusikan di sepanjang sumbu X dan durasi didistribusikan di sepanjang sumbu Y. Anda dapat memindahkan pointer ke atas titik untuk melihat informasi dasar jejak, dan klik titik untuk melihat detail jejak.
Detail agregasi jejak
Trace Explorer memungkinkan Anda menganalisis span yang dikueri berdasarkan berbagai dimensi. Namun, Anda mungkin perlu menganalisis jejak yang terdiri dari sejumlah besar span. Fitur agregasi jejak memungkinkan Anda mengkueri hingga 5.000 jejak terdistribusi menggunakan kondisi tertentu dan mengkueri span yang sesuai berdasarkan ID jejak. Kemudian, Anda dapat mengagregasi span yang dikueri untuk mendapatkan hasilnya. Integritas jejak yang diagregasi dijamin dalam proses ini.
Saat menggunakan fitur agregasi jejak, perhatikan bahwa kueri agregat dilakukan pada data jejak berdasarkan kondisi yang ditentukan. Jika Anda menentukan beberapa kondisi kueri, perhitungan mungkin tidak selesai secara real-time. Kami sarankan Anda menunggu dengan sabar.
Parameter | Deskripsi |
spanName | Nama span. |
serviceName | Nama aplikasi yang sesuai dengan span. |
Jumlah permintaan/persentase permintaan | Rasio permintaan menunjukkan rasio permintaan yang memanggil span saat ini terhadap total jumlah permintaan. Contohnya, 10% menunjukkan bahwa 10% permintaan memanggil span saat ini. Rumus perhitungan: Rasio permintaan = Jumlah permintaan yang memanggil span saat ini/Total jumlah permintaan × 100% |
span/Request Multiple | Request multiple menunjukkan jumlah rata-rata kali span saat ini dipanggil oleh setiap permintaan. Contohnya, 1,5 menunjukkan bahwa span saat ini dipanggil 1,5 kali oleh setiap permintaan. Rumus perhitungan: Request multiple = Jumlah span/Jumlah permintaan |
Rata-rata konsumsi diri/prosentase | Durasi rata-rata span tidak termasuk durasi span anaknya. Contohnya, jika Span A membutuhkan 10 milidetik dan span anaknya (Span B) membutuhkan 8 milidetik, durasi rata-rata Span A adalah 2 milidetik. Rumus perhitungan: Durasi rata-rata span = Durasi span - Durasi semua span anak Penting Untuk panggilan asinkron, durasi rata-rata span mencakup durasi span anaknya. |
Durasi Rata-rata | Durasi rata-rata span. |
Jumlah pengecualian/persentase pengecualian | Rasio pengecualian menunjukkan rasio permintaan dengan pengecualian terhadap total jumlah permintaan. Contohnya, 3% menunjukkan bahwa pengecualian terjadi pada 3% permintaan. Rumus perhitungan: Jumlah permintaan dengan pengecualian/Total jumlah permintaan Penting Jumlah permintaan dengan pengecualian tidak sama dengan jumlah pengecualian. Jika request multiple lebih besar dari 1, satu permintaan mungkin memiliki beberapa pengecualian. |
Contoh: Span A memanggil Span B dan Span C. Tabel berikut menunjukkan parameter.
spanName | serviceName | Jumlah permintaan/persentase permintaan | span/Request Multiple | Rata-rata konsumsi diri/prosentase | Durasi Rata-rata | Jumlah pengecualian/persentase pengecualian | |
A | - | demo | 10/100,00% | 10/1,00 | 5,00ms/25,00% | 20ms | 2/20,00% |
- | B | demo | 4/40,00% | 8/2,00 | 16,00ms/100,00% | 16ms | 2/50,00% |
- | C | demo | 1/10,00% | 1/1,00 | 4,00ms/100,00% | 4ms | 1/100,00% |
Parameter Jumlah permintaan/persentase permintaan dari Span A menunjukkan bahwa jumlah total permintaan adalah 10 dan rasio permintaan adalah 100%. Parameter Jumlah permintaan/persentase permintaan dari Span B menunjukkan bahwa hanya 4 permintaan yang memanggil Span B. Demikian pula, hanya satu permintaan yang memanggil Span C. Rasio permintaan Span B adalah 40% dan rasio permintaan Span C adalah 10%. Permintaan lainnya tidak memanggil Span B dan Span C karena penilaian logis atau pengecualian. Ini mencerminkan distribusi permintaan.
Parameter span/Request Multiple dari Span A adalah 10/1,00, yang menunjukkan bahwa Span A hanya dipanggil sekali oleh setiap permintaan. Namun, untuk Span B, delapan span dipanggil oleh empat permintaan. Oleh karena itu, Span B dipanggil dua kali oleh setiap permintaan. Ini mencerminkan distribusi span dalam setiap permintaan.
Parameter Rata-rata konsumsi diri/prosentase dari Span A adalah 5,00 ms/25,00%, yang menunjukkan bahwa durasi rata-rata Span A (kecuali Span B dan Span C) adalah 5 milidetik. Durasi rata-rata Span A hanya mencakup 25% dari durasi rata-rata keseluruhan. Namun, durasi rata-rata Span B dan Span C sama dengan durasi rata-rata keseluruhan mereka karena Span B dan Span C tidak memiliki span anak. Ini mencerminkan distribusi durasi rata-rata.
Parameter Jumlah pengecualian/persentase pengecualian dari Span A adalah 2/20,00%, yang menunjukkan bahwa Span A memiliki dua pengecualian, mencakup 20% dari total jumlah permintaan. Parameter Jumlah pengecualian/persentase pengecualian dari Span B adalah 2/50,00%. Mengingat bahwa setiap permintaan memanggil Span B dua kali, jumlah total permintaan adalah 4, dan rasio pengecualian adalah 50%, dua permintaan memiliki pengecualian. Oleh karena itu, distribusi pengecualian di Span B mungkin: Dari total empat permintaan, dua permintaan berhasil. Dari dua permintaan yang tersisa, pengecualian terjadi pada pemanggilan pertama setiap permintaan sedangkan pemanggilan kedua berhasil.
Untuk melihat detail jejak tertentu, gerakkan pointer ke atas nama span biru. Anda dapat mengklik traceId yang direkomendasikan untuk melihat detailnya.
Topologi jejak
Tab Full Link Topology menampilkan topologi antar-aplikasi dari jejak yang diagregasi. Gambar berikut menunjukkan bahwa kedua aplikasi memiliki hubungan panggilan. Informasi berikut ditampilkan untuk setiap aplikasi: jumlah permintaan, jumlah kesalahan, dan waktu respons.
Analisis jejak gagal dan lambat
Analisis jejak gagal dan lambat membantu Anda menganalisis dimensi umum dari beberapa jejak gagal dan lambat. Jejak mungkin terkonsentrasi di satu host, atau milik satu antarmuka. Anda dapat mengkueri jejak berdasarkan host atau antarmuka, atau menggabungkan beberapa kondisi filter untuk mengkueri jejak dan menemukan masalah. Contoh: serviceName="arms-demo" AND ip="192.168.1.1". Analisis jejak gagal dan lambat juga dapat membantu Anda menyortir antarmuka lambat dan melakukan optimasi arah pada sistem.
Analisis jejak lambat
ARMS menganalisis 1.000 jejak dengan durasi terlama dan menampilkan lima dimensi yang paling terkait dengan jejak lambat.
Detail jejak lambat
ARMS memilih 1.000 jejak dengan durasi terlama dari jejak yang durasinya lebih besar dari threshold, mensampel 1.000 jejak yang durasinya kurang dari threshold, membandingkan jejak-jejak tersebut, dan kemudian menemukan tiga karakteristik yang paling terkait dengan panggilan lambat.
Anda dapat mengonfigurasi threshold berdasarkan kebutuhan bisnis Anda. Misalkan Anda ingin menemukan karakteristik jejak yang membutuhkan lebih dari 1 menit, Anda dapat mengatur threshold menjadi 60000 milidetik.
Analisis jejak gagal
ARMS secara acak memilih dan menganalisis 1.000 jejak gagal, dan menampilkan lima dimensi yang paling terkait dengan jejak tersebut.
Detail jejak gagal
ARMS membandingkan jejak gagal dengan jejak normal dan menemukan tiga karakteristik yang paling terkait dengan panggilan gagal.
Detail Jejak
Tag Komponen (bagian yang ditandai dengan nomor 1 pada gambar di atas)
Tag menunjukkan jenis panggilan dan jumlah span.
Jenis panggilan didefinisikan oleh bidang attributes.component.name.
Klik tag untuk menyembunyikan atau menampilkan span yang terkait dengan jenis panggilan.
Grafik Batang Horizontal Jejak (bagian yang ditandai dengan nomor 2 pada gambar di atas)
Grafik batang menunjukkan seluruh jejak dan distribusi span.
Setiap batang mewakili sebuah span. Hanya span dengan durasi lebih dari 1% dari durasi total yang ditampilkan.
Warna berbeda mewakili aplikasi yang berbeda. Seperti yang ditunjukkan pada gambar di atas, warna biru mewakili aplikasi opentelemetry-demo-adservice.
Panjang garis hitam pada grafik mewakili waktu mandiri sebuah span, yaitu total waktu span dikurangi waktu yang dihabiskan di span anaknya. Misalkan Span A memanggil Span B. Span A membutuhkan 10 milidetik dan Span B membutuhkan 8 milidetik. Dalam hal ini, Span A membutuhkan 2 milidetik.
Garis waktu mewakili rentang waktu jejak.
Fokus dan Penyaringan Jejak (bagian yang ditandai dengan nomor 3 pada gambar di atas)
Setiap baris di bagian ini mewakili sebuah span dan menunjukkan hubungan hierarki antara span induk dan span anak. Setiap span induk didahului oleh angka, yang menunjukkan jumlah span anak yang dimiliki oleh span induk. Di bagian ini, Anda dapat melakukan operasi berikut:
Collapse: Klik ikon
untuk melipat atau memperluas sebuah span.Fokus: Pilih sebuah span dan klik ikon
. Sistem hanya menampilkan data span dan data hilirnya.Defokus: Klik ikon
untuk menghilangkan fokus pada sebuah span.Filter: Masukkan informasi span di kotak pencarian, seperti nama span, nama aplikasi, atau atribut untuk melihat data jejak mulai dari span hingga span entri. Untuk membatalkan penyaringan, hapus informasi yang dimasukkan dari kotak pencarian dan klik ikon Pencarian.
Perbesar dan Perkecil: Klik ikon
untuk memperbesar jejak dan menyembunyikan grafik batang. Klik ikon 
untuk menampilkan grafik batang.
Detail Span (bagian yang ditandai dengan nomor 4 pada gambar di atas)
Bagian Detail Span menyediakan detail span saat ini, serta data metrik, log, dan informasi pengecualian yang relevan. Anda juga dapat mengelola acara interaksi kustom dan mengonfigurasi pemicuan untuk acara interaksi.
Informasi Tambahan: menampilkan atribut, sumber daya, detail, dan acara span. Informasi tambahan dikelompokkan berdasarkan tipe. Untuk informasi tentang bidang dalam detail span, lihat Parameter Trace Explorer.
Metrik: menampilkan metrik yang terkait dengan span. Untuk jejak aplikasi Java yang dipantau di ARMS, metrik tentang JVM dan host ditampilkan. Untuk jejak yang dilaporkan oleh agen open source, metrik yang didefinisikan oleh RED Method, termasuk laju, kesalahan, dan durasi, ditampilkan.
Log: menampilkan log bisnis yang terkait dengan jejak. Jika Anda telah mengonfigurasi Simple Log Service (SLS) Logstore untuk aplikasi, Anda dapat pergi ke Logstore dan mengkueri log bisnis berdasarkan ID jejak.
Pengecualian: menampilkan informasi pengecualian yang terkait dengan span, jika ada.
Konfigurasi Acara: memungkinkan Anda mengonfigurasi acara interaksi untuk satu atau beberapa atribut jejak. Dengan cara ini, Anda dapat mengkueri lebih banyak detail tentang jejak atau melihat log dan metrik yang terkait dengan jejak. Untuk informasi tentang cara mengonfigurasi acara interaksi kustom, lihat Konfigurasikan Acara Interaksi Kustom untuk Jejak.
Pengembangan Kustom
Data jejak disimpan di SLS. Nama proyek adalah proj-xtrace-<encode>-<region-id>. Nama Logstore adalah logstore-tracing. Parameter region-id adalah wilayah tempat Anda menggunakan Trace Explorer, misalnya, cn-hangzhou. Untuk informasi tentang format data, lihat Parameter Trace Explorer. Anda dapat melakukan pengembangan kustom pada data jejak penuh yang tersimpan. Anda dapat menganalisis data jejak penuh yang tersimpan berdasarkan kondisi filter atau dimensi agregasi. Dengan cara ini, kebutuhan diagnostik kustom dalam berbagai skenario dapat dipenuhi. Untuk informasi lebih lanjut, lihat Analisis Data Jejak secara Real-Time Menggunakan Trace Explorer.
Referensi
FAQ
Mengapa pernyataan SQL dipotong dalam jejak?
Secara default, ARMS membatasi pernyataan SQL hingga 1.024 karakter. Anda dapat mengubah nilai Maximum retention length for SQL collection di bagian Database call configuration pada tab Custom Configurations aplikasi Anda.
Mengapa saya melihat banyak span dengan durasi panggilan Nacos 30 detik atau lebih setelah ARMS agent saya diperbarui ke V4.x?
ARMS agent 4.x menginstrumentasi permintaan HTTP long polling yang diinisiasi oleh Nacos untuk pembaruan konfigurasi dan penemuan layanan. Namun, span-span ini tidak ditangkap di V3.x. Untuk informasi lebih lanjut, lihat [Pengumuman] Pembaruan ARMS Agent V4.x.
Untuk mengabaikan span-span ini, saring mereka di bagian Interface call configuration pada tab Custom Configurations aplikasi Anda.
Fitur ini hanya tersedia di ARMS agent V4.2.x dan versi lebih baru.
