Menemukan dan menjelajahi trace

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

Screenshot berikut menggambarkan cara data rekaman aktivitas ditampilkan:

Untuk menjalankan kueri yang melakukan analisis gabungan rentang, gunakan halaman Observability Analytics atau BigQuery. Kedua antarmuka mendukung pembuatan kueri data rentang menggunakan SQL. Saat menggunakan halaman Observability Analytics, Anda dapat melihat hasil kueri sebagai tabel atau diagram. Untuk mempelajari lebih lanjut cara menggunakan SQL untuk membuat kueri data rekaman aktivitas, lihat Membuat kueri dan menganalisis rekaman aktivitas.

Fitur ini hanya didukung untuk Google Cloud project. Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.

Tentang halaman Trace Explorer

Untuk membantu Anda mengidentifikasi tren dan pola dalam data rekaman aktivitas, data latensi digabungkan dan ditampilkan dalam diagram. Peta panas menggunakan warna untuk merepresentasikan jumlah rentang dalam sel. Sel dengan banyak rentang memiliki warna yang lebih gelap daripada sel dengan sedikit rentang. Tooltip setiap sel menampilkan latensi dan informasi lainnya. Anda juga dapat melihat persentil latensi dan informasi kecepatan rentang.

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

• Untuk membatasi rentang yang ditampilkan, terapkan filter. Misalnya, Anda dapat memfilter menurut layanan, aplikasi, status error, dan properti lainnya.

• Untuk menampilkan jejak tertentu, gunakan toolbar klik opsi tayangan halaman Cari jejak.

Untuk mengidentifikasi pencilan dan melihat detail setiap rentang, gunakan bagian tabular:

• Anda dapat mengurutkan baris tab Rentang dan Dikelompokkan menurut header durasi.

• Untuk memahami jumlah rentang yang dihasilkan oleh berbagai layanan, gunakan tab Dikelompokkan. Setiap baris sesuai dengan nama layanan dan rentang, dan untuk setiap entri, statistik latensi ditampilkan.

Untuk menjelajahi detail rentang atau pengelompokan, pilih entri dari baris di bagian tabel. Flyout akan terbuka dan menampilkan rentang dalam konteks rekam jejaknya. Dari tampilan ini, Anda dapat menjelajahi rentang, atributnya, dan melihat peristiwa serta data log. Anda juga dapat menelusuri rentang dan atribut dalam rekaman aktivitas untuk menemukan kata kunci.

Data rekaman aktivitas yang menjadi dasar halaman Penjelajah Rekaman Aktivitas adalah sebagai berikut:

• Setelan Cakupan, yang menentukan tampilan mana yang ditelusuri sistem untuk data rekaman aktivitas. Saat halaman terbuka, elemen Cakupan disetel ke cakupan rekaman aktivitas default dan sistem membuat kueri tampilan yang tercantum dalam cakupan tersebut untuk data rekaman aktivitas.

  Pada project baru, cakupan rekaman aktivitas default mencantumkan _AllSpans untuk project. Tampilan tersebut memberikan akses baca ke semua data rekaman aktivitas yang disimpan project.

• Izin Identity and Access Management (IAM) Anda pada tampilan yang ditelusuri. Jika Anda tidak memiliki izin untuk melihat data rekaman aktivitas untuk suatu project, maka konsol akan menampilkan pesan peringatan dan data dari project tersebut tidak akan ditampilkan. Google Cloud

• 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 Google Cloud konsol dan memilih cakupan rekaman aktivitas, 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 ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat data rekaman aktivitas menggunakan konsol Google Cloud dan untuk memilih cakupan rekaman aktivitas. Untuk melihat izin yang pasti 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 mengetahui 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 hal berikut:

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

   Buka Trace explorer

   Anda juga dapat menemukan halaman ini dengan 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 ditampilkan setelah menunggu beberapa menit, berarti project Anda mungkin tidak memiliki data untuk ditampilkan atau ada masalah konfigurasi. Untuk mengetahui informasi tentang cara mengatasi masalah ini, lihat Memecahkan masalah: Tidak ada data di antarmuka Trace.

