Menggunakan logging terstruktur dengan log build

Dokumen ini menjelaskan cara mengonfigurasi log Cloud Build untuk digunakan dengan logging terstruktur di Cloud Logging.

Logging terstruktur memungkinkan Anda menyimpan kolom log build berformat JSON sebagai bagian dari kolom jsonPayload, atau sebagai kolom lain tertentu, dalam LogEntry. Anda dapat menyiapkan file konfigurasi build sehingga kolom log build tertentu dipetakan dengan cara ini saat Anda mengirim log build ke Logging.

Misalnya, jika log build Anda berisi message, pesan akan muncul di textPayload atau jsonPayload.message dalam entri log yang dihasilkan. Jika kolom log build tidak dapat dipetakan ke kolom entri log tertentu, kolom log build akan disimpan sebagai bagian dari jsonPayload entri log.

Memetakan kolom log build ke kolom entri log

Untuk mengaktifkan pemetaan kolom di log build, tetapkan kolom BuildOptions enableStructuredLogging ke TRUE.

Tabel berikut menunjukkan kolom log build yang dipetakan ke kolom entri log:

Kolom BuildLog (JSON) Kolom LogEntry Deskripsi Catatan
message textPayload atau jsonPayload.message Memungkinkan Anda menetapkan pesan log

Harus berupa string.

Jika log build hanya berisi kolom yang dapat dipetakan, pesan akan muncul di textPayload. Jika tidak, pesan akan muncul di jsonPayload.message.

Jika log build berisi beberapa langkah, ID langkah akan muncul di awal pesan.

severity severity Memungkinkan Anda menetapkan tingkat keparahan log. Harus berupa enum LogSeverity.

Kolom log build berikut tidak dapat dipetakan dan akan dihapus dari entri log jika muncul dalam log build:

  • httpRequest
  • logging.googleapis.com/insertId
  • logging.googleapis.com/labels
  • logging.googleapis.com/operation
  • logging.googleapis.com/sourceLocation
  • logging.googleapis.com/spanId
  • logging.googleapis.com/trace
  • logging.googleapis.com/trace_sampled
  • time
  • timestamp
  • timestampSeconds
  • timestampNanos

Semua kolom log build lainnya akan muncul sebagai bagian dari jsonPayload entri log.