Mengintegrasikan dengan Cloud Logging

Dokumen ini menjelaskan cara mengaitkan rekaman aktivitas dengan LogEntry Cloud Logging.

Mengaitkan entri log dengan trace atau span

Jika menggunakan Cloud Logging API untuk menulis data log, atau jika Anda menulis data log terstruktur, Anda dapat mengaitkan entri log dengan trace atau dengan span. Entri log juga dapat mencatat apakah rekaman aktivitas diambil sampelnya. Untuk mengetahui informasi tentang cara Agen Operasional 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 disetel 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 trace

Untuk mengaitkan entri log dengan span saat menggunakan Cloud Logging API, tetapkan kolom spanId di objek LogEntry ke encoding heksadesimal 16 karakter untuk ID span. Misalnya, untuk mengaitkan entri log dengan span yang memiliki ID 74, tetapkan ID span ke 000000000000004a.

Untuk menunjukkan bahwa Anda menggunakan pengambilan sampel rekaman aktivitas dan bahwa rekaman aktivitas diambil sampelnya untuk disimpan saat entri log ditulis, tetapkan kolom traceSampled dalam objek LogEntry. Saat menggunakan sampling rekaman aktivitas, ada kemungkinan entri log akan dibuat saat rekaman aktivitas itu sendiri tidak direkam.

Melihat log

Anda dapat melihat entri log untuk suatu rekaman aktivitas di samping grafik waterfall atau di Logs Explorer. Saat digunakan, Logs Explorer otomatis dibatasi ke rentang stempel waktu rekaman aktivitas. Jika tidak ada entri log yang dapat ditampilkan, Log Explorer akan menampilkan pesan No entries found matching current filter.

Dari panel Trace details, guna melihat entri log untuk rekaman aktivitas, lakukan salah satu langkah berikut:

  • Untuk menampilkan entri log rekaman aktivitas bersama grafik waterfall, buka grafik waterfall, lalu klik Show logs. Jika Show logs tidak ditampilkan, berarti tidak ada entri log yang tersedia.

  • Untuk melihat entri log di Logs Explorer, klik View di samping label Log di bagian Details. Perhatikan bahwa ketika Anda memiliki rekaman aktivitas Cloud Load Balancing, klik View di sebelah label VM Log.

Untuk mengetahui informasi lebih lanjut tentang cara melihat entri log di Cloud Logging, lihat Menggunakan Logs Explorer.

Izin lihat log

Untuk melihat entri log, Anda harus memiliki izin logging.logEntries.list dalam project Anda. Izin ini disediakan oleh peran Logs Viewer dan Project Viewer Identity and Access Management (IAM).

Untuk melihat log instance VM, Anda harus memiliki izin compute.instances.get dalam project Anda. Izin ini disediakan oleh peran IAM Compute Engine Network Viewer dan Project Viewer.