Trace Explorer menyediakan tiga metode untuk melakukan kueri jejak: bilah pencarian untuk kueri berbasis ekspresi, panel filter untuk pemfilteran terstruktur, dan panel Quick Filter untuk dimensi umum. Gabungkan metode-metode ini untuk menemukan jejak tertentu.
Trace Explorer menggunakan sintaks kueri Simple Log Service (SLS). Jika Anda telah menggunakan SLS, ekspresi kueri yang sama juga berlaku di sini. Pernyataan analisis tidak didukung.
Untuk daftar lengkap bidang yang dapat dicari, lihat Parameter Trace Explorer.
Bilah pencarian
Masukkan ekspresi kueri secara langsung di bilah pencarian pada halaman Trace Explorer.
Sintaks kueri
Buat ekspresi menggunakan nama bidang, operator, dan nilai. Gabungkan beberapa kondisi dengan and atau or.
Format dasar: <field> <operator> <value>
Contoh: serviceName : "my-service" and duration >= 1000000000
Nilai durasi
Durasi ditentukan dalam nanodetik. Gunakan tabel konversi berikut untuk mengatur nilai dengan benar:
| Duration | Nanoseconds |
|---|---|
| 1 ms | 1.000.000 |
| 10 ms | 10.000.000 |
| 100 ms | 100.000.000 |
| 500 ms | 500.000.000 |
| 1 s | 1.000.000.000 |
| 5 s | 5.000.000.000 |
Contoh:
Jejak lebih lama dari 500 ms:
duration >= 500000000Jejak antara 0 dan 500 ms (interval tertutup-kiri, terbuka-kanan):
duration in (0 500000000)
Bidang atribut dan resource
Untuk melakukan kueri bidang di bawah Attributes atau Resources, tambahkan awalan nama bidang dengan attributes. atau resources..
attributes.http.status_code : 500resources.service.namespace : "production"
Bidang tingkat atas seperti serviceName, spanName, dan duration tidak memerlukan awalan.
Pencarian wildcard
Untuk menggunakan karakter wildcard * dan ? dalam ekspresi, aktifkan opsi Allow Fuzzy Search.
Contoh kueri
| Skenario | Ekspresi |
|---|---|
| Error HTTP 500 pada titik akhir tertentu | spanName : "/components/api/v1/ads/data" and attributes.http.status_code : 500 |
| Pengecualian dari layanan tertentu | serviceName : "opentelemetry-demo-adservice" and attributes.excep.ids : * |
| Jejak lebih lama dari 1 s dari layanan tertentu | serviceName : "my-service" and duration >= 1000000000 |
| Jejak lambat pada titik akhir tertentu | spanName : "/api/checkout" and duration >= 500000000 |
Panel filter
Klik bilah pencarian pada halaman Trace Explorer untuk membuka panel filter drop-down. Buat kueri tanpa menulis ekspresi secara manual.
Operator filter
Pilih kondisi filter dari daftar drop-down, lalu pilih operator dan tentukan nilai.
| Operator | Tujuan | Contoh |
|---|---|---|
| oneOf | Cocokkan dengan salah satu nilai yang ditentukan | Status adalah salah satu dari 200, 201, 204 |
| not oneOf | Kecualikan nilai-nilai yang ditentukan | Status bukan 500, 502, 503 |
Filter atribut dan resource kustom
Klik + Add Query Condition untuk memfilter berdasarkan bidang Attributes atau Resources yang tidak tersedia dalam daftar default.
Nilai durasi pada panel filter juga menggunakan nanodetik.
Panel filter cepat
Panel Quick Filter di sisi kiri halaman Trace Explorer menyediakan pemfilteran sekali klik:
| Dimensi | Deskripsi |
|---|---|
| Status | Filter berdasarkan status jejak. Atur nilainya ke Error untuk menampilkan hanya jejak error. |
| Duration | Filter berdasarkan rentang waktu respons. |
| Application name | Persempit hasil ke aplikasi tertentu. |
| Span name | Filter berdasarkan nama operasi atau titik akhir. |
| Host address | Filter berdasarkan host tempat span direkam. |
Pilih nilai pada satu dimensi untuk mempersempit hasil, lalu terapkan dimensi tambahan untuk pemfilteran multi-level. Hasil diperbarui secara real time.
Topik terkait
Trace Explorer — Lihat dan analisis hasil kueri.
Parameter Trace Explorer — Referensi lengkap bidang untuk ekspresi kueri.
Sintaks kueri SLS — Referensi lengkap operator dan sintaks.