Dokumen ini menjelaskan cara menautkan entri log dengan rekaman aktivitas. Anda melakukan
penautan dengan menetapkan kolom dalam entri log.
Dengan menggunakan kolom rekaman aktivitas dalam struktur LogEntry—spanId, trace, dan traceSampled—Anda dapat mengorelasikan log dan rekaman aktivitas untuk memungkinkan pemecahan masalah terdistribusi yang lebih baik.
Mengaitkan entri log dengan trace atau span secara manual
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
Ops Agent 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 ID project Google Cloud Anda dan
TRACE_ID adalah ID rekaman aktivitas
Untuk mengaitkan entri log dengan rentang saat menggunakan Cloud 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 pengambilan sampel rekaman aktivitas dan rekaman aktivitas 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 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 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, Logs Explorer 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.
Dari panel Detail rekaman aktivitas, untuk melihat entri log untuk 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. Perhatikan bahwa saat 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 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) Pelihat Log dan Pelihat Project.
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.