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.

Fitur ini hanya didukung untuk Google Cloud project. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

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 rentang dalam sel. Sel dengan banyak rentang ditampilkan dengan warna yang lebih gelap daripada sel dengan sedikit rentang. Anda dapat memilih sel atau mengaktifkan tooltip sel untuk mendapatkan informasi selengkapnya. Visualisasi lainnya memungkinkan Anda melihat latensi sebagai persentil dan informasi kecepatan rentang. Untuk semua visualisasi, Anda dapat menggunakan pointer 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 rentang dengan properti tertentu:

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

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

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

Data rekaman aktivitas yang ditampilkan oleh halaman Trace Explorer bergantung pada hal berikut:

• Project yang ditelusuri untuk data rekaman aktivitas. Secara default, hanya project yang dipilih oleh pemilih project yang dicari untuk data rekaman aktivitas. Namun, Anda dapat mengonfigurasi halaman untuk menelusuri daftar project dalam cakupan rekaman aktivitas.
• Izin Identity and Access Management (IAM) Anda pada project yang dicari. Jika Anda tidak memiliki izin untuk melihat data rekaman aktivitas untuk suatu project, 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 konsol Google Cloud dan 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 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 menyelesaikan masalah ini, lihat Pemecahan masalah: Tidak ada data di antarmuka Trace.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

3. Opsional: Konfigurasi project mana yang ditelusuri untuk data rekaman aktivitas menggunakan elemen Cakupan:

   • Untuk menampilkan data rekaman aktivitas yang disimpan di 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 menentukan pilihan, menu Cakupan akan menampilkan ikon cakupan rekaman aktivitas, , dan nama cakupan rekaman aktivitas yang dipilih.

   Data yang ditampilkan bergantung pada peran IAM Anda di project yang dicari. Misalnya, project yang dicari mencakup project Google Cloud yang tidak dapat Anda akses, maka tidak ada data aktivitas untuk project tersebut yang ditampilkan.

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

4. Opsional: Perbarui rentang waktu menggunakan pemilih rentang waktu atau 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.

5. Buka toolbar dan setel pemilih rentang waktu ke minimal dua minggu. Data rentang disimpan selama 30 hari.

6. Jelajahi diagram, yang menunjukkan pola dan tren dalam data rekaman aktivitas Anda:

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

   • 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 Kecepatan rentang. Diagram menampilkan rasio rentang yang dikirim ke project Anda.

7. Jelajahi data tabular yang mencantumkan rentang individual di tab Rentang dan rentang yang dikelompokkan menurut layanan dan namanya di tab Dikelompokkan.

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

   Untuk menemukan pencilan, pilih header kolom untuk mengurutkan tabel.

8. Tambahkan filter untuk membatasi rentang yang ditampilkan. Untuk mempelajari lebih lanjut cara memfilter data rekaman aktivitas, lihat bagian berikutnya.

Memfilter data rekaman aktivitas

Untuk menampilkan hanya informasi yang Anda minati, terapkan filter. Filter membatasi data yang ditampilkan. Misalnya, Anda dapat memfilter menurut nama layanan dan status. Atau, jika Anda telah men-deploy aplikasi ke App Hub, Anda mungkin ingin melihat data rekaman aktivitas hanya untuk aplikasi, atau untuk layanan atau workload 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.

Untuk mengubah setelan filter, Anda dapat menggunakan panel Filter rentang atau panel Filter.

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, panel 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 OpenTelemetry SpanStatus.
• Durasi: Durasi rentang.
• Jenis rentang: Menjelaskan hubungan antara rentang. Untuk mengetahui informasi tentang nilai, lihat dokumentasi SpanKind OpenTelemetry.
• Aplikasi App Hub: Memfilter menurut atribut resource gcp.apphub.application.id.
• Layanan App Hub: Memfilter menurut atribut resource gcp.apphub.service.id.
• Beban kerja App Hub: 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 tindakan 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.

Menemukan rekaman aktivitas menurut ID

Saat memecahkan masalah insiden atau kegagalan, Anda mungkin mengetahui ID pelacakan. 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 dengan menggunakan kotak penelusuran.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

3. Buka toolbar, klik pageview Search for trace, lalu masukkan trace ID.

   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 kata kunci.

Menjelajahi rekaman aktivitas

Untuk melihat rekaman aktivitas atau rentang, 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 menyelesaikan masalah ini, lihat Pemecahan masalah: Tidak ada data di antarmuka Trace.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

3. Lakukan salah satu hal berikut:

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

   • 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:

   • Kolom Name menampilkan hierarki panggilan dan entri pertama mencakup ID rekaman aktivitas.
   • Kolom Service 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 diagram batang latensi menunjukkan status. Batang latensi biru menunjukkan penyelesaian yang berhasil, sedangkan batang latensi merah menunjukkan bahwa terjadi error.
   • Lingkaran pada batang latensi menunjukkan bahwa entri log atau peristiwa terkait dengan rentang. Untuk mengubah perilaku ini, gunakan menu Log & peristiwa.

