In Cloud Logging, un oggetto LogEntry può archiviare un payload di log come dati strutturati o testo non strutturato. Una voce di log strutturata archivia il proprio payload come oggetto JSON nel campo jsonPayload, mentre una voce di log non strutturata archivia il proprio payload come stringa nel campo textPayload.
La formattazione del payload del log come oggetto JSON consente di eseguire ricerche e query in base ai percorsi JSON in Esplora log. Con i log non strutturati, puoi cercare la stringa di testo, ma non puoi eseguire query su singole chiavi.
Come vengono scritti i log strutturati
Il modo in cui le voci di log strutturate vengono scritte in Logging dipende dal tuo ambiente e dalla modalità di raccolta dei log:
- Librerie client di Logging: queste librerie scrivono log strutturati quando passi un oggetto o una mappa JSON come payload o quando generano JSON su una singola riga in
stdoutostderr.
- Google Cloud CLI o l'API Logging: puoi eseguire
gcloud logging writecon il flag--payload-type=json(esempio) o chiamare il metodo APIentries.writecon un oggettojsonPayload.
Passaggi successivi
Per eseguire query e visualizzare le voci di log, consulta Visualizza i log utilizzando Esplora log.
Per leggere le voci di log utilizzando gcloud CLI, consulta Lettura delle voci di log.
Per leggere le voci di log utilizzando l'API Logging, consulta il metodo
entries.list.