Menemukan dan menjelajahi trace

Untuk melihat representasi gabungan data rekaman aktivitas Anda, atau untuk menemukan dan menjelajahi setiap rekaman aktivitas atau rekaman aktivitas yang berisi label tertentu, gunakan halaman Trace Explorer.

Fitur ini hanya didukung untuk project Google Cloud.

Tentang halaman Trace Explorer

Untuk membantu Anda mengidentifikasi tren dan pola dalam data rekaman aktivitas, data latensi digabungkan dan ditampilkan dalam diagram. Peta panas, yang merupakan visualisasi default, menggunakan warna untuk merepresentasikan jumlah span dalam sel. Sel dengan banyak span ditampilkan dengan warna yang lebih gelap daripada sel dengan sedikit span. Anda dapat memilih sel atau mengaktifkan tooltip sel untuk mendapatkan informasi selengkapnya. Visualisasi lainnya memungkinkan Anda melihat latensi sebagai informasi persentil dan rasio rentang. Untuk semua visualisasi, Anda dapat menggunakan kursor untuk memperluas sumbu x. Untuk diagram garis, Anda dapat meluaskan sumbu x dan y.

Saat menyelidiki masalah, Anda mungkin ingin melihat rekaman aktivitas tertentu atau hanya span dengan properti tertentu:

  • Jika Anda mengetahui ID rekaman aktivitas, di toolbar, klik Telusuri rekaman aktivitas, lalu masukkan ID rekaman aktivitas di dialog. Selanjutnya, Anda dapat menelusuri span dan atribut dalam rekaman aktivitas untuk menemukan kata kunci .

  • Saat melihat data gabungan, Anda dapat menelusuri span tertentu dengan menerapkan filter. Misalnya, Anda dapat memfilter data agar hanya menampilkan span tersebut untuk layanan tertentu. Selanjutnya, Anda dapat menambahkan filter kedua yang membatasi tampilan ke span untuk layanan tertentu yang melaporkan error.

Data tabel memungkinkan Anda melihat detail setiap span dan membantu Anda mengidentifikasi pencilan. Misalnya, untuk menemukan span dengan nilai latensi tertinggi, pilih tab Span, lalu urutkan data menurut latensi. Untuk menemukan layanan yang menghasilkan error, filter data menurut status span, lalu pilih tab Dikelompokkan, yang menampilkan data yang telah digabungkan menurut span dan nama layanan. Setiap baris dalam tabel berisi link ke informasi mendetail.

Data rekaman aktivitas yang ditampilkan oleh halaman Penjelajah Rekaman Aktivitas bergantung pada hal berikut:

  • Project menelusuri data rekaman aktivitas. Secara default, hanya project yang dipilih oleh pemilih project yang akan ditelusuri data rekamannya. Namun, Anda dapat mengonfigurasi halaman untuk menelusuri daftar project dalam cakupan rekaman aktivitas.
  • Izin Identity and Access Management (IAM) Anda di project yang ditelusuri. Jika Anda tidak memiliki izin untuk melihat data rekaman aktivitas untuk suatu project, konsol Google Cloud akan menampilkan pesan peringatan dan data dari project tersebut tidak akan ditampilkan.
  • Setelan rentang waktu.
  • Filter yang Anda terapkan.

Bagian selanjutnya di halaman ini memberikan informasi selengkapnya tentang cara menemukan dan menjelajahi data rekaman aktivitas Anda.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna melihat data rekaman aktivitas menggunakan konsol Google Cloud dan untuk memilih cakupan rekaman aktivitas, 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.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk melihat data rekaman aktivitas menggunakan konsol Google Cloud dan untuk memilih cakupan rekaman aktivitas. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat data rekaman aktivitas menggunakan konsol Google Cloud dan untuk memilih cakupan rekaman aktivitas:

  • Untuk memilih cakupan rekaman aktivitas: cloudtrace.traceScopes.[get, list]
  • Untuk membaca cakupan rekaman aktivitas default: observability.scopes.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

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

Melihat data rekaman aktivitas gabungan

