Logeinträge mit der gcloud CLI schreiben und abfragen

Logeinträge mit der gcloud CLI schreiben

Logging unterstützt Logeinträge mit strukturierten und unstrukturierten Daten. Strukturierte Daten bestehen aus einer JSON-Datenstruktur, z. B. {"weather": "partly cloudy"}. Unstrukturierte Daten sind Strings, wie zum Beispiel "A simple entry".

In den nächsten Schritten verwenden Sie die gcloud CLI, um einen Logeintrag mit unstrukturierten Daten und einen Logeintrag mit strukturierten Daten zu schreiben. Die gcloud CLI bietet eine Befehlszeile für die Cloud Logging API.

1. Wenn Sie einen Logeintrag mit unstrukturierten Daten in das Log my-test-log schreiben möchten, führen Sie den Befehl gcloud logging write aus:

   gcloud logging write my-test-log "A simple entry."
   

   Nach Verarbeitung des Befehls wird die folgende Meldung angezeigt: Created log entry.

2. Schreiben Sie einen Logeintrag mit strukturierten Daten in das Log my-test-log:

   gcloud logging write --payload-type=json my-test-log '{ "message": "My second entry", "weather": "partly cloudy"}'
   

   Zum Schreiben eines Logeintrags mit strukturierten Daten müssen Sie --payload-type=json angeben. Wenn Sie dieses Feld weglassen, interpretiert Logging die Nutzlast als unstrukturierte Daten.

Wenn das Log my-test-log nicht vorhanden ist, wird es von Logging erstellt, sobald der Logeintrag empfangen wird.

Logeinträge mit der gcloud CLI auflisten

Sie können Logeinträge aus Logging abrufen und mit der gcloud CLI anzeigen. Führen Sie beispielsweise den folgenden Befehl aus, um die Logeinträge mit dem Ressourcentyp global abzurufen und anzuzeigen:

gcloud logging read "resource.type=global"

Das Ergebnis des Befehls sollte in etwa so aussehen:

---
insertId: jpj9zjf73t1mn
jsonPayload:
  message: My second entry
  weather: partly cloudy
logName: projects/myloggingproject/logs/my-test-log
receiveTimestamp: '2018-11-01T18:39:31.114507977Z'
resource:
  labels:
    project_id: myloggingproject
  type: global
timestamp: '2018-11-01T18:39:31.114507977Z'
---
insertId: vd4m1if7h7u1a
logName: projects/myloggingproject/logs/my-test-log
receiveTimestamp: '2018-11-01T18:39:19.718100792Z'
resource:
  labels:
    project_id: myloggingproject
  type: global
textPayload: A simple entry
timestamp: '2018-11-01T18:39:19.718100792Z'

Informationen zum Lesen von Logs finden Sie in der gcloud logging read-Referenzdokumentation.

Logeinträge im Log-Explorer abfragen

Wenn Sie Logeinträge in der Cloud de Confiance Console aufrufen möchten, können Sie den Log-Explorer verwenden. In den meisten Cloud de Confiance Projekten werden viele Logs gespeichert. Sie können bestimmte Logeinträge auswählen, indem Sie eine Abfrage schreiben.

So rufen Sie die Logeinträge auf, die Sie mit dem Log-Explorer geschrieben haben:

1. Rufen Sie in der Cloud de Confiance Console das Segment und die Seite Log-Explorer auf:

   Zum Log-Explorer

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

   Achten Sie darauf, dass Ihr Cloud de Confiance Projekt in der Cloud de Confiance by S3NSNavigationsleiste ausgewählt ist. Wählen Sie bei Bedarf Ihr Cloud de Confiance Projekt aus der Drop-down-Liste Cloud de Confiance aus.

2. Wählen Sie im Menü Ressource die Option Global aus.

   Wenn die Menüoption Global oder Ihre Logeinträge nicht angezeigt werden, warten Sie einige Minuten und aktualisieren Sie dann die Seite. Der Empfang von Logeinträgen durch Logging kann einige Minuten dauern.

