In Cloud Logging kann ein LogEntry-Objekt eine Log-Nutzlast entweder als strukturierte Daten oder als unstrukturierten Text speichern. Bei einem strukturierten Logeintrag wird die Nutzlast als JSON-Objekt im Feld jsonPayload gespeichert, während bei einem unstrukturierten Logeintrag die Nutzlast als String im Feld textPayload gespeichert wird.
Wenn Sie die Lognutzlast als JSON-Objekt formatieren, können Sie im Log-Explorer nach JSON-Pfaden suchen und diese abfragen. Bei unstrukturierten Logs können Sie den Textstring durchsuchen, aber keine einzelnen Schlüssel abfragen.
Wie strukturierte Logs geschrieben werden
Wie strukturierte Logeinträge in Logging geschrieben werden, hängt von Ihrer Umgebung und der Art der Erfassung Ihrer Logs ab:
- Logging-Clientbibliotheken: Diese Bibliotheken schreiben strukturierte Logs, wenn Sie ein JSON-Objekt oder eine JSON-Zuordnung als Nutzlast übergeben oder wenn sie einzeiliges JSON-Format an
stdoutoderstderrausgeben.
- Google Cloud CLI oder Logging API: Sie können
gcloud logging writemit dem Flag--payload-type=jsonausführen (Beispiel) oder die API-Methodeentries.writemit einemjsonPayload-Objekt aufrufen.
Nächste Schritte
Informationen zum Abfragen und Aufrufen von Logeinträgen finden Sie unter Logs mit dem Log-Explorer ansehen.
Informationen zum Lesen von Logeinträgen mit der gcloud CLI finden Sie unter Logeinträge lesen.
Informationen zum Lesen von Logeinträgen mit der Logging API finden Sie unter der Methode
entries.list.