Untuk melihat informasi gabungan tentang data rekaman aktivitas Anda, lakukan langkah berikut:

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

    Buka Trace Explorer

    Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.

    Mungkin perlu waktu beberapa menit setelah data rekaman aktivitas pertama ditulis ke project Google Cloud sebelum data tersebut tersedia untuk dilihat. Jika Anda tidak melihat data rekaman aktivitas yang ditampilkan setelah menunggu beberapa menit, project Anda mungkin tidak memiliki data untuk ditampilkan atau mungkin ada masalah konfigurasi. Untuk mengetahui informasi tentang cara menyelesaikan masalah ini, lihat Memecahkan masalah: Tidak ada data di antarmuka Trace.

  2. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. Opsional: Konfigurasikan project yang akan ditelusuri untuk data rekaman aktivitas menggunakan elemen Cakupan:

    • Untuk menampilkan data rekaman aktivitas yang disimpan dalam project Anda, tetapkan menu pertama elemen Cakupan ke Project atau ke _Default. Kedua setelan ini setara.

    • Untuk menampilkan data rekaman aktivitas yang disimpan di beberapa project, luaskan menu pertama elemen Cakupan, pilih Cakupan rekaman aktivitas, lalu pilih cakupan rekaman aktivitas yang mencantumkan project tersebut. Setelah Anda membuat pilihan, menu Cakupan akan menampilkan ikon cakupan rekaman aktivitas, , dan nama cakupan rekaman aktivitas yang dipilih.

    Data yang ditampilkan bergantung pada peran IAM Anda pada project yang ditelusuri. Misalnya, project yang ditelusuri menyertakan project Google Cloud yang tidak dapat Anda akses, sehingga tidak ada data rekaman aktivitas untuk project tersebut yang ditampilkan.

    Untuk informasi selengkapnya, lihat Membuat dan mengelola cakupan rekaman aktivitas.

  4. Opsional: Perbarui rentang waktu menggunakan pemilih rentang waktu atau dengan menggunakan kursor untuk menandai rentang pada sumbu x.

  5. Jelajahi diagram, yang menampilkan pola dan tren dalam data rekaman aktivitas Anda:

    • Untuk mendapatkan informasi tentang data latensi span, tetapkan menu Tampilan diagram ke Durasi span (peta panas). Intensitas warna sebanding dengan jumlah span. Untuk mengetahui informasi tentang sel, gunakan kursor Anda. Tooltip menampilkan jumlah span, tanggal dan waktu, serta interval waktu sel.

    • Untuk melihat tren latensi, tetapkan menu Tampilan diagram ke Durasi span (persentil). Diagram durasi menampilkan persentil ke-50, ke-90, ke-95, dan ke-99.

    • Untuk melihat status respons sebagai fungsi waktu, tetapkan menu Tampilan diagram ke Rasio span. Diagram menampilkan rasio span yang dikirim ke project Anda.

  6. Jelajahi data tabel yang mencantumkan setiap span di tab Span dan span yang dikelompokkan menurut layanan dan namanya di tab Dikelompokkan.

    Setiap baris dalam tabel menampilkan span atau pengelompokan, beserta link ke informasi mendetail dan beberapa metrik. Misalnya, di tab Dikelompokkan, metrik mencakup tingkat error dan jumlah span dalam grup.

    Untuk menemukan outlier, pilih header kolom untuk mengurutkan tabel.

  7. Tambahkan filter untuk membatasi span yang ditampilkan. Misalnya, Anda dapat memfilter berdasarkan nama layanan dan status. Saat Anda menambahkan atau menghapus filter, data yang ditampilkan oleh halaman Trace Explorer akan diperbarui dan hanya menampilkan span yang cocok dengan semua filter yang diterapkan.

    Untuk mengubah setelan filter, lakukan salah satu tindakan berikut:

    • Buka panel Filter span, lalu pilih filter yang akan diterapkan.

      Panel Filter span hanya mencantumkan filter yang paling umum. Jika Anda ingin memfilter menurut atribut yang tidak tercantum, gunakan panel Filter.

    • Untuk menambahkan filter menggunakan panel Filter, pilih Tambahkan filter, lalu selesaikan dialog.

      Untuk memfilter menurut atribut yang tidak tercantum di menu opsi, pilih Tambahkan filter atribut, lalu tambahkan kunci dan nilai kustom Anda. Misalnya, jika Anda menetapkan kunci ke /http/status_code dan nilai ke 200, filternya adalah /http/status_code: 200. Agar filter cocok dengan nilai apa pun, pilih Nilai apa pun.

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. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. Buka toolbar, klik Telusuri rekaman aktivitas, lalu masukkan ID rekaman aktivitas.

    Saat Anda memasukkan ID yang valid, flyout Details akan terbuka dan menampilkan informasi tentang rekaman aktivitas dan span-nya. Anda dapat menggunakan opsi di panel tersebut untuk menjelajahi rekaman aktivitas. Misalnya, Anda dapat menelusuri span untuk kata kunci.

Menjelajahi rekaman aktivitas

