Dokumen ini menjelaskan cara mengaitkan rekaman aktivitas dengan entri log Cloud Logging. Dengan menggunakan kolom rekaman aktivitas dalam struktur LogEntry—spanId, trace, dan traceSampled—Anda dapat
melakukan korelasi log dan rekaman aktivitas untuk memungkinkan pemecahan masalah yang didistribusikan dengan lebih baik.
Mengaitkan entri log dengan trace atau span secara manual
Jika menggunakan Cloud Logging API untuk menulis data log, atau jika menulis data log terstruktur, Anda dapat mengaitkan entri log dengan rekaman aktivitas atau dengan span. Entri log juga dapat mencatat apakah rekaman aktivitas diambil sampelnya. Untuk mengetahui informasi tentang cara Ops Agent mengonversi data log terstruktur menjadi kolom di LogEntry, lihat Kolom khusus dalam payload terstruktur.
Untuk mengaitkan entri log dengan rekaman aktivitas dengan menetapkan kolom trace
di objek LogEntry.
Kolom trace harus ditetapkan ke string dengan format berikut:
projects/PROJECT_ID/traces/TRACE_ID
dengan PROJECT_ID sebagai project ID Google Cloud Anda dan
TRACE_ID adalah ID rekaman aktivitas
Untuk mengaitkan entri log dengan span saat menggunakan Cloud Logging API,
tetapkan kolom spanId di objek LogEntry
ke encoding heksadesimal 16 karakter dari ID span.
Misalnya, untuk mengaitkan entri log dengan span yang memiliki ID 74,
tetapkan ID span ke 000000000000004a.
Untuk menunjukkan bahwa Anda menggunakan sampling rekaman aktivitas dan bahwa rekaman aktivitas diambil sampelnya
untuk disimpan saat entri log ditulis, tetapkan kolom traceSampled di
objek LogEntry. Saat Anda menggunakan sampling rekaman aktivitas,
entri log mungkin dibuat saat rekaman aktivitas itu sendiri tidak diambil.
Mengaitkan entri log dengan trace atau span secara otomatis
Saat menggunakan library klien Cloud Logging, dalam beberapa kasus, kolom rekaman aktivitas dalam entri log dapat ditetapkan secara otomatis. Nilai yang ditetapkan secara manual akan lebih diutamakan daripada nilai yang ditetapkan secara otomatis.
Misalnya, jika Anda menggunakan OpenTelemetry dan melakukan logging dari span OpenTelemetry yang aktif, kolom trace dalam entri log akan diisi dari Konteks OpenTelemetry.
Atau, dalam beberapa kasus, saat permintaan HTTP ada,
kolom rekaman aktivitas dapat ditetapkan dari
kolom traceparent W3C atau
nilai X-Cloud-Trace-Context dalam permintaan HTTP.
Untuk informasi selengkapnya tentang pengisian otomatis kolom rekaman aktivitas dalam entri log, lihat dokumentasi library klien khusus bahasa berikut:
Melihat log
Anda dapat melihat entri log untuk rekaman aktivitas bersama grafik waterfall atau di Logs Explorer. Saat Anda menggunakan Penjelajah Log, penjelajah tersebut akan otomatis dibatasi
ke rentang stempel waktu rekaman aktivitas. Jika tidak ada entri log yang dapat ditampilkan,
Logs Explorer akan menampilkan pesan
No entries found matching current filter.
Dari panel Trace details, untuk melihat entri log rekaman aktivitas, lakukan salah satu hal berikut:
Untuk menampilkan entri log rekaman aktivitas bersama grafik waterfall, buka grafik waterfall, lalu klik Tampilkan log. Jika Tampilkan log tidak ditampilkan, tidak ada entri log yang tersedia.
Untuk melihat entri log di Logs Explorer, klik Lihat di samping label Log di bagian Detail. Perhatikan bahwa jika Anda memiliki rekaman aktivitas Cloud Load Balancing, klik Lihat di samping label Log VM.
Untuk mengetahui informasi selengkapnya tentang cara melihat entri log di Cloud Logging, lihat artikel Menggunakan Logs Explorer.
Izin melihat log
Untuk melihat entri log, Anda harus memiliki izin logging.logEntries.list di project. Izin ini diberikan oleh peran Identity and Access Management (IAM) Logs Viewer dan
Project Viewer.
Untuk melihat log instance VM, Anda harus memiliki izin compute.instances.get di project. Izin ini diberikan oleh peran IAM Compute Engine Network Viewer dan Project Viewer.