Menggabungkan entri log

Dokumen ini menjelaskan cara mengelompokkan dan melihat entri log dalam format "induk-turunan" 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 mengorelasikan entri log menggunakan kolom trace di objek LogEntry.

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

Menyiapkan entri log yang dikorelasikan

Untuk menyiapkan entri log yang saling terkait, Anda dapat mengisi kolom trace secara manual, atau Anda dapat menginstrumentasi aplikasi untuk mengirimkan rekaman aktivitas ke Cloud Trace dengan menggunakan library klien Google. Konfigurasi berikut otomatis merekam data rekaman aktivitas Anda:

  • Lingkungan standar App Engine

  • Cloud Run Functions dan Cloud Run

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

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

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

       projects/PROJECT_ID/traces/TRACE_ID

    dengan PROJECT_ID adalah ID project Google Cloud project Anda dan TRACE_ID adalah ID aktivitas.

  • Kolom trace dalam entri log sama.

  • Setiap entri log termasuk dalam log unik. Artinya, nilai kolom logName harus berbeda.

Melihat entri log terkait di Logs Explorer

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

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

  1. Di konsol Google Cloud , buka Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

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

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

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

    Entri log aplikasi yang berkorelasi dengan entri log permintaan akan disusun bertingkat dalam entri log permintaan:

    Entri log aplikasi disusun bertingkat dalam entri log permintaan.

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

Menelusuri entri log yang dikorelasikan

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

  1. Di konsol Google Cloud , buka Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

  2. Masukkan "app log message" di kolom penelusuran, lalu klik Jalankan kueri. Entri log turunan yang berisi "app log message" dicantumkan di panel Query results.

  3. Di panel Hasil kueri, klik Korelasikan menurut, lalu pilih log induk. Untuk melihat log permintaan App Engine, pilih request_log, lalu klik Terapkan.

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

    Untuk melihat entri log turunan bertingkat, perluas entri log induk, klik Luaskan.

    Entri log aplikasi disusun bertingkat dalam entri log permintaan.

    Pada 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, berarti tidak ada entri induk dan turunan yang berkorelasi dan cocok dengan kueri Anda.

Langkah berikutnya