Menemukan dan menjelajahi trace

Untuk menemukan dan menjelajahi setiap rekaman aktivitas secara mendetail, gunakan halaman Trace Explorer. Halaman ini menampilkan rekaman aktivitas yang menyimpan setidaknya satu span di project Google Cloud Anda. Data yang ditampilkan untuk setiap rekaman aktivitas dan span yang ditampilkan mencakup informasi ringkasan, seperti latensi dan jenis perintah, serta informasi mendetail. Informasi mendetail mencakup log, peristiwa, dan informasi lainnya.

Halaman Trace Explorer menampilkan maksimal 1.000 rekaman aktivitas.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna melihat data rekaman aktivitas menggunakan konsol Google Cloud, minta administrator untuk memberi Anda peran IAM Cloud Trace User (roles/cloudtrace.user) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk informasi selengkapnya tentang peran, lihat Mengontrol akses dengan Identity and Access Management.

Menampilkan rekaman aktivitas terbaru

Untuk menampilkan rekaman aktivitas terbaru, lakukan tindakan berikut:

1. Di konsol Google Cloud, buka halaman Trace Explorer:

   Buka Trace Explorer

   Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.

   Jika ini pertama kalinya Anda menggunakan Trace, perlu waktu beberapa menit agar trace muncul. Screenshot berikut menunjukkan contoh halaman Trace Explorer:

   

   Scatter plot menampilkan titik untuk setiap permintaan dalam interval waktu yang dipilih:

   • Koordinat (x,y) untuk permintaan sesuai dengan waktu dan latensi permintaan.

   • Informasi error dienkode dalam warna titik. Biru menunjukkan keberhasilan dan merah menunjukkan kegagalan. Pada screenshot sebelumnya, sebagian besar perintah berhasil diselesaikan.

   • Tooltip yang diaktifkan saat Anda menahan pointer di atas titik, akan menampilkan tanggal, waktu, URI, dan latensi:

     

2. Opsional: Untuk memfilter rekaman aktivitas dan span yang ditampilkan, lakukan salah satu hal berikut:

   • Filter menurut waktu. Secara default, data satu jam terakhir akan ditampilkan. Untuk melihat interval waktu kustom, lakukan tindakan berikut:

     1. Pilih opsi preset yang lebih lama dari interval waktu kustom Anda.
     2. Letakkan kursor pada plot Pilih rekaman aktivitas di salah satu ujung interval waktu, lalu tarik kursor secara horizontal ke ujung lain interval.

     Untuk memulihkan grafik ke interval waktu preset, klik Reset.

   • Filter menurut latensi. Secara default, semua trace dalam interval waktu yang dipilih akan ditampilkan. Untuk membatasi tampilan ke rekaman aktivitas yang latensinya berada dalam interval, tempatkan kursor di salah satu ujung nilai latensi, lalu tarik kursor secara vertikal ke ujung lainnya.

     Untuk memulihkan grafik ke interval waktu preset, klik Reset.

   • Klik Add trace filter, pilih opsi filter, lalu pilih atau masukkan nilai filter. Jika Anda menambahkan beberapa filter, hanya rekaman aktivitas yang memenuhi semua filter yang akan ditampilkan. Misalnya, untuk menampilkan semua rekaman aktivitas yang berisi perintah HTTP GET dan latensinya minimal 2 detik, tambahkan filter Method: GET dan MinLatency: 2000.

     Opsi filter berikut selalu tersedia:

     • RootSpan: Mencocokkan nama span root.
     • SpanName: Mencocokkan nama span.
     • Metode: Menampilkan rekaman aktivitas yang span root-nya dianotasi dengan label /http/method, dengan nilai label yang cocok dengan nilai filter.
     • Status: Menampilkan rekaman aktivitas yang span root-nya dianotasi dengan label /http/status_code, dengan label nilai yang cocok dengan nilai filter. Nilai filter dapat berisi kode status tertentu, seperti 301, atau rentang nilai status, seperti 3xx.
     • MinLatency: Menampilkan rekaman aktivitas yang latensinya setidaknya sebesar nilai filter. Nilai filter harus dalam milidetik.
     • HasLabel: Menampilkan rekaman aktivitas tempat label yang ditentukan oleh nilai filter muncul di setidaknya satu span.

     • Layanan: Menampilkan rekaman aktivitas yang berisi setidaknya satu span yang namanya cocok dengan nilai filter.

       Nama layanan untuk span diekstrak dari atribut OpenTelemetry service.name, saat atribut tersebut ditetapkan. Jika atribut tersebut tidak ditetapkan dan jika layanan berjalan di App Engine, nama layanan App Engine akan ditampilkan. Jika tidak, layanan tidak ditentukan.

     • Version: (Khusus App Engine) Menampilkan rekaman aktivitas yang berisi setidaknya satu span yang versi aplikasinya cocok dengan nilai filter.

     Anda mungkin melihat opsi filter lain seperti label URL atau HTTP. Jika Anda memiliki label yang ditentukan pengguna yang cocok dengan filter standar, label yang ditentukan pengguna akan diawali dengan LABEL sehingga Anda dapat membedakan keduanya. Misalnya, jika membuat label Service, Anda akan melihat Layanan dan LABEL:Layanan di menu filter.

     Catatan: Untuk melakukan pencocokan persis, awali nilai filter dengan tanda plus (+). Jika Anda menghilangkan tanda plus, pencocokan akan ditentukan dengan melakukan pengujian awalan dengan nilai filter. Untuk mengetahui detail selengkapnya tentang opsi pemfilteran, lihat Filter rekaman aktivitas.