Untuk melihat rekaman aktivitas atau span, lakukan tindakan berikut:

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

    Buka Trace Explorer

    Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.

    Mungkin perlu waktu beberapa menit setelah data rekaman aktivitas pertama ditulis ke project Google Cloud sebelum data tersebut tersedia untuk dilihat. Jika Anda tidak melihat data rekaman aktivitas yang ditampilkan setelah menunggu beberapa menit, project Anda mungkin tidak memiliki data untuk ditampilkan atau mungkin ada masalah konfigurasi. Untuk mengetahui informasi tentang cara menyelesaikan masalah ini, lihat Memecahkan masalah: Tidak ada data di antarmuka Trace.

  2. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. Lakukan salah satu hal berikut:

    • Buka bagian tabel di halaman Trace Explorer dan pilih entri dari tabel yang mencantumkan span atau mencantumkan informasi ringkasan setelah mengelompokkan data menurut layanan dan nama span.

    • Buka toolbar halaman Trace Explorer, klik Search for trace, dan masukkan trace ID.

    Flyout Details akan terbuka dan menampilkan rekaman aktivitas serta span-nya:

    • Kolom Name menampilkan hierarki panggilan dan entri pertama menyertakan ID rekaman aktivitas.
    • Kolom 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, tidak ada layanan yang ditentukan.
    • Panjang batang latensi mewakili nilai latensi.
    • Warna batang latensi menunjukkan status. Panel latensi biru menunjukkan penyelesaian yang berhasil, sedangkan panel latensi merah menunjukkan terjadinya error.
    • Lingkaran pada batang latensi menunjukkan entri log atau peristiwa yang terkait dengan rentang. Untuk mengubah perilaku ini, gunakan menu Log & peristiwa.

  4. Opsional: Telusuri nama span, nama layanan, dan atribut dalam rekaman aktivitas menggunakan kolom Find in Trace.

    Misalnya, jika Anda memasukkan GET, teks dalam nama span, nama layanan, atau di panel Attributes yang menampilkan GET, mengabaikan huruf besar/kecil, akan ditandai.

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

  5. Untuk melihat detail span tertentu, pilih span, lalu lihat atribut dan peristiwanya. Lihat bagian berikutnya untuk mengetahui informasi selengkapnya.

Melihat atribut dan peristiwa

Bagian ini menjelaskan cara melihat label, log, dan peristiwa.

Melihat label

Untuk melihat label yang dilampirkan ke span, buka tab Attributes. Untuk informasi tentang label, lihat Melacak label.

Melihat log dan peristiwa

Untuk melihat log dan peristiwa yang terkait dengan span, buka tab Logs & Events. Untuk informasi tentang anotasi peristiwa, lihat Menambahkan anotasi ke span rekaman aktivitas.

Untuk melihat entri log, klik Tampilkan lainnya.

Anda juga dapat memilih tombol Lihat log, yang akan membuka halaman Logs Explorer dengan kueri yang ditetapkan untuk memfilter ke rekaman aktivitas, rentang, dan rentang waktu tertentu. Kueri ini mungkin tidak menampilkan entri log apa pun.

Melihat peristiwa AI generatif

Untuk melihat peristiwa yang terkait dengan agen AI generatif, gunakan tab GenAI. Tab ini tersedia jika span yang dikirim ke Trace mengikuti Konvensi Semantik OpenTelemetry untuk sistem AI Generatif, yang menghasilkan pesan yang namanya diawali dengan gen_ai.

Atribut adalah pasangan nilai kunci yang mendeskripsikan beberapa karakteristik. Berikut adalah contoh atribut dari sistem AI generatif:

  • gen_ai.system: Mengidentifikasi sistem yang menyediakan kemampuan AI generatif.
  • gen_ai.request.model: Mengidentifikasi model tempat permintaan dikirim.

Peristiwa yang namanya diawali dengan "gen_ai" biasanya menjelaskan setiap input atau output dari sistem AI generatif. Input dan output ini mencakup perintah sistem dan pengguna, input dan output alat, serta respons model. Berikut adalah contoh peristiwa dari sistem AI generatif:

  • gen_ai.system.message: Peristiwa yang merekam perintah sistem yang dikirim ke model AI generatif. Perintah sistem memberikan petunjuk ke model yang biasanya tidak dilihat oleh pengguna akhir dan yang memandu interpretasi model terhadap perintah pengguna.
  • gen_ai.user.message: Peristiwa yang merekam perintah yang disediakan pengguna yang dikirim ke model.
  • gen_ai.assistant.message: Peristiwa yang merekam output model, yang dapat mencakup catatan pemanggilan alat atau yang mungkin berisi output respons tekstual. Pesan mungkin menyertakan respons kandidat yang tidak digunakan oleh aplikasi.
  • gen_ai.choice: Peristiwa yang digunakan untuk melaporkan output kandidat yang digunakan oleh aplikasi.

Melihat pelacakan tumpukan

Untuk melihat stacktrace, gunakan tab Stacktrace.

Melihat informasi umum dan metadata lainnya

Untuk menemukan informasi umum tentang span dan tabel link ke span lainnya, 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 ini berisi ID rekaman aktivitas. Untuk informasi tentang link, lihat halaman referensi API Links.

Langkah berikutnya