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 mengaitkan 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 berkorelasi

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

  • Lingkungan standar App Engine

  • Cloud Run Functions dan Cloud Run

Untuk informasi tentang cara melengkapi aplikasi untuk mengumpulkan data rekaman aktivitas, lihat Ringkasan cara melengkapi aplikasi untuk Cloud Trace.

Agar Logs Explorer dapat mengaitkan 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 adalah project ID project Google Cloud Anda dan TRACE_ID adalah ID rekaman aktivitas.

  • Kolom trace dalam entri log sama.

  • Setiap entri log adalah milik 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 halaman 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 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

Dengan penelusuran yang dikorelasikan, Anda dapat 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" di entri log turunan dan induk, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman 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 Run query. Entri log turunan yang berisi "pesan log aplikasi" tercantum 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 Apply.

  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 "pesan log aplikasi". 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 yang berkorelasi yang cocok dengan kueri Anda.

Langkah selanjutnya