In diesem Dokument wird das Konzept des strukturierten Loggings und die Methoden zum Hinzufügen einer Struktur zu den Nutzlastfeldern von Logeinträgen erläutert. Wenn die Log-Nutzlast als JSON-Objekt formatiert und dieses Objekt im Feld jsonPayload gespeichert wird, wird der Logeintrag als strukturiertes Log bezeichnet. Für diese Logs können Sie Abfragen erstellen, mit denen nach bestimmten JSON-Pfaden gesucht wird, und Sie können bestimmte Felder in der Log-Nutzlast indexieren. Wenn die Log-Nutzlast dagegen als String formatiert und im Feld textPayload gespeichert wird, ist der Logeintrag unstrukturiert.
Sie können das Textfeld durchsuchen, aber seinen Inhalt nicht indexieren.
So erstellen Sie strukturierte Logeinträge:
- Rufen Sie die
entries.writeAPI-Methode auf und geben Sie einen vollständig formatiertenLogEntryan. - Verwenden Sie den Befehl
gcloud logging write.
Weitere Informationen zu diesen Ansätzen finden Sie in den folgenden Abschnitten.
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, geben Sie dem Befehl ein serialisiertes JSON-Objekt an.
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
Informationen zum Abfragen und Aufrufen von Logeinträgen finden Sie unter Logs mit dem Log-Explorer aufrufen.
Informationen zum Lesen von Logeinträgen mithilfe der Google Cloud CLI finden Sie unter Logeinträge lesen.
Informationen zum Lesen von Logeinträgen über die Logging API finden Sie unter der
entries.listMethode.