Abfragen im Log-Explorer erstellen

In diesem Dokument wird beschrieben, wie Sie Abfragen im Log-Explorer der Google Cloud Console erstellen, um Logs abzurufen und zu analysieren.

Weitere Informationen zu Abfragen im Log-Explorer finden Sie unter Log-Explorer verwenden.

Hinweis

Wenn Sie die Logs ansehen möchten, die Sie von einem Amazon Web Services-Konto (AWS) an Logging senden, wählen Sie in der Ressourcenauswahl der Google Cloud Console das AWS-Connector-Projekt aus und verwenden Sie dann den Log-Explorer. Das AWS-Verbindungsprojekt speichert den ANR (Amazon Resource Name) für Ihr AWS-Konto und verknüpft Ihr AWS-Konto mit Google Cloud-Diensten. Weitere Informationen finden Sie unter Messwerte für AWS-Konten ansehen.

Prüfen Sie, ob Sie die richtigen IAM-Berechtigungen oder -Rollen zum Erstellen von Abfragen mit dem Log-Explorer haben. Weitere Informationen zu den erforderlichen IAM-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM: Berechtigungen für die Google Cloud Console.

Erste Schritte

Wenn Sie Abfragen mit der Google Cloud Console erstellen möchten, rufen Sie den Log-Explorer auf:

Zu „Log-Explorer“

Wählen Sie das entsprechende Cloud-Projekt oder eine andere Google Cloud-Ressource aus, für die Sie Logs ansehen möchten.

Build-Abfragen

Wenn Sie Abfragen im Log-Explorer erstellen, verwenden Sie in erster Linie den Bereich Abfrage:

Log-Explorer-Abfragebereich

Im Bereich Abfrage können Sie Abfrageausdrücke erstellen und ausführen:

  • Suche in allen Logfeldern nach Text.
  • Wählen Sie Optionen aus den Filtermenüs aus.
  • Erweiterte Abfragen mit der Logging-Abfragesprache schreiben.
  • Sie können die Abfragen auf den Tabs Zuletzt, Gespeichert, Vorschläge und Mediathek aufrufen, bearbeiten oder ausführen.

In den folgenden Abschnitten werden diese Funktionen ausführlicher beschrieben.

In allen Logfeldern nach Text suchen

Wenn Sie nach Text in allen Logfeldern suchen und alle passenden Logeinträge finden möchten, geben Sie Ihre Suchbegriffe in das Suchfeld ein:

Das Suchfeld des Log-Explorers im Abfragebereich

Um Logeinträge zu finden, die eine Wortgruppe enthalten, setzen Sie Ihre Suchbegriffe in Anführungszeichen. Sie können auch boolesche Operatoren in Ihren Suchausdrücken verwenden. Aktivieren Sie Abfrage anzeigen, damit Ihre Suchbegriffe im Abfrageausdruck angezeigt werden.

Nachdem Sie Ihre Suchbegriffe eingegeben haben, klicken Sie auf Abfrage ausführen oder drücken Sie die Eingabetaste. Die Ergebnisse der Abfrage werden im Bereich Abfrageergebnisse angezeigt.

Boolesche Operatoren

Ihre Suchfeldeinträge werden in boolesche Ausdrücke umgewandelt, die eine Teilmenge aller Logeinträge in der ausgewählten Google Cloud-Ressource angeben.

In dem Suchfeld können die booleschen Operatoren AND, OR und NOT verwendet werden. Beachten Sie bei der Verwendung von booleschen Operatoren in den Suchausdrücken Folgendes:

  • Sie können Regeln nicht verwenden, um Regeln zu verschachteln. Alle Klammern im Suchausdruck werden als Suchbegriffe geparst.
  • Sie müssen boolesche Operatoren verwenden. Kleinbuchstaben, and, or und not werden als Suchbegriffe geparst, nicht als Operatoren.

