Mengorelasikan entri log Cloud Logging dengan rekaman aktivitas dan span Cloud Trace memungkinkan Anda melihat log bersama grafik waterfall rekaman aktivitas atau di Logs Explorer saat memecahkan masalah permintaan terdistribusi. Untuk menautkan log dengan
trace, Anda dapat menetapkan kolom trace, spanId, dan traceSampled dalam objek
LogEntry secara manual, atau menggunakan library klien Logging
untuk mengisi kolom ini secara otomatis dari konteks
OpenTelemetry atau header permintaan HTTP.
Mengaitkan entri log secara manual dengan rekaman aktivitas atau rentang
Jika Anda menggunakan Cloud Logging API untuk menulis data log, atau jika Anda menulis
data log terstruktur,
maka Anda dapat mengaitkan entri log dengan rekaman aktivitas atau dengan rentang. Entri log
juga dapat mencatat apakah rekaman aktivitas diambil sampelnya. Untuk mengetahui informasi tentang cara
Agen Operasional mengonversi data log terstruktur menjadi
kolom dalam LogEntry, lihat Kolom khusus dalam payload terstruktur.
Untuk mengaitkan entri log dengan rekaman aktivitas, tetapkan kolom trace
dalam objek LogEntry:
- Format pilihan:
TRACE_ID - Format lama:
projects/PROJECT_ID/traces/TRACE_ID
Dalam ekspresi sebelumnya, PROJECT_ID adalah project ID Google Cloud Anda dan
TRACE_ID adalah ID rekaman aktivitas.
Untuk mengaitkan entri log dengan rentang saat menggunakan Logging API,
tetapkan kolom spanId di objek LogEntry
ke encoding heksadesimal 16 karakter dari ID rentang.
Misalnya, untuk mengaitkan entri log dengan rentang yang memiliki ID 74,
tetapkan ID rentang ke 000000000000004a.
Untuk menunjukkan bahwa Anda menggunakan sampling rekaman aktivitas dan rekaman aktivitas tersebut diambil sampelnya untuk penyimpanan saat entri log ditulis, tetapkan kolom traceSampled di objek LogEntry. Saat Anda menggunakan pengambilan sampel rekaman aktivitas, entri log mungkin dibuat saat rekaman aktivitas itu sendiri tidak direkam.
Mengaitkan entri log secara otomatis dengan rekaman aktivitas atau rentang
Library klien logging dapat otomatis menetapkan kolom rekaman aktivitas dalam beberapa kasus. Nilai yang ditetapkan secara manual lebih diprioritaskan daripada nilai yang ditetapkan secara otomatis.
Misalnya, jika Anda menggunakan OpenTelemetry dan melakukan logging dari rentang OpenTelemetry yang aktif, maka kolom trace dalam entri log akan diisi dari Konteks OpenTelemetry.
Atau, dalam beberapa kasus, saat ada permintaan HTTP, kolom rekaman aktivitas dapat ditetapkan dari kolom W3C traceparent atau nilai X-Cloud-Trace-Context dalam permintaan HTTP.
Untuk mengetahui 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 Logs Explorer, rentang waktu akan otomatis dibatasi ke rentang stempel waktu rekaman aktivitas. Jika tidak ada entri log yang ditampilkan,
Logs Explorer akan menampilkan pesan
No entries found matching current filter.
Untuk melihat entri log untuk rekaman aktivitas dari panel Detail rekaman aktivitas, lakukan salah satu hal berikut:
Untuk menampilkan entri log rekaman aktivitas bersama diagram waterfall, buka diagram 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. 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 Logging, lihat Menggunakan Logs Explorer.
Izin melihat log
Untuk melihat entri log, Anda harus memiliki izin logging.logEntries.list di project Anda. 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 Anda. Izin ini diberikan oleh peran IAM Compute Engine Network Viewer dan Project Viewer.