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.writedan berikanLogEntryyang diformat sepenuhnya. - Gunakan perintah
gcloud logging write.
- Gunakan library klien Cloud Logging yang 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.
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.