Wenn Sie keine Operatoren verwenden, werden alle Suchbegriffe und Wortgruppen durch AND zusammengeführt. Sie können den Operator AND zwischen den Suchbegriffen weglassen.

Die Operatoren AND und OR sind Kurzschlussbetreiber. Sie können AND- und OR-Regeln im selben Ausdruck kombinieren. Wenn die beiden Operatoren gemischt sind, wird der Ausdruck a AND b OR c AND d in den folgenden Logging-Abfragesprache umgewandelt:

"a"
"b" OR "c"
"d"

Die höchste Priorität hat der Operator NOT, gefolgt von OR und AND – in dieser Reihenfolge.

Der Operator NOT führt eine Negation des nachfolgenden Begriffs aus. Beispiel: NOT error gibt Logeinträge zurück, die error nicht enthalten. Du kannst auch den Operator NOT durch den Operator - (Minus) ersetzen. Die folgenden beiden Abfragen sind beispielsweise identisch:

response AND successful AND NOT error
response successful -error

Diese Logik funktioniert auch mit einer Wortgruppe, wenn der Operator - (Minus) außerhalb der Anführungszeichen steht. Die folgenden beiden Abfragen sind beispielsweise identisch:

-"response successful"
NOT "response successful"

Filtermenüs verwenden

Mit den Filtermenüs im Bereich Abfrage können Sie Parameter für den Ressourcen-, Lognamen- und Logschweregrad zum Abfrageeditor hinzufügen. Diese Optionen entsprechen den BidRequest-Feldern für alle Logs in Logging.

Menüs für den Abfrageeditor filtern

  • Ressource: Hier können Sie den resource.type und den zugehörigen resource.labels angeben. Sie können einen einzelnen Ressourcentyp mit diesem Filtermenü auswählen und null oder mehr Ressourcenlabels für Ihre Abfrage verwenden. Die Ressourcenparameter werden durch den logischen Operator AND verbunden.
  • Logname: Hier können Sie den logName angeben. Sie können mehrere Lognamen auswählen, die auf Ihre Abfrage angewendet werden sollen. Bei der Auswahl mehrerer Lognamen wird der logische Operator OR verwendet.
  • Schweregrad: Hier können Sie den Schweregrad angeben. Sie können mehrere Schweregrade gleichzeitig auswählen, um sie auf Ihre Abfrage anzuwenden. Bei der Auswahl mehrerer Schweregrade wird der logische Operator OR verwendet.

So verwenden Sie Filtermenüs:

  1. Maximieren Sie im Filtermenü im Bereich Query (Abfrage).

  2. Filterparameter optimieren

  3. Klicken Sie auf Anwenden. Sie sehen die Parameter im Abfrageeditor.

    Aktivieren Sie Abfrage anzeigen, damit Ihre Suchbegriffe im Abfrageausdruck angezeigt werden.

  4. Nachdem Sie die Abfrage überprüft haben, klicken Sie auf Abfrage ausführen. Die Ergebnisse der Abfrage werden im Bereich Abfrageergebnisse angezeigt.

Für bestimmte Compute Engine-Ressourcentypen wie gce_instance und gce_network wird der Ressourcenname mit der Ressourcen-ID als Unterstrich angezeigt. Für den Ressourcentyp gce_instance sehen Sie beispielsweise den VM-Namen neben der VM-ID. Die Ressourcennamen helfen Ihnen, die richtige Ressourcen-ID zu identifizieren, auf der Sie Abfragen erstellen können.

Abfragen mit Zeitbeschränkungen schreiben

Es gibt zwei Möglichkeiten, Logs auf der Basis von Zeit abzufragen:

  1. Verwenden Sie dazu die Zeitraumauswahl.
  2. Abfrage mit einem Zeitstempelausdruck im Feld „editor-editor“.

Wenn Sie schnell in Sekunden, Minuten, Stunden oder Tagen abfragen möchten, verwenden Sie die vordefinierten Werte oder geben Sie über die Zeitraumauswahl einen benutzerdefinierten Zeitraum ein.

