Menemukan dan menjelajahi trace

Untuk menemukan dan menjelajahi setiap rekaman aktivitas secara mendetail, gunakan halaman Trace Explorer. Halaman ini menampilkan trace yang project Google Cloud Anda menyimpan setidaknya satu span. Data yang ditampilkan untuk setiap trace 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 untuk melihat data trace dengan menggunakan Konsol Google Cloud, minta administrator Anda 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.

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

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

Menampilkan rekaman aktivitas terbaru

Untuk menampilkan rekaman aktivitas terbaru, lakukan hal berikut:

1. Di panel navigasi konsol Google Cloud, pilih Trace, lalu pilih Trace explorer:

   Buka Trace explorer

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

   

   Diagram sebar menampilkan titik untuk setiap permintaan dalam interval waktu yang dipilih:

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

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

   • Tooltip yang aktif saat Anda mengarahkan kursor ke titik, akan menampilkan tanggal, waktu, URI, dan latensi:

     

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

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

     1. Pilih opsi preset yang lebih lama dari interval waktu kustom Anda.
     2. Tempatkan kursor pada plot Select a trace di salah satu ujung interval waktu, lalu tarik pointer secara horizontal ke ujung interval lainnya.

     Untuk memulihkan grafik ke interval waktu preset, klik Reset.

   • Filter berdasarkan latensi. Secara default, semua rekaman aktivitas 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 pointer secara vertikal ke ujung lainnya.

     Untuk memulihkan grafik ke interval waktu preset, klik Reset.

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

     Opsi filter berikut selalu tersedia:

     • RootSpan: Mencocokkan nama span root.
     • SpanName: Mencocokkan nama span.
     • Method: Menampilkan trace 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 trace yang latensinya setidaknya sebesar nilai filter. Nilai filter harus dalam milidetik.
     • HasLabel: Menampilkan rekaman aktivitas dengan label yang ditentukan oleh nilai filter muncul setidaknya dalam satu span.

     • Layanan: Menampilkan trace yang berisi setidaknya satu span yang nama layanannya cocok dengan nilai filter.

       Nama layanan untuk span diekstrak dari atribut OpenTelemetry service.name, jika 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 akan ditetapkan.

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

     Anda mungkin melihat opsi filter lain seperti label URL atau HTTP. Jika Anda memiliki label buatan 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 Service dan LABEL:Service di menu filter.

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

Menemukan rekaman aktivitas berdasarkan ID

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

1. Di panel navigasi konsol Google Cloud, pilih Trace, lalu pilih Trace explorer:

   Buka Trace explorer

2. Pilih project Google Cloud tempat Anda ingin melihat data trace.

   Anda harus memilih project Google Cloud yang menyimpan data trace, kecuali jika project Anda merupakan bagian dari organisasi. Jika project adalah bagian dari organisasi, Anda dapat mengonfigurasi pelacakan lintas project, dan tindakan tersebut memungkinkan Anda melihat data rekaman aktivitas dari project mana pun di organisasi tersebut. Untuk mengetahui informasi selengkapnya, baca 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 spannya. Anda dapat menggunakan opsi di panel tersebut untuk menjelajahi rekaman aktivitas.

Menjelajahi rekaman aktivitas

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

• Diagram sebar dimuat ulang dan titik yang Anda pilih ditandai dengan lingkaran yang digambar di sekitar titik. Titik-titik yang mewakili semua rekaman aktivitas lainnya diredupkan.

• Panel Trace details menampilkan hal berikut:

  • ID rekaman aktivitas. ID unik global untuk pelacakan 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 span.

  • Menu Log & peristiwa. Pemilihan menu mengontrol cara log dan peristiwa ditampilkan. Secara default, jika ada log atau peristiwa, 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, lalu pilih Show extended.

  • Tabel. Baris pertama pada tabel adalah untuk pelacakan. Sebuah baris akan ditambahkan untuk setiap span dalam trace.

    Untuk span, tabel mencantumkan nama span dan layanan yang terkait dengan span. Nama layanan diekstrak dari atribut OpenTelemetry service.name, jika 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 akan ditetapkan.

    Kolom Latensi memberikan representasi visual dari latensi, status, dan anotasi peristiwa, jika ada. Batang latensi biru menunjukkan keberhasilan penyelesaian, batang latensi merah menunjukkan error yang terjadi. Setiap anotasi peristiwa dalam ruang direpresentasikan dengan lingkaran pada status latensi.

Berikut ini mengilustrasikan contoh panel Detail rekaman aktivitas:

Lihat detail span

Catatan: Untuk memperluas panel Trace details untuk mengisi halaman Trace Explorer, buka toolbar di panel Trace details, lalu klik Expand trace details.

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

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

Jika Anda memilih batang latensi untuk baris lain dalam tabel, yaitu baris untuk span, tabel akan berisi empat tab: Attributes, Logs & events, Stacktraces, Metadata & Links:

• Untuk menemukan label yang dilampirkan pada span, lihat tab Attributes. Untuk mengetahui informasi tentang label, lihat Label rekaman aktivitas. Screenshot berikut menggambarkan tab ini:

  

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

• Untuk melihat informasi tentang entri dan peristiwa log terkait, jika ada, lihat tab Logs & peristiwa. Untuk mengetahui informasi tentang anotasi peristiwa, lihat Menganotasi span rekaman aktivitas. Screenshot berikut menggambarkan tab ini:

  

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

  

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

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

  • ID Span

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

  • ID span induk

  • Project ID

  • Waktu mulai dan waktu berakhir

  • Tabel yang mencantumkan link ke span lain

    Setiap baris dalam tabel yang bernama Links mencantumkan link antara span saat ini dan span lainnya. Kolom Attributes mencantumkan key-value pair untuk span yang ditautkan. Kolom Trace ditautkan ke rekaman aktivitas untuk span yang ditautkan-ke. Jika kolom ini berisi Pelacakan saat ini, span yang ditautkan ke akan berada dalam pelacakan 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 menggambarkan tab ini:

  

Langkah selanjutnya

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