Menggabungkan entri log

Dokumen ini menjelaskan cara mengelompokkan dan melihat entri log dalam format "parent-child" menggunakan Logs Explorer. Biasanya saat Anda menulis entri log ke Cloud Logging, setiap entri log akan muncul secara terpisah dan tidak berkorelasi. Namun, Anda dapat mengelompokkan atau menghubungkan entri log menggunakan kolom trace di objek LogEntry.

Saat menghubungkan entri log, Anda dapat melihat entri log induk dengan beberapa entri log turunan di Logs Explorer.

Menyiapkan entri log terkait

Untuk menyiapkan entri log terkait, Anda dapat mengisi kolom trace secara manual, atau menginstrumentasikan aplikasi Anda untuk mengirim rekaman aktivitas ke Cloud Trace menggunakan library klien Google. Konfigurasi berikut akan otomatis mengambil data rekaman aktivitas Anda:

  • Lingkungan standar App Engine

  • Cloud Functions dan Cloud Run

Untuk mengetahui informasi tentang cara menginstrumentasikan aplikasi Anda untuk mengumpulkan data trace, lihat Ringkasan instrumentasi untuk Cloud Trace.

Agar Logs Explorer dapat menghubungkan kumpulan entri log, entri log harus memenuhi persyaratan berikut:

  • Kolom trace dalam objek LogEntry ditetapkan ke string dengan format berikut:

       projects/PROJECT_ID/traces/TRACE_ID

    dengan PROJECT_ID sebagai project ID Google Cloud Anda dan TRACE_ID sebagai ID trace.

  • Kolom trace dalam entri log sama.

  • Setiap entri log dimiliki oleh log unik. Artinya, nilai kolom logName harus berbeda.

Melihat entri log terkait di Logs Explorer

Untuk melihat entri log turunan yang terkait dengan entri log induk yang Anda lihat di Logs Explorer, luaskan entri log tersebut.

Misalnya, untuk menampilkan entri log permintaan App Engine dan entri log aplikasi, lakukan hal berikut:

  1. Pada panel navigasi Google Cloud Console, pilih Logging, lalu pilih Logs Explorer:

    Buka Logs Explorer

  2. Di menu drop-down Resource, pilih GAE Application.

  3. Di menu drop-down Log Name, pilih request_log.

  4. Di panel Query results, untuk memperluas entri log, klik Expand.

    Entri log aplikasi yang berkorelasi dengan entri log permintaan ditempatkan di entri log permintaan:

    Entri log aplikasi disarangkan di entri log permintaan.

    Dalam screenshot sebelumnya, entri log induk memiliki 10 entri log turunan. Anda dapat meluaskan entri log turunan ini untuk melihat detailnya.

Telusuri entri log terkait

Penelusuran berkorelasi memungkinkan Anda menelusuri entri log induk dan turunan dengan kueri. Hasil penelusuran adalah daftar entri log induk yang cocok dengan kueri dalam entri log induk atau turunan. Misalnya, untuk menelusuri string "pesan log aplikasi" dalam entri log turunan dan induk, lakukan tindakan berikut:

  1. Pada panel navigasi Google Cloud Console, pilih Logging, lalu pilih Logs Explorer:

    Buka Logs Explorer

  2. Masukkan "app log message" di bidang penelusuran, dan klik Jalankan kueri. Entri log turunan yang berisi "pesan log aplikasi" akan tercantum di panel Query results.

  3. Di panel Query results, klik Correlate by, lalu pilih log induk. Untuk melihat log permintaan App Engine, pilih request_log, lalu klik Apply.

  4. Di panel Query results, semua entri log induk yang berisi string "app log message" atau yang memiliki turunan yang berisi string akan dicantumkan.

    Untuk melihat entri log turunan bertingkat, tp luaskan entri log induk, klik Luaskan.

    Entri log aplikasi disarangkan di entri log permintaan.

    Dalam screenshot sebelumnya, entri log induk memiliki 10 entri log turunan yang berisi string "app log message". Anda dapat meluaskan entri log turunan ini untuk melihat detailnya.

    Jika Anda memilih log induk dan tidak melihat entri log di panel Query results, maka tidak ada entri induk dan turunan terkait yang cocok dengan kueri Anda.

Langkah selanjutnya