Strukturiertes Logging

In diesem Dokument wird das Konzept des strukturierten Loggings und die Methoden zum Hinzufügen von Struktur zu Nutzlastfeldern für Logeinträge beschrieben. Wenn die Log-Nutzlast als JSON-Objekt formatiert ist und dieses Objekt im Feld jsonPayload gespeichert wird, wird der Logeintrag als strukturierter Log bezeichnet. Für diese Logs können Sie Abfragen erstellen, mit denen Sie nach bestimmten JSON-Pfaden suchen, und bestimmte Felder in der Log-Nutzlast indexieren. Wenn die Lognutzlast dagegen als String formatiert und im Feld textPayload gespeichert ist, ist der Logeintrag unstrukturiert. Sie können das Textfeld durchsuchen, aber seinen Inhalt nicht indexieren.

Sie haben folgende Möglichkeiten, um strukturierte Logeinträge zu erstellen:

  • Rufen Sie die API-Methode entries.write auf und geben Sie eine vollständig formatierte LogEntry an.
  • Führen Sie den Befehl gcloud logging write aus.
  • Verwenden Sie eine Cloud Logging-Clientbibliothek, die strukturierte Logs schreibt.

Logs mit der gcloud CLI schreiben

Sie können Logdaten mit der gcloud CLI schreiben. Die Schnittstelle unterstützt unstrukturierte und strukturierte Logs. Wenn Sie ein strukturiertes Log schreiben möchten, stellen Sie dem Befehl ein serialisiertes JSON-Objekt zur Verfügung.

Eine Kurzanleitung finden Sie unter Logeinträge mit der Google Cloud CLI schreiben und abfragen.

Codebeispiele finden Sie in der gcloud logging write-Referenz.

Nächste Schritte