Verwenden Sie die Logging-Abfragesprache, um dem Abfrageeditor-Feld einen Zeitstempelausdruck direkt hinzuzufügen.

Wenn das Abfrageeditor-Feld einen Ausdruck mit Zeitstempel enthält, ist die Zeitraumauswahl deaktiviert und die Abfrage verwendet den Zeitstempelausdruck als Zeitraumeinschränkung. Wenn eine Abfrage einen Zeitstempelausdruck nicht verwendet, wird für die Abfrage die Zeitraumauswahl als Einschränkung verwendet.

Zeitraumauswahl verwenden

Mit der Zeitraumauswahl können Sie Abfrageergebnisse nach Zeitraum einschränken:

Zeitraumauswahl im Abfragebereich

So verwenden Sie die Zeitraumauswahl:

  1. Klicken Sie im Bereich Abfrage auf die Zeitraumauswahl.

  2. Wählen Sie den Zeitraum aus, für den Sie Logs sehen möchten.

  3. Klicken Sie auf Anwenden. Sie sehen die Parameter im Abfrageeditor.

    Der Bereich Abfrageergebnisse wird an den ausgewählten Zeitraum angepasst.

Der Standardzeitraum beträgt eine Stunde. Mit der Option Zu Zeitpunkt springen können Sie den Zeitraum auf einen bestimmten Zeitstempel beschränken und zentrieren.

Über die Zeitraumauswahl können Sie die regionalen Einstellungen festlegen, einschließlich der Datums- und Uhrzeitformatierung:

  1. Wählen Sie Benutzerdefinierten Zeitraum eingeben aus.
  2. Wähle Datums- und Uhrzeitformat ändern aus.
  3. Aktualisieren Sie Ihre Einstellungen im Menü Sprache &Region.
  4. Klicken Sie auf Speichern.

    Nachdem Sie den Browser aktualisiert haben, werden das bevorzugte Datum und die Uhrzeit im Log-Explorer angezeigt.

Erweiterte Abfragen mit der Logging-Abfragesprache schreiben

Mit der Sprache der Logging-Abfrage können Sie erweiterte Abfragen im Feld „Editor“ des Abfrage-Editors erstellen:

  1. Wenn das Feld „Abfrageeditor“ im Bereich Abfrage nicht angezeigt wird, aktivieren Sie Abfrage anzeigen.

  2. Geben Sie die Abfrageausdrücke direkt in das Feld „Abfrageeditor“ ein.

    Wenn Sie Suchbegriffe in das Suchfeld eingegeben oder Parameter in den Filtermenüs ausgewählt haben, werden diese auch im Abfrageeditor angezeigt und als Teil des Abfrageausdrucks ausgewertet.

  3. Nachdem Sie die Abfrage geprüft haben, klicken Sie auf Abfrage ausführen.

    Logs, die Ihrer Abfrage entsprechen, werden im Bereich Abfrageergebnisse aufgelistet. Die Bereiche Histogramm und Logfelder werden auch entsprechend dem Abfrageausdruck angepasst.

Beispiele für häufig verwendete Abfragen finden Sie unter Beispielabfragen mit dem Log-Explorer.

Letzte Abfragen verwenden

Wenn Sie eine Abfrage ausführen, wird sie Ihrer Letzten Abfrageliste hinzugefügt, die die letzten 10.000 einzelnen Abfragen über einen Zeitraum von 30 Tagen enthält.