4. Opsional: Telusuri nama rentang, nama layanan, dan atribut dalam rekaman aktivitas menggunakan kolom Temukan dalam Rekaman Aktivitas.

   Misalnya, jika Anda memasukkan GET, maka teks di nama rentang, nama layanan, atau di panel Atribut yang menampilkan GET, dengan mengabaikan huruf besar/kecil, akan ditandai.

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

5. Untuk melihat detail rentang tertentu, pilih rentang, 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 rentang, buka tab Atribut. Untuk mengetahui informasi tentang label, lihat Label rekaman aktivitas.

Melihat informasi aplikasi

Atribut resource khusus aplikasi berikut dapat dilampirkan ke data rekaman aktivitas. Di bagian ini, tafsirkan a.b.{x,y} sebagai a.b.x dan a.b.y:

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

Untuk menemukan data rekaman aktivitas aplikasi 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.

2. Buka panel Span filters dan tambahkan filter untuk aplikasi App Hub Anda:

   • Untuk memfilter menurut ID aplikasi, (gcp.apphub.application.id), gunakan menu aplikasi Hub Aplikasi.
   • Untuk memfilter menurut layanan aplikasi, (gcp.apphub.service.id), gunakan menu layanan App Hub.
   • Untuk memfilter menurut beban kerja aplikasi, (gcp.apphub.workload.id), gunakan menu Beban kerja App Hub.

Atribut resource khusus aplikasi dilampirkan ke data rekaman aktivitas Anda jika hal berikut benar:

• Aplikasi Hub Aplikasi Anda menggunakan resource Google Cloud yang didukung.
• Anda melakukan instrumentasi aplikasi dengan OpenTelemetry dan mengirim data trace yang dikumpulkan dari aplikasi ke project Anda menggunakan endpoint OTLPGoogle Cloud .
• Data yang dikirim ke project Anda mencakup atribut resource OpenTelemetry yang mengidentifikasi resource Google Cloud yang didukung dan digunakan oleh aplikasi Anda. Atribut harus menyertakan hal berikut:
  • cloud.account.id
  • Salah satu dari cloud.{availability_zone,region}

  • Atribut khusus resource. Misalnya, untuk workload Kubernetes, rentang harus memiliki k8s.cluster.name, k8s.namespace, dan jenis deployment Kubernetes yang ditetapkan.

    Anda dapat menggunakan pemroses agar OpenTelemetry Collector melampirkan atribut khusus resource ke rentang Anda. Untuk mempelajari lebih lanjut, lihat resourcedetectionprocessor dan k8sattributesprocessor.

  Saat Anda menginstrumentasi aplikasi, Google Cloud Observability menggunakan atribut resource sebelumnya dan App Hub API untuk mengidentifikasi aplikasi App Hub Anda. Label spesifik per aplikasi ditambahkan ke data rekaman aktivitas saat aplikasi diidentifikasi.

Untuk mengetahui informasi selengkapnya tentang atribut ini, lihat Google Cloud Konvensi semantik App Hub.

Melihat log dan peristiwa

Untuk melihat log dan peristiwa yang terkait dengan rentang waktu, buka tab Log & Peristiwa.

Untuk melihat entri log, klik keyboard_arrow_down Tampilkan lebih banyak.

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

Melihat peristiwa AI generatif

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

Screenshot berikut menggambarkan cara halaman Trace Explorer merender peristiwa AI generatif:

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

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 yang menjadi tujuan pengiriman permintaan.

Peristiwa yang namanya diawali dengan "gen_ai" biasanya mendeskripsikan input atau output individual 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 kepada 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 diberikan pengguna yang dikirim ke model.
• gen_ai.assistant.message: Peristiwa yang merekam output model, yang dapat mencakup rekaman 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 mana yang digunakan oleh aplikasi.

Melihat stack trace

Untuk melihat stacktrace, gunakan tab Stacktraces.

Melihat informasi umum dan metadata lainnya

Untuk menemukan informasi umum tentang rentang dan tabel link ke rentang lainnya, lihat tab Metadata & Link. Informasi ini mencakup:

• ID rentang: ID rentang 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 rentang lain

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

Melihat tren

Setelah men-deploy update ke aplikasi, Anda mungkin ingin menentukan apakah update tersebut memengaruhi latensi respons. Anda dapat melihat tren dalam data latensi dengan menyetel pemilih rentang waktu sehingga data latensi ditampilkan sebelum dan setelah upgrade.

Untuk melihat tren dalam data rekaman aktivitas, 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.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Opsional: Tambahkan filter untuk mengonfigurasi rentang yang ditampilkan.
4. Buka toolbar dan setel pemilih rentang waktu ke minimal dua minggu. Data rentang disimpan selama 30 hari.
5. Opsional: Ubah pilihan untuk menu Tampilan diagram.

Langkah berikutnya

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