Menemukan rekaman aktivitas menurut ID

Saat memecahkan masalah insiden atau kegagalan, Anda mungkin mengetahui ID rekaman aktivitas. Untuk menjelajahi rekaman aktivitas tersebut, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Trace Explorer:

   Buka Trace Explorer

   Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.

2. Pilih project Google Cloud tempat data rekaman aktivitas akan dilihat.

   Anda harus memilih project Google Cloud yang menyimpan data rekaman aktivitas, kecuali jika project Anda adalah bagian dari organisasi. Jika project merupakan bagian dari organisasi, Anda dapat mengonfigurasi pelacakan lintas project, dan hal ini memungkinkan Anda melihat data rekaman aktivitas dari project mana pun dalam organisasi. Untuk mengetahui informasi selengkapnya, lihat Melihat rekaman aktivitas di seluruh project.

3. Masukkan ID di kolom Trace ID.

   Saat Anda memasukkan ID yang valid, panel Trace details akan diisi dengan informasi tentang trace dan span-nya. Anda dapat menggunakan opsi di panel tersebut untuk menjelajahi rekaman aktivitas.

Menjelajahi rekaman aktivitas

Untuk menjelajahi rekaman aktivitas, klik titik di diagram pencarahnya. Saat Anda mengklik titik di diagram sebar, perubahan berikut akan terjadi pada halaman Trace Explorer:

• Diagram pencar akan diperbarui dan titik yang Anda pilih akan ditandai dengan lingkaran yang digambar di sekeliling titik. Titik yang mewakili semua rekaman aktivitas lainnya akan disamarkan.

• Panel Detail rekaman aktivitas menampilkan hal berikut:

  • ID rekaman aktivitas. ID unik global untuk rekaman aktivitas ini adalah bilangan bulat 128-bit yang direpresentasikan sebagai string heksadesimal 32 byte. Untuk mengetahui detailnya, lihat Resource: Trace.

  • Baris ringkasan yang mencantumkan waktu mulai, durasi, dan jumlah rentang.

  • Menu Log & peristiwa. Pilihan menu mengontrol cara log dan peristiwa ditampilkan. Secara default, jika log atau peristiwa ada, lingkaran akan ditambahkan ke span rekaman aktivitas. Lingkaran yang tumpang-tindih menunjukkan bahwa span memiliki beberapa log atau peristiwa. Untuk menampilkan setiap log atau peristiwa sebagai baris dalam tabel, luaskan Logs & events dan pilih Show expanded.

  • Tabel. Baris pertama tabel adalah untuk rekaman aktivitas. Baris ditambahkan untuk setiap span dalam rekaman aktivitas.

    Untuk span, tabel mencantumkan nama span dan layanan yang terkait dengan span. Nama layanan diekstrak dari atribut OpenTelemetry service.name, saat atribut tersebut ditetapkan. Jika atribut tersebut tidak ditetapkan dan jika layanan berjalan di App Engine, nama layanan App Engine akan ditampilkan. Jika tidak, layanan tidak ditentukan.

    Kolom Latensi memberikan representasi visual latensi, status, dan, jika ada, anotasi peristiwa. Panel latensi biru menunjukkan penyelesaian yang berhasil, panel latensi merah menunjukkan terjadinya error. Setiap anotasi peristiwa dalam ruang direpresentasikan dengan lingkaran pada panel latensi.

Berikut adalah contoh panel Detail rekaman aktivitas:

Rentang penelusuran dalam rekaman aktivitas