Rufen Sie Ihre letzten Abfragen auf, indem Sie im Bereich Abfrage den Tab Letzte auswählen. Auf dem Tab Zuletzt geöffnet haben Sie folgende Möglichkeiten:

  • Stream: Wählen Sie diese Option aus, um die Abfrage auszuführen und die Ergebnisse zu streamen.
  • Ausführen: Wählen Sie diese Option aus, um die Abfrage auszuführen.
  • Weitere Optionen : Hier können Sie den Abfrageausdruck mit den Optionen zum Ausführen der Abfrage ansehen oder sie in der Liste der gespeicherten Abfragen speichern. Sie können die Abfrage auch direkt auswählen, um diese Optionen aufzurufen.

    So speichern Sie die Abfrage:

    1. Klicken Sie auf Speichern unter. Das Dialogfeld Abfrage speichern wird geöffnet.
    2. Füllen Sie die folgenden Felder aus:

      • Name (erforderlich): Geben Sie einen Namen für Ihre Abfrage ein. Namen sind auf 64 Zeichen begrenzt.
      • Beschreibung (optional): Geben Sie eine Beschreibung ein, um den Zweck der Abfrage zu identifizieren.
      • Zusammenfassungsfelder einschließen (optional): Aktivieren Sie die Option Zusammenfassungsfelder einschließen und geben Sie die Zusammenfassungsfelder ein, die angezeigt werden sollen.
      • Zusammenfassungsfelder kürzen (optional): Aktivieren Sie die Option Zusammenfassungsfelder kürzen und wählen Sie die Anzahl der Zeichen aus, die abgeschnitten werden sollen und ob sie am Anfang oder Ende der Felder abgeschnitten wird.
    3. Klicken Sie auf Abfrage speichern. Die Abfrage ist jetzt in der Liste "Gespeicherte Abfragen" verfügbar.

Sie können Ihre letzten Suchanfragen auch sortieren und filtern; der Filter entspricht dem Text in Ihrem Abfrageausdruck.

Abfragen speichern

Der Bereich Abfrage enthält den Tab Gespeichert, auf dem Sie auf Ihre gespeicherten Abfragen zugreifen können. Mit gespeicherten Abfragen können Sie Abfrageausdrücke speichern, damit Sie Ihre Logs konsistenter und effizienter untersuchen können.

So speichern Sie einen Abfrageausdruck, den Sie im Abfrageeditor-Feld erstellt haben:

  1. Klicken Sie im Bereich Abfrage auf Speichern. Das Dialogfeld Abfrage speichern wird geöffnet, in dem sich Ihr Abfrageausdruck im Feld „Abfrageeditor“ befindet.

  2. Füllen Sie die folgenden Felder aus:

    • Name (erforderlich): Geben Sie einen Namen für Ihre Abfrage ein. Namen sind auf 64 Zeichen begrenzt.
    • Beschreibung (optional): Geben Sie eine Beschreibung ein, um den Zweck der Abfrage zu identifizieren.
    • Zusammenfassungsfelder einschließen (optional): Aktivieren Sie die Option Zusammenfassungsfelder einschließen und geben Sie die Zusammenfassungsfelder ein, die angezeigt werden sollen.
    • Zusammenfassungsfelder kürzen (optional): Aktivieren Sie die Option Zusammenfassungsfelder kürzen und wählen Sie die Anzahl der Zeichen aus, die abgeschnitten werden sollen und ob sie am Anfang oder Ende der Felder abgeschnitten wird.
    1. Klicken Sie auf Abfrage speichern. Ihre gespeicherten Abfragen werden in einer Liste auf dem Tab Gespeichert angezeigt.

Klicken Sie auf Ausführen, um eine gespeicherte Abfrage auszuführen. Zum Ausführen der Abfrage und zum Streamklicken Sie auf Stream.

Sie können Ihre gespeicherten Abfragen auch sortieren und filtern. Der Filter entspricht dann dem Text in Ihrem Abfrageausdruck.

Abfragen freigeben

Mit freigegebenen Abfragen können Nutzer eines Cloud-Projekts ihre gespeicherten Abfragen miteinander teilen. Sie können sich freigegebene Abfragen auf dem Tab Gespeichert ansehen.

Die erforderlichen Rollen und Berechtigungen zum Ansehen und Bearbeiten freigegebener Abfragen finden Sie unter Berechtigungen für die Google Cloud Console. Nutzer mit der IAM-Rolle roles/logging.admin oder roles/editor können andere Abfragen bearbeiten.

