Dokumen ini menjelaskan cara mengonfigurasi filter saat Anda menggunakan metode list
Cloud Trace API atau saat membuat laporan analisis.
Filter memungkinkan Anda menentukan satu atau beberapa kondisi yang harus
terpenuhi agar rekaman aktivitas ditampilkan.
Halaman ini tidak berlaku untuk halaman Trace Explorer. Untuk memfilter data yang ditampilkan di halaman tersebut, gunakan filter standar, yang tercantum di panel Filter span, atau gunakan panel Filter. Untuk mengetahui informasi selengkapnya, lihat Menemukan dan menjelajahi rekaman aktivitas.
Ringkasan filter
Filter rekaman aktivitas terdiri dari urutan perbandingan yang disebut istilah. Trace harus
cocok dengan semua istilah dalam filter yang akan dipilih. Misalnya, filter berikut
mencocokkan trace yang memiliki latensi satu detik atau lebih, dan yang
berisi span bernama /modules.GetNumInstances
:
+span:/modules.GetNumInstances latency:1s
Semua perbandingan string peka huruf besar/kecil.
Atribut Boolean
Untuk menentukan nilai atribut Boolean, gunakan 0
untuk salah, dan 1
untuk benar. Misalnya,
Client:0
Karakter khusus
Untuk menelusuri nilai yang berisi spasi atau karakter titik dua (:
),
masukkan nilai dalam karakter tanda petik ganda ("
). Misalnya,
label:"Notice: This value contains spaces and a colon"
Untuk menelusuri karakter tanda kutip ganda atau karakter garis miring terbalik
(\
) dalam
string yang diapit tanda kutip, masukkan karakter dengan garis miring terbalik. Misalnya,
label:"Notice: This value contains spaces, a colon, a \"quote\", and a backslash (\\)"
Filter sintaksis
Di halaman ini, NAME
mengacu pada nama
kolom, sedangkan VALUE
mengacu pada nilai pasangan nilai kunci. String
_PREFIX
dan _EXACT
adalah indikasi visual apakah pengujian adalah
pengujian awalan atau pencocokan persis. Misalnya, root:[NAME_PREFIX]
berarti
nama span root harus diawali dengan [NAME_PREFIX]
.
Bagian lain dari halaman ini berisi deskripsi untuk filter saat menggunakan Cloud Trace API dan untuk Filter Permintaan di halaman Laporan Analisis.
Contoh filter permintaan
Berikut ini penjelasan istilah filter:
root:[NAME_PREFIX]
Nama span root rekaman aktivitas harus diawali dengan [NAME_PREFIX]. Misalnya, filter berikut cocok dengan rekaman aktivitas bernama
"/_ah/background"
, tetapi tidak cocok dengan rekaman aktivitas bernama"/_ahx/background"
:root:/_ah/
+root:[NAME]
Nama span root rekaman aktivitas harus persis [NAME]. Contoh:
+root:/_ah/background
[NAME_PREFIX]
Sintaksis ini adalah pintasan untuk
root:[NAME_PREFIX]
.+[NAME]
Sintaksis ini adalah pintasan untuk
+root:[NAME]
.span:[NAME_PREFIX]
Rekaman aktivitas harus memiliki minimal satu span yang namanya diawali dengan [NAME_PREFIX]. Contoh:
span:/modules.
+span:[NAME]
Rekaman aktivitas harus memiliki minimal satu span yang namanya persis [NAME]. Misalnya,
span:/modules.GetNumInstances
latency:[DURATION]
Rekaman aktivitas harus memiliki latensi keseluruhan yang lebih besar atau sama dengan [DURASI]. Durasi dinyatakan sebagai bilangan bulat yang diikuti dengan penentu unit:
s
untuk detik,ms
untuk milidetik, atauns
untuk nanodetik. Jika tidak ada penentu unit, unitnya adalah milidetik. Misalnya, empat durasi berikut sama:12s 12000ms 12000000ns 12000
label:[LABEL_KEY]
Rekaman aktivitas harus berisi kunci label yang ditentukan, persis. Nilai label (jika ada) tidak penting. Misalnya,
label:/http/url
[LABEL_KEY]:[VALUE_PREFIX]
Rekaman aktivitas harus berisi kunci label yang ditentukan, persis, dan nilai label harus diawali dengan [VALUE_PREFIX]. Misalnya, istilah berikut cocok dengan rekaman aktivitas yang versi App Engine-nya dimulai dengan
"2017"
.g.co/gae/app/module_version:2017
+[LABEL_KEY]:[VALUE_EXACT]
Rekaman aktivitas harus berisi kunci label dan nilai yang ditentukan, persis. Misalnya,
+g.co/gae/app/module_version:201750925t173233.387410594824284458
method:[VALUE_PREFIX]
Sintaksis ini adalah pintasan untuk pengujian label,
/http/method:[VALUE_PREFIX]
.+method:[VALUE_EXACT]
Sintaksis ini adalah pintasan untuk pengujian label,
+/http/method:[VALUE_EXACT]
.url:[VALUE_PREFIX]
Sintaksis ini adalah pintasan untuk pengujian label,
/http/url:[VALUE_PREFIX]
.+url:[VALUE_EXACT]
Sintaksis ini adalah pintasan untuk pengujian label,
+/http/url:[VALUE_EXACT]
.
Contoh penelusuran span root
Untuk membatasi istilah penelusuran hanya ke span root, tambahkan (^
) sebelum
istilah penelusuran dan setelah (+
) opsional.
Untuk kolom Filter di halaman Trace Explorer, jika Anda menambahkan
anotasi +^
, anotasi tersebut akan dikonversi menjadi ^+
saat Anda menekan Enter.
Berikut ini beberapa istilah penelusuran khusus span root dan kesamaannya:
^label:[LABEL_KEY]
- Ini adalah penelusuran span root untuk
label:[LABEL_KEY]
. ^[LABEL_KEY]:[VALUE_PREFIX]
- Ini adalah penelusuran span root untuk
[LABEL_KEY]:[VALUE_PREFIX]
. +^[LABEL_KEY]:[VALUE]
- Ini adalah penelusuran span root untuk
+[LABEL_KEY]:[VALUE]
. ^method:[VALUE_PREFIX]
- Ini adalah penelusuran span root untuk
method:[VALUE_PREFIX]
. +^method:[VALUE]
- Ini adalah penelusuran span root untuk
+method:[VALUE]
. ^url:[VALUE_PREFIX]
- Ini adalah penelusuran span root untuk
url:[VALUE_PREFIX]
. +^url:[VALUE]
- Ini adalah penelusuran span root untuk
+url:[VALUE]
. ^span:[NAME_PREFIX]
- Ini setara dengan
root:[NAME_PREFIX]
. +^span:[NAME]
- Ini setara dengan
+root:[NAME]
.
Dengan membuat kueri dengan istilah campuran, penelusuran dapat disesuaikan lebih lanjut. Misalnya,
+^url:/main /images method:200
cocok dengan rekaman aktivitas saat label span root /http/url
sama persis dengan "/main",
nama span root diawali dengan /images
, dan span apa pun memiliki
label /http/method
dengan nilai 200.
Pemecahan masalah
Bagian ini berisi konten pemecahan masalah.
Performa lambat
Jika filter rekaman aktivitas Anda rumit, waktu yang diperlukan untuk menjalankannya akan lebih lama dan dapat melampaui waktu tunggu. Untuk meningkatkan performa, sederhanakan filter.
Tidak ada hasil
Jika filter Anda tidak menampilkan pelacakan apa pun, periksa hal berikut:
Pastikan tidak ada spasi dalam filter, kecuali spasi yang memisahkan perbandingan.
Pastikan huruf besar dan kecil serta ejaan semua kata dalam filter sudah benar. Misalnya, jika Anda salah mengeja kata kunci seperti
method:GET
, filter akan ditafsirkan sebagailabel:method:GET
, yang tidak cocok dengan jejak apa pun.Untuk menguji istilah filter satu per satu, buka metode API
list
, lalu gunakan API Explorer. Jika salah satu istilah tidak menampilkan hasil, istilah tersebut mungkin menjadi alasan tidak ada data yang ditampilkan.API Explorer terbuka saat halaman menampilkan panel berjudul, Coba metode ini. Jika perlu, klik Coba, yang akan membuka APIs Explorer.