Strukturiertes Logging

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 stdout oder stderr ausgeben.

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.