Freigegebene Abfrage erstellen

Sie können Abfragen speichern, die Sie bereits gespeichert haben, oder eine neue Abfrage freigeben.

So erstellen Sie eine Abfrage und geben sie frei:

  1. Geben Sie eine Abfrage in das Feld „Abfrageeditor“ ein.

  2. Klicken Sie auf Speichern.

  3. Füllen Sie die Felder im Dialogfeld Abfrage speichern aus.

  4. Aktivieren Sie die Option Mit Projekt freigeben.

  5. Klicken Sie auf Abfrage speichern.

Ihre Abfrage wird jetzt für andere Nutzer des Cloud-Projekts freigegeben.

So geben Sie eine bereits gespeicherte Abfrage frei:

  1. Wählen Sie den Tab Gespeichert.

  2. Wählen Sie Weitere Optionen > Bearbeiten aus oder wählen Sie die Abfrage direkt aus.

  3. Aktivieren Sie im Dialogfeld Abfrage bearbeiten die Option Für Projekt freigeben und klicken Sie dann auf Abfrage aktualisieren.

Ihre Abfrage wird jetzt für andere Nutzer des Cloud-Projekts freigegeben.

Freigegebene Abfragen ansehen

Wenn Sie schnell alle freigegebenen Abfragen aufrufen möchten, sortieren Sie die Spalte Sichtbarkeit so, dass freigegebene Abfragen zuerst angezeigt werden:

  1. Wählen Sie den Tab Gespeichert.

  2. Klicken Sie auf Alle.

  3. Sortieren Sie die Spalte Sichtbarkeit.

In der Spalte Sichtbarkeit ist angegeben, ob und wie Abfragen freigegeben werden:

  • Von mir freigegeben: Abfragen, die Sie gespeichert und für andere Nutzer des Cloud-Projekts freigegeben haben.
  • Freigegeben: Abfragen, die andere Nutzer des Cloud-Projekts freigegeben haben
  • Privat: Abfragen, die Sie gespeichert haben und nicht für andere Nutzer des Cloud-Projekts freigegeben haben.

Nur Ihre Abfragen anzeigen

Um sich gespeicherte Abfragen anzusehen, die Sie erstellt oder freigegeben haben, klicken Sie auf Eigene. Sie sehen jetzt eine Liste mit Abfragen, die Sie erstellt und gespeichert haben. In der Spalte Sichtbarkeit sehen Sie Ihre nicht freigegebenen privaten Abfragen. Abfragen, die Sie freigegeben haben, sind durch Von mir freigegeben gekennzeichnet.

Vorgeschlagene Abfragen verwenden

Logging generiert vorgeschlagene Abfragen, die auf dem Kontext Ihres Cloud-Projekts beruhen, z. B. den von Ihnen verwendeten Google Cloud-Produkten. Vorgeschlagene Abfragen können Ihnen dabei helfen, Probleme zu erkennen und Einblicke in den Gesamtzustand Ihrer Systeme zu erhalten. Wenn Sie z. B. erkennen, dass Sie Google Kubernetes Engine verwenden, schlägt Logging eine Abfrage vor, die alle Fehlerlogs für Ihre Container findet.