Anda dapat menelusuri span dan atribut dalam rekaman aktivitas untuk menemukan kata kunci. Misalnya, dalam screenshot sebelumnya, beberapa span dan kunci atribut ditandai. Kolom ini ditandai karena cocok dengan istilah penelusuran, yaitu net.sock.peer.port.

Untuk menelusuri span dalam rekaman aktivitas, di toolbar panel Detail rekaman aktivitas, masukkan istilah penelusuran di kolom Temukan di Rekaman Aktivitas, lalu tekan Enter.

Trace kemudian menelusuri kolom tertentu dari setiap span dalam trace yang ditampilkan. Kecocokan terjadi saat kolom yang ditelusuri berisi istilah penelusuran, mengabaikan huruf besar/kecil. Kolom berikut akan ditelusuri:

• Nama span.
• Nama layanan.
• Kunci dan nilai atribut.

Setelah penelusuran selesai, panel Detail rekaman aktivitas akan dimuat ulang dan kolom yang cocok akan ditandai.

Misalnya, jika Anda memasukkan istilah get, span dengan atribut yang kuncinya adalah /http/method dan nilainya adalah GET akan ditandai. Selain itu, span dengan nama seperti CurrencyService/GetSupportedCurrencies akan ditandai.

Anda tidak dapat melakukan penelusuran menggunakan ekspresi reguler, dan Anda tidak dapat menelusuri log, peristiwa, atau metadata.

Melihat detail span

Catatan: Untuk meluaskan panel Detail trace guna mengisi halaman Trace Explorer, buka toolbar panel Detail trace, lalu klik Luaskan detail trace.

Untuk melihat informasi mendetail tentang rekaman aktivitas atau tentang span tertentu, di panel Trace details, klik panel latensi untuk entri. Saat Anda memilih panel latensi, panel Trace details akan digambar ulang dan menampilkan tabel dengan tab yang memberikan informasi tambahan tentang entri.

Jika Anda memilih batang latensi untuk baris pertama dalam tabel, baris dengan nama Trace ID, tabel akan berisi dua tab: Ringkasan dan Log. Tab Ringkasan mencantumkan informasi umum tentang rekaman aktivitas. Misalnya, untuk perintah HTTP, tab ini menampilkan jenis perintah HTTP, layanan, dan informasi latensi untuk setiap span dalam rekaman aktivitas.

Jika Anda memilih panel latensi untuk baris lain dalam tabel, yaitu baris untuk span, tabel akan berisi empat tab: Atribut, Log & peristiwa, Stacktrace, Metadata & Link:

• Untuk menemukan label yang terpasang ke span, lihat tab Atribut. Untuk mengetahui informasi tentang label, lihat Label rekaman aktivitas. Screenshot berikut mengilustrasikan tab ini:

  

  Untuk menemukan label atau grup label tertentu, tambahkan filter. Misalnya, jika Anda menambahkan filter Kunci: g.co, tabel akan mencantumkan semua label yang kunci labelnya berisi g.co.

• Untuk melihat informasi tentang entri dan peristiwa log terkait, jika ada, lihat tab Logs & events. Untuk informasi tentang anotasi peristiwa, lihat Menambahkan anotasi ke span rekaman aktivitas. Screenshot berikut mengilustrasikan tab ini:

  

  Jika data log tersedia, untuk melihat detail tentang entri log, klik Tampilkan lainnya:

  

• Untuk menemukan informasi tentang jumlah pelacakan tumpukan yang tersedia dan informasi mendetail tentang pelacakan tumpukan yang diambil, gunakan tab Stacktraces.

• Untuk menemukan informasi umum tentang span dan tabel link ke span lain, lihat tab Metadata & Links. Informasi ini mencakup hal berikut:

  • ID Span

    ID span adalah bilangan bulat 64-bit selain 0. Untuk mengetahui detailnya, lihat TraceSpan.

  • ID span induk

  • ID Project

  • Waktu mulai dan waktu berakhir

  • Tabel yang mencantumkan link ke span lain

    Setiap baris dalam tabel bernama Links mencantumkan link antara span saat ini dan span lain. Kolom Attributes mencantumkan key-value pair untuk span yang ditautkan. Kolom Trace ditautkan ke trace untuk span yang ditautkan. Jika kolom ini berisi Current trace, span yang ditautkan berada dalam rekaman aktivitas yang sama dengan span saat ini. Jika tidak, kolom akan berisi ID rekaman aktivitas. Untuk informasi tentang link, lihat halaman referensi API Links.

  Screenshot berikut mengilustrasikan tab ini:

  

Langkah selanjutnya

• Menambahkan anotasi peristiwa ke span rekaman aktivitas
• Melihat trace di seluruh project
• Membuat dan melihat laporan