Logging terstruktur

Dokumen ini membahas konsep logging terstruktur dan metode untuk menambahkan struktur ke kolom payload entri log. Saat payload log diformat sebagai objek JSON dan objek tersebut disimpan di kolom jsonPayload, entri log disebut log terstruktur. Untuk log ini, Anda dapat membuat kueri yang menelusuri jalur JSON tertentu dan Anda dapat mengindeks kolom tertentu dalam payload log. Sebaliknya, saat payload log diformat sebagai string dan disimpan di kolom textPayload, entri log bersifat tidak terstruktur. Anda dapat menelusuri kolom teks, tetapi tidak dapat mengindeks kontennya.

Untuk membuat entri log terstruktur, lakukan salah satu tindakan berikut:

  • Panggil metode API entries.write dan berikan LogEntry yang diformat sepenuhnya.
  • Gunakan perintah gcloud logging write.
  • Gunakan library klien Cloud Logging yang menulis log terstruktur.

Untuk informasi selengkapnya tentang pendekatan ini, lihat bagian berikut.

Menulis log menggunakan library klien atau API

Anda dapat menulis data log menggunakan library klien Cloud Logging, yang memanggil Cloud Logging API, atau dengan memanggil Cloud Logging API secara langsung. Library klien dapat menyederhanakan pengisian kolom JSON khusus dengan mengambil sejumlah informasi secara otomatis dan menyediakan antarmuka untuk mengisi kolom dengan tepat. Namun, untuk kontrol penuh atas struktur payload, panggil Cloud Logging API secara langsung dan teruskan struktur LogEntry lengkap ke Cloud Logging API.

Untuk informasi selengkapnya, lihat referensi entries.write.

Untuk contoh kode, lihat Menulis log terstruktur.

Menulis log menggunakan gcloud CLI

Anda dapat menulis data log menggunakan gcloud CLI. Antarmuka ini mendukung log tidak terstruktur dan log terstruktur. Jika Anda ingin menulis log terstruktur, berikan objek JSON yang diserialisasi ke perintah.

Untuk panduan memulai, lihat Menulis dan membuat kueri entri log dengan Google Cloud CLI.

Untuk contoh kode, lihat referensi gcloud logging write.

Langkah berikutnya