3. Klicken Sie auf das chevron_right Menü eines Logeintrags, um die Details aufzurufen.

   Die Daten des ersten Logeintrags werden in textPayload gespeichert. Der zweite Logeintrag enthält strukturierte Daten, die in jsonPayload gespeichert sind. Die strukturierte Nutzlast enthält die Schlüssel message und weather.

Informationen zum Datenformat von Logeinträgen finden Sie unter LogEntry-Typ.

Logeinträge im Log-Explorer abfragen

Sie können Logeinträge über den Abfrageeditor und bei strukturierten Logs nach Schlüssel und Wert abfragen. Wenn Sie beispielsweise alle Logeinträge aufrufen möchten, die den Text simple enthalten, gehen Sie so vor:

1. Rufen Sie in der Cloud de Confiance Console das Segment und die Seite Log-Explorer auf:

   Zum Log-Explorer

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

2. Wählen Sie im Menü Ressource die Option Global aus.

3. Geben Sie im Abfrageeditor den String simple in Anführungszeichen ein. In der Loganzeige wird nur der Logeintrag A simple entry. angezeigt.

4. Nachdem Sie das Log aufgerufen haben, entfernen Sie den hinzugefügten Query-String und klicken Sie auf Abfrage ausführen. Beide Log-Einträge werden wieder in der Anzeige dargestellt.

So rufen Sie alle Logeinträge mit strukturierten Daten auf, die den Schlüssel weather haben, wobei das Feld value den Wert partly enthält:

1. Der Abfrageeditor enthält die Zeile resource.type="global". Geben Sie den folgenden Befehl ein:

   jsonPayload.weather:partly
   

2. Klicken Sie auf Abfrage ausführen. Das Ergebnis ist der einzelne Logeintrag My second entry:

Der Log-Explorer bietet auch gespeicherte, vorgeschlagene und aktuelle Abfragen. Weitere Informationen zu Abfragen finden Sie unter Abfragen im Log-Explorer erstellen.

Beispielabfragen finden Sie unter Beispielabfragen mit dem Log-Explorer.

Fehlerbehebung

• Tippfehler und unbekannte Feldnamen führen dazu, dass die gcloud CLI-Befehle mit invalid argument-Meldungen abgeschlossen werden. Wenn Sie beispielsweise den Punkt in resource.type vergessen, wird der folgende Fehler ausgegeben:

   ERROR: (gcloud.logging.read) INVALID_ARGUMENT: Field not found: 'resourcetype'.
  

• Wenn Cloud Logging nicht die erforderlichen Zugriffsberechtigungen erteilt wurden, werden die gcloud CLI-Befehle mit permission denied-Meldungen abgeschlossen. Wenn beispielsweise eine Compute Engine-VM-Instanz mit den Standard-API-Einstellungen konfiguriert ist, wird der Befehl list mit einem Fehler vom Typ „Permission denied“ abgeschlossen:

   ERROR: (gcloud.logging.read) PERMISSION_DENIED: Request had insufficient authentication scopes.
  

  Um dieses Problem zu beheben, ändern Sie die Berechtigungen Ihrer Compute Engine-VM-Instanz, um Cloud Logging die Leseberechtigung zu erteilen. Gehen Sie dazu so vor:

  1. Gehen Sie zur Seite VM-Instanzdetails Ihrer VM-Instanz. Klicken Sie auf Beenden. Es kann ein bis zwei Minuten dauern, bis der Vorgang abgeschlossen ist.
  2. Klicken Sie auf Bearbeiten, um die Konfiguration zu ändern.
  3. Suchen Sie nach dem Header Zugriffsbereiche für Cloud API und klicken Sie auf Details, um sich die Einstellungen für jede API anzeigen zu lassen. Ändern Sie den Eintrag für die Cloud Logging API zu Vollständiger Zugriff. Klicken Sie dann auf Speichern.
  4. Klicken Sie auf Starten, um die VM-Instanz neu zu starten. Nach wenigen Augenblicken ist die VM einsatzbereit.