Logging terstruktur

Dokumen ini membahas konsep logging terstruktur dan metode untuk menambahkan struktur ke kolom payload entri log. Jika 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 mengindeks kolom tertentu dalam payload log. Sebaliknya, jika payload log diformat sebagai string dan disimpan di kolom textPayload, entri log akan menjadi tidak terstruktur. Anda dapat menelusuri kolom teks, tetapi Anda tidak dapat mengindeks kontennya.

Untuk membuat entri log terstruktur, lakukan salah satu hal 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.
  • Gunakan layanan BindPlane.

  • Menggunakan agen untuk menulis log:

    • Beberapa layanan Google Cloud berisi agen logging terintegrasi yang mengirim data yang ditulis ke stdout atau stderr sebagai log ke Cloud Logging. Anda dapat menggunakan pendekatan ini untuk Google Cloud layanan seperti Google Kubernetes Engine, lingkungan fleksibel App Engine, dan Cloud Run Functions.
    • Untuk virtual machine (VM) Compute Engine, sebaiknya Anda menginstal dan mengonfigurasi Agen Operasional untuk mengirim log terstruktur ke Cloud Logging. Jika VM yang ada menggunakan agen Logging lama, perhatikan bahwa agen tersebut telah mencapai akhir masa dukungannya. Untuk mengetahui informasi tentang alternatif migrasi dari agen Logging lama, lihat panduan migrasi, atau lihat Logging terstruktur dengan agen Logging lama untuk mengetahui informasi tentang cara menggunakan agen Logging lama untuk menulis log terstruktur.

Untuk contoh kode, lihat Menulis log terstruktur.

Menulis log menggunakan gcloud CLI

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

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

Untuk contoh kode, lihat referensi gcloud logging write.

Menulis log menggunakan BindPlane

Anda dapat menggunakan layanan BindPlane untuk mengirim log ke Logging. Untuk log ini, payload dalam format JSON dan disusun sesuai dengan sistem sumber. Untuk mengetahui informasi tentang cara menemukan dan melihat log yang diserap menggunakan BindPlane, lihat Panduan Memulai Cepat BindPlane.

Menulis log menggunakan Agen Operasional

Untuk mendapatkan log dari instance Compute Engine, Anda dapat menggunakan Agen Operasional. Agen Operasional menggabungkan logging dan metrik ke dalam satu agen, menyediakan konfigurasi berbasis YAML, dan menampilkan logging dengan throughput tinggi.

Untuk mengetahui informasi tentang cara mengonfigurasi Agen Operasional untuk mendukung logging terstruktur atau menyesuaikan bentuk log terstruktur, lihat Mengonfigurasi Agen Operasional.

Memecahkan masalah

Untuk memecahkan masalah umum yang ditemukan saat menginstal atau berinteraksi dengan Agen Operasi, lihat Memecahkan masalah agen.

Langkah berikutnya