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 akan disebut log terstruktur. Untuk log ini, Anda dapat membuat kueri yang menelusuri jalur JSON tertentu dan dapat mengindeks kolom tertentu dalam payload log. Sebaliknya, jika payload log diformat sebagai string dan disimpan di kolom textPayload, entri log akan tidak terstruktur.
Anda dapat menelusuri kolom teks, tetapi tidak dapat mengindeks kontennya.
Untuk membuat entri log terstruktur, lakukan salah satu hal berikut:
- Panggil metode API
entries.writedan berikanLogEntryyang diformat sepenuhnya. - Gunakan perintah
gcloud logging write.
Untuk mengetahui informasi selengkapnya tentang pendekatan ini, lihat bagian berikut.
Menulis log menggunakan gcloud CLI
Anda dapat menulis data log menggunakan gcloud CLI. Antarmuka ini mendukung log tidak terstruktur dan log terstruktur. Jika ingin menulis log terstruktur, berikan perintah objek JSON yang di-serialisasi.
Untuk panduan memulai, lihat Menulis dan membuat kueri entri log dengan Google Cloud CLI.
Untuk contoh kode, lihat referensi
gcloud logging write.
Langkah berikutnya
Untuk membuat kueri dan melihat entri log, lihat Melihat log menggunakan Logs Explorer.
Untuk membaca entri log menggunakan Google Cloud CLI, lihat Membaca entri log.
Untuk membaca entri log menggunakan Logging API, lihat metode
entries.list.