Wenn Sie vorgeschlagene Abfragen ansehen und ausführen möchten, wählen Sie im Bereich Abfrage den Tab Vorschläge aus. Der Tab Vorgeschlagen enthält eine Liste von Abfragen mit Beschreibungen und den folgenden Optionen:

  • Stream: Wählen Sie diese Option aus, um die Abfrage auszuführen und die Ergebnisse zu streamen.
  • Ausführen: Wählen Sie diese Option aus, um die Abfrage auszuführen.
  • Weitere Optionen : Hiermit können Sie die Details des Abfrageausdrucks mit den Optionen zum Ausführen der Abfrage oder Speichern der Abfrage ansehen. Sie können die Abfrage auch direkt auswählen, um diese Optionen aufzurufen.

    Sie haben folgende Möglichkeiten, die Details einer vorgeschlagenen Abfrage zu prüfen:

    • Abfragezeile auswählen

    • Klicke auf Mehr und wähle Anzeigen aus. Das Dialogfeld Abfragedetails wird geöffnet.

    Im Dialogfeld Abfragedetails werden die Abfrage und die Optionen zum Ausführen, Streamen oder Speichern unter angezeigt:

    • So speichern Sie die Abfrage:

      1. Klicken Sie auf Speichern unter.
      2. Füllen Sie die Felder im Dialogfeld Abfrage speichern aus.

      Die bearbeitete Abfrage wird in der Liste Gespeichert angezeigt, wo Sie die Abfrage später ausführen können.

    • Klicken Sie auf Ausführen, um die Abfrage jetzt auszuführen. Die Abfrage wird ausgeführt und im Feld „Abfrageeditor“ angezeigt.

    • Klicken Sie auf Stream, um die Abfrage jetzt auszuführen und die Ergebnisse zu streamen.

    • Klicken Sie auf Schließen, um das Dialogfeld zu schließen und zur vorgeschlagenen Abfrage zurückzukehren.

Achten Sie auf das erwartete Verhalten:

  • Aufeinanderfolgende Seitenladevorgänge zeigen möglicherweise nicht dieselben Abfragen in derselben Reihenfolge an.
  • Daher sehen Sie möglicherweise keine Vorschläge für Suchanfragen.
  • Manchmal werden bei der Ausführung einer vorgeschlagenen Abfrage null Logs zurückgegeben.

Abfragen aus der Mediathek auswählen

Logging bietet eine Bibliothek mit Abfragen basierend auf gängigen Anwendungsfällen und Google Cloud-Produkten. Diese Abfragen können Ihnen dabei helfen, Logs bei zeitkritischen Sitzungen effizient zu finden und Ihre Logs zu analysieren, um mehr über die verfügbaren Logging-Daten zu erfahren.

So rufen Sie die Abfragen der Mediathek auf und führen sie aus:

  1. Wählen Sie im Bereich Abfrage den Tab Bibliothek aus.

  2. In der Spalte Alle Abfragen werden allgemeine Kategorien verfügbarer Suchanfragen und Teilmengen von Abfragen angezeigt, die auf Google Cloud-Produkten basieren. Wenn Sie die Auswahl der angezeigten Abfragen eingrenzen möchten, klicken Sie auf eines der Produkte.

    Sie können das Suchfeld auch verwenden, um die verfügbaren Abfragen nach Kategorie, Beschreibung oder dem Inhalt des Abfrageausdrucks zu suchen.

  3. Sie haben folgende Möglichkeiten, einen Abfrageausdruck zu prüfen:

    a. Klicken Sie auf die Zeile der Abfrage.

    b. Klicken Sie auf das Dreipunkt-Menü und wählen Sie Ansehen aus.

  4. Im Dialogfeld Abfragedetails werden die Abfrage und die Optionen Ausführen, Streamen oder Speichern unter angezeigt:

    • So speichern Sie die Abfrage:

      1. Klicken Sie auf Speichern unter.
      2. Füllen Sie die Felder im Dialogfeld Abfrage speichern aus.

      Die bearbeitete Abfrage wird in der Liste Gespeichert angezeigt, wo Sie die Abfrage später ausführen können.

    • Klicken Sie auf Ausführen, um die Abfrage jetzt auszuführen. Die Abfrage wird ausgeführt und im Feld „Abfrageeditor“ angezeigt.

    • Klicken Sie auf Stream, um die Abfrage jetzt auszuführen und die Ergebnisse zu streamen.

    • Klicken Sie auf Schließen, um das Dialogfeld zu schließen und zur vorgeschlagenen Abfrage zurückzukehren.