2. Konfigurasi halaman Trace Explorer:

   1. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.

   2. Opsional: Konfigurasi tampilan yang ditelusuri sistem untuk data rekaman aktivitas menggunakan elemen Cakupan:

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

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

      Data yang ditampilkan sistem bergantung pada peran IAM Anda pada tampilan yang ditelusuri. Misalnya, jika Anda tidak memiliki izin yang diperlukan untuk melihat data dalam tampilan, maka sistem tidak akan menampilkan data tersebut.

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

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

      Misalnya, Anda dapat menyetel pemilih ini ke 2 minggu terakhir jika ingin melihat apakah ada tren dalam data latensi. Data rentang disimpan selama 30 hari.

3. Menjelajahi peta panas:

   • Gunakan warna untuk mengidentifikasi tren dan anomali. Sel dengan banyak rentang memiliki warna yang lebih gelap daripada sel dengan sedikit rentang.

   • Lihat detail sel menggunakan tooltip sel. Tooltip mencantumkan jumlah rentang, tanggal dan waktu, serta interval waktu sel.

     Catatan: Jika Anda memilih sel di peta panas, tabel yang mencantumkan rentang individual atau pengelompokan rentang akan diperbarui.

4. Mempelajari persentil latensi dan tingkat error:

   • Untuk melihat tren latensi, tetapkan menu Tampilan diagram ke Durasi rentang (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 rentang. Diagram akan menampilkan rasio rentang yang dikirim ke project Anda.

5. Gunakan tabel Rentang dan Dikelompokkan untuk mengidentifikasi pencilan atau melihat informasi statistik. Tabel Rentang mencantumkan rentang individual. Tabel Dikelompokkan mengelompokkan rentang menurut nama dan menurut nama layanan atau workload.

   • Untuk melihat pencilan atau menemukan nama rentang, urutkan tabel. Anda dapat mengurutkan berdasarkan header kolom mana pun.

     Misalnya, mengurutkan tabel Rentang menurut durasi memungkinkan Anda menemukan rentang dengan latensi tinggi.

   • Untuk melihat statistik seperti latensi rata-rata, gunakan tabel Dikelompokkan.

   • Untuk menemukan layanan dan workload yang terdaftar di App Hub, telusuri kolom Layanan/workload untuk menemukan entri yang menyertakan ikon layanan, , atau ikon workload, . Link yang disediakan dengan layanan atau workload yang terdaftar di App Hub akan membuka dasbor Pemantauan Aplikasi yang sesuai.

   Jika Anda ingin mengetahui informasi selengkapnya tentang pengelompokan tertentu, pilih nama rentang untuk baris. Flyout akan terbuka dan menampilkan rentang dalam konteks rekam jejaknya. Selanjutnya, Anda dapat menjelajahi rentang dan rekaman aktivitas.

6. Untuk membatasi rentang yang ditampilkan, tambahkan filter. Untuk mempelajari lebih lanjut cara memfilter data rekaman aktivitas, lihat bagian berikutnya.

Memfilter data rekaman aktivitas

Untuk menampilkan hanya informasi yang menarik bagi Anda, terapkan filter. Filter membatasi data yang ditampilkan. Misalnya, Anda dapat memfilter menurut nama layanan dan status. Atau, jika telah men-deploy aplikasi ke App Hub, Anda mungkin ingin melihat data rekaman aktivitas hanya untuk aplikasi, atau untuk layanan atau beban kerja tertentu yang merupakan bagian dari aplikasi.

Saat Anda menambahkan atau menghapus filter, data yang ditampilkan oleh halaman Trace Explorer akan dimuat ulang dan hanya menampilkan rentang yang cocok dengan semua filter yang diterapkan.

Memfilter menurut rekaman aktivitas berdasarkan ID

Saat memecahkan masalah insiden atau kegagalan, Anda mungkin mengetahui ID trace. Untuk menjelajahi trace tersebut, buka toolbar, klik tayangan halaman Telusuri trace, lalu masukkan ID trace.

Saat Anda memasukkan ID yang valid, flyout Detail akan terbuka dan menampilkan informasi tentang rekaman aktivitas dan rentangnya. Anda dapat menggunakan opsi di panel tersebut untuk menjelajahi rekaman aktivitas. Misalnya, Anda dapat menelusuri rentang untuk menemukan kata kunci.

Catatan: Jika Anda memasukkan ID rekaman aktivitas yang tidak ditemukan, data rekaman aktivitas mungkin disimpan dalam tampilan yang tidak dicari oleh halaman Trace Explorer, atau Anda mungkin tidak memiliki peran IAM yang memungkinkan Anda melihat data rekaman aktivitas. Untuk mengatasi kegagalan ini, identifikasi project yang menyimpan data rekaman aktivitas. Untuk setiap project, pastikan peran IAM Anda memungkinkan Anda melihat data rekaman aktivitas, lalu pastikan elemen Scope mencantumkan tampilan default project untuk data rekaman aktivitas. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi tampilan yang ditelusuri oleh Trace Explorer.

Menerapkan filter rentang

Panel Rentang filter mencantumkan filter yang paling umum. Anda dapat memilih beberapa entri dari subkategori mana pun. Saat Anda menambahkan atau menghapus filter, kolom Filter juga diperbarui.

Nilai untuk semua menu berasal dari data rekaman aktivitas Anda. Jika menu menyertakan opsi tanpa teks, opsi tersebut merujuk pada rentang yang tidak menyertakan atribut yang sesuai.

Filter rentang berikut biasanya tersedia:

• Layanan OpenTelemetry: Memfilter menurut atribut service.name.
• Nama rentang: Nama rentang.
• Status rentang: Status permintaan. Untuk mengetahui informasi tentang nilai, lihat dokumentasi SpanStatus OpenTelemetry.
• Durasi: Durasi rentang.
• Jenis rentang: Menjelaskan hubungan antara rentang. Untuk mengetahui informasi tentang nilai, lihat dokumentasi SpanKind OpenTelemetry.
• Aplikasi Pusat Aplikasi: Memfilter menurut atribut resource gcp.apphub.application.id.
• Layanan Pusat Aplikasi: Memfilter menurut atribut resource gcp.apphub.service.id.
• Workload Pusat Aplikasi: Memfilter menurut atribut resource gcp.apphub.workload.id.

Jika Anda ingin memfilter menurut atribut yang tidak tercantum di panel Filter rentang, gunakan kolom Filter.

Menggunakan panel filter

Kolom Filter memungkinkan Anda menerapkan filter dengan kunci filter yang telah ditentukan dan nilai yang Anda pilih, atau Anda dapat memasukkan kunci dan nilai.

Untuk menambahkan filter, pilih Tambahkan filter, lalu lakukan salah satu hal berikut:

• Pilih kunci yang ditentukan, seperti Nama rentang, lalu pilih nilai dari menu sekunder.

• Pilih Tambahkan filter atribut, lalu tambahkan kunci dan nilai kustom Anda. Jika Anda memasukkan kunci filter Anda sendiri, gunakan sintaksis yang sama seperti kunci untuk atribut pada rentang.

  Misalnya, untuk memfilter menurut ID host, tetapkan kunci ke host.id. Demikian pula, untuk memfilter menurut kode status, tetapkan kunci ke /http/status_code. Dalam skenario ini, Anda dapat menetapkan nilai ke 200, yang menghasilkan filter /http/status_code: 200. Agar filter mencocokkan nilai apa pun, pilih Nilai apa pun.

Filter menurut aplikasi

Untuk menemukan atau melihat span yang dihasilkan oleh layanan dan workload yang terdaftar di Pusat Aplikasi, span Anda harus berisi atribut resource berikut:

• gcp.apphub.application.{container,id,location}
• gcp.apphub.{workload,service}.{criticality_type,environment_type,id}

Atribut resource sebelumnya dihasilkan oleh instrumentasi yang Anda tambahkan ke aplikasi. Anda dapat memfilter data rekaman aktivitas menurut atribut resource apa pun. Namun, filter Rentang berikut memfilter menurut ID aplikasi, layanan, dan beban kerja:

• Aplikasi Pusat Aplikasi
• Layanan Pusat Aplikasi
• Workload Pusat Aplikasi

Untuk membuka dasbor Pemantauan Aplikasi bagi layanan dan beban kerja yang terdaftar di App Hub, lakukan hal berikut:

1. Buka tabel Rentang atau Dikelompokkan, lalu temukan layanan atau beban kerja. Anda dapat mencari ikon layanan, , ikon beban kerja, , atau memfilter tabel.

2. Pilih link di kolom Service/workload.

Menjelajahi rekaman aktivitas

Untuk menjelajahi rentang dalam konteks rekaman aktivitasnya, lakukan hal berikut:

1. Buka dan konfigurasi halaman Trace Explorer. Untuk mengetahui informasi tentang langkah-langkah ini, lihat Melihat data trace gabungan.

2. Untuk melihat detail rentang atau rekaman aktivitas, lakukan salah satu hal berikut:

   • Buka halaman Trace Explorer, lalu pilih entri dari tabel. Anda dapat mengurutkan baris tabel berdasarkan header tabel apa pun. Anda dapat menerapkan filter untuk membatasi rentang yang ditampilkan tabel.

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

     Flyout Detail akan terbuka dan menampilkan rekaman aktivitas serta rentang waktunya dalam format linimasa dan menampilkan informasi tentang rentang waktu yang dipilih:

     

     Flyout berisi layar terpisah. Satu sisi menampilkan rentang dalam konteks rekaman aktivitasnya. Sisi lainnya menampilkan tab yang memungkinkan Anda melihat informasi spesifik rentang seperti atribut, metadata, serta perintah dan respons yang dilampirkan. Untuk mempelajari tab ini lebih lanjut, lihat artikel Melihat atribut, entri log, dan peristiwa.

     Elemen linimasa bersifat dinamis. Untuk menjelajahi rentang lain, pilih rentang tersebut untuk melihat atribut, entri log, dan peristiwa rentang yang dipilih.

Menjelajahi hierarki panggilan

Secara default, hierarki panggilan muncul sebagai linimasa. Entri pertama merepresentasikan rekaman aktivitas, dan setiap entri berikutnya merepresentasikan rentang. Setiap entri menampilkan berikut ini:

• Kolom Nama menampilkan nama dan ID rentang atau rekaman aktivitas. Ikon GenAI, , menunjukkan bahwa rentang mencakup peristiwa atau atribut AI generatif.
• Kolom Layanan/workload menampilkan nama layanan atau workload. Sistem menetapkan nilai ini menggunakan atribut OpenTelemetry service.name. Sebagai penggantian, untuk layanan App Engine, sistem akan menampilkan nama layanan App Engine.
• Warna dan panjang diagram batang latensi mencerminkan status dan durasi perintah.
• Lingkaran pada kolom latensi menunjukkan bahwa entri log atau peristiwa dikaitkan dengan rentang. Untuk mengubah perilaku ini, gunakan menu Log & peristiwa.

Untuk melihat hierarki panggilan sebagai directed acyclic graph (DAG), pilih Grafik di toolbar:

Dalam tampilan DAG, nama dan latensi muncul di setiap elemen. Warna mencerminkan status rentang. Anda dapat menggunakan roda scroll pada pointer untuk mengubah ukuran grafik.

Menelusuri rentang dalam rekaman aktivitas

Untuk menelusuri rentang dalam rekaman aktivitas berdasarkan kata kunci, gunakan kolom Temukan di Rekaman Aktivitas.

Penelusuran hanya berlaku untuk nama rentang, nama layanan atau beban kerja, dan kolom atribut. Anda hanya dapat menelusuri berdasarkan teks biasa, dan Anda tidak dapat menelusuri log, peristiwa, atau metadata.

Misalnya, jika Anda memasukkan GET, teks di panel Nama, Layanan/beban kerja, dan Atribut yang menampilkan GET, dengan mengabaikan huruf besar/kecil, akan ditandai.

Melihat atribut, entri log, dan peristiwa

Flyout Detail untuk rentang berisi tab untuk masing-masing hal berikut:

• Input/Output: Menampilkan peristiwa yang mengikuti konvensi semantik GenAI OpenTelemetry. Tab ini hanya ditampilkan jika rentang berisi peristiwa ini. Untuk membantu Anda mengidentifikasi rentang ini, tampilan linimasa menampilkan ikon GenAI, , dengan nama rentang, jika rentang tersebut berisi peristiwa atau atribut yang mengikuti konvensi tersebut. Untuk mengetahui informasi selengkapnya, lihat Melihat peristiwa dan atribut AI generatif.

• Attributes: Mencantumkan atribut yang dilampirkan ke rentang. Trace Explorer menunjukkan rentang yang berisi atribut AI generatif dengan menampilkan ikon GenAI, . Untuk mengetahui informasi tentang label, lihat Label rekaman aktivitas.

• Log & Peristiwa: Tab ini mencantumkan peristiwa dan entri log yang kolom trace_id dan span_id-nya cocok dengan rentang yang dipilih. Hanya entri log yang memiliki izin untuk Anda lihat yang ditampilkan.

  Untuk menjelajahi entri di tab ini, klik Tampilkan lebih banyak.

  Jika Anda lebih suka menggunakan halaman Logs Explorer untuk melihat data log, klik Lihat log. Kueri ini ditetapkan untuk memfilter ke rentang waktu, rentang, dan rekaman aktivitas tertentu.

  Catatan: Peristiwa AI generatif ditampilkan di tab Input/Output. Untuk mempelajari lebih lanjut, lihat Melihat peristiwa AI generatif.

• Stacktrace: Mencantumkan stacktrace yang tersedia.

• Metadata & Link: Mencantumkan informasi umum, informasi tentang cakupan instrumentasi, dan link ke skema.

  Bagian Metadata menampilkan informasi seperti berikut:

  • ID rentang: ID rentang adalah bilangan bulat 64-bit selain 0. Untuk mengetahui detailnya, lihat TraceSpan.
  • ID span induk.
  • Project ID.
  • Waktu mulai dan waktu berakhir.

  • Tabel yang mencantumkan link ke rentang lain. Untuk setiap link, tabel ini mencantumkan hal berikut:

    • Pasangan nilai kunci untuk rentang yang ditautkan.
    • ID trace untuk span yang ditautkan. Jika kolom ini mencantumkan Trace saat ini, maka span ditautkan ke span lain dalam trace yang sama.

    Untuk informasi tentang link, lihat halaman referensi API Links.

  Bagian Cakupan instrumentasi dan Informasi skema menampilkan nama dan versi cakupan, serta menyediakan link ke skema. Bagian ini tidak ditampilkan jika rentang tidak berisi informasi ini.

Detail juga dapat menyertakan tab berlabel Input/Output. Tab ini menampilkan peristiwa AI generatif.

Melihat peristiwa AI generatif

Untuk mengidentifikasi rentang yang berisi atribut atau peristiwa yang sesuai dengan konvensi semantik GenAI OpenTelemetry, cari ikon GenAI, :

• Tab Attributes menampilkan atribut yang dilampirkan ke rentang. Untuk mencantumkan hanya atribut AI generatif, aktifkan Hanya atribut AI generatif.

• Tab Input/Output menampilkan peristiwa yang mengikuti konvensi tersebut dan atribut terkait, yang juga ditampilkan di tab Atribut. Ada dua konfigurasi yang didukung:

  • Perintah dan respons berbasis teks yang dilampirkan ke rentang sebagai atribut, yang merupakan pasangan nilai kunci yang mendeskripsikan karakteristik atau peristiwa. Misalnya, nilai untuk kunci gen_ai.system mengidentifikasi sistem yang menyediakan kemampuan AI generatif. Kunci untuk atribut AI generatif dimulai dengan gen_ai.

  • Perintah dan respons multimodal yang disimpan di bucket Cloud Storage. Cloud Trace mengidentifikasi peristiwa ini dengan menghubungkan data log dan data trace Anda. Untuk mempelajari konfigurasi yang didukung, lihat Mengumpulkan dan melihat perintah dan respons multimodal.

    Screenshot berikut menggambarkan cara Input/Output merender peristiwa AI generatif berbasis teks yang dilampirkan ke rentang:

    

    Untuk mempelajari aplikasi contoh yang menghasilkan screenshot sebelumnya, lihat Mengukur Agen ReAct LangGraph dengan OpenTelemetry.

Melihat panggilan ke server MCP jarak jauh

Untuk melihat rentang yang dihasilkan oleh server MCP, lakukan salah satu hal berikut:

• Memfilter data rekaman aktivitas menurut nama rentang.

• Tambahkan filter atribut yang kuncinya adalah mcp.method.name dan nilainya adalah tools/call.

  Filter ini khusus untuk menemukan rentang yang namanya mengikuti Konvensi Semantik OpenTelemetry untuk MCP. Nama ini mirip dengan:

  tools/call NAME
  

  Dalam ekspresi sebelumnya, NAME merujuk pada endpoint yang dipanggil. Misalnya, ini mungkin sesuatu yang mirip dengan roll_dice.

Untuk mempelajari server MCP Google Cloud jarak jauh mana yang mendukung pembuatan rekaman aktivitas dan cara mengonfigurasi aplikasi Anda untuk menginstruksikan server ini agar membuat rentang, lihat Menyelidiki panggilan MCP menggunakan Trace.

Langkah berikutnya

• Membuat dan mengelola cakupan rekaman aktivitas
• Membagikan rekaman aktivitas dan rentang
• Memecahkan masalah