Filter Cloud Trace

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, atau ns 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 sebagai label: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.