Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Logabfragen erstellen

Auf dieser Seite wird beschrieben, wie Sie Abfragen im Log-Explorer der Google Cloud Console erstellen, um Logs abzurufen, zu optimieren und zu analysieren.

Hinweis

Wenn Sie die Logs für ein bestimmtes Cloud-Projekt aufrufen möchten, wählen Sie dieses Cloud-Projekt in der Projektauswahl der Google Cloud Console aus und verwenden dann die Legacy-Loganzeige.

Zum Aufrufen der Logs, die Sie von einem Amazon Web Services-Konto (AWS) an Logging senden, wählen Sie das AWS-Verbindungsprojekt in der Projektauswahl der Google Cloud Console aus. verwenden Sie die Legacy-Loganzeige. Im AWS-Verbindungsprojekt wird der Amazon Resource Name (ARN) für Ihr AWS-Konto gespeichert und Ihr AWS-Konto mit Google Cloud-Diensten verknüpft. Weitere Informationen finden Sie unter Projekt oder Konto einem Arbeitsbereich hinzufügen.

Erste Schritte

So gehen Sie zum Log-Explorer:

  1. Rufen Sie das Google Cloud-Navigationsmenü auf und wählen Sie Logging > Log-Explorer aus.
    Zum Log-Explorer
  2. Wählen Sie ein Google Cloud-Projekt aus.
  3. Wechseln Sie vom Menü Upgrade von Legacy-Loganzeige zu Log-Explorer.

Sie befinden sich jetzt im Log-Explorer.

Abfragen erstellen

Im Bereich "Query Builder" haben Sie mehrere Möglichkeiten, um Logs abzurufen:

  1. Drop-down-Menüs in Query Builder
  2. Abfragen, die die Logging-Abfragesprache verwenden
  3. Die Tabs Zuletzt, Gespeichert und Vorgeschlagen.

query-builder-pane

In den folgenden Abschnitten wird beschrieben, wie Sie Abfragen zum Abrufen von Logs erstellen und ausführen.

Drop-down-Menüs in Query Builder

Mit den Drop-down-Menüs können Sie dem Query Builder Abfrageparameter hinzufügen. Sie können die Drop-down-Menüs verwenden, um Ressourcen, Lognamen, Log-Schweregrad und Zeiträume auszuwählen. Diese Optionen entsprechen den LogEntry-Feldern für alle Logging-Logs.

Drop-down-Menüs in Query Builder

  • Ressource: Ermöglicht das Festlegen von resource.type. Sie können jeweils nur eine Ressource auswählen, die Sie dem Query Builder hinzufügen möchten. Einträge verwenden den logischen Operator AND.
  • Logname: Geben Sie den logName an. Sie können mehrere Lognamen gleichzeitig auswählen, um sie dem Query Builder hinzuzufügen. Bei der Auswahl mehrerer Einträge wird der logische Operator OR verwendet.
  • Schweregrad: Hiermit können Sie den Schweregrad angeben. Sie können mehrere Wichtigkeitsstufen gleichzeitig auswählen, um sie in den Abfrageeditor einzufügen. Bei der Auswahl mehrerer Einträge wird der logische Operator OR verwendet.

Um eines der Suchparametermenüs zu verwenden, klappen Sie diese aus und wählen Sie einen oder mehrere Parameter aus. Klicken Sie anschließend auf Hinzufügen.

Klicken Sie nach dem Erstellen der Abfrage auf Abfrage ausführen, um die gewünschten Logeinträge abzurufen.

Abfragen mit Zeitbeschränkung

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

  1. Abfrage mit einem Ausdruck für einen Zeitstempel
  2. Abfrage mit der Auswahl eines Zeitraums

    Log-Explorer bietet zwei Möglichkeiten zum Filtern nach Zeit

Wenn Sie eine Abfrage mit einem Zeitstempel haben, ist die Zeitraumauswahl deaktiviert und die Abfrage verwendet den Zeitstempelausdruck als Zeitraumbeschränkung. Wenn eine Abfrage keinen Zeitstempelausdruck hat, verwendet die Abfrage die Zeitraumauswahl als Zeitraumbeschränkung.

Abfragen, die die Logging-Abfragesprache verwenden

Sie können die Logging-Abfragesprache verwenden, um Abfragen im Bereich des Query Builders für Cloud Logging, imLogging-API oder im Befehlszeilen-Interface zu erstellen.

Weitere Informationen finden Sie unter Logging-Abfragesprache.

Gespeicherte Abfragen

Der Bereich "Query Builder" enthält den Tab Gespeichert. Hier können Sie gespeicherte Abfragen abrufen.

Liste gespeicherter Abfragen

Mit gespeicherten Abfragen können Sie Abfrageausdrücke speichern, um Ihre Logs konsistenter und effizienter zu durchsuchen.

So speichern Sie eine Abfrage, die Sie im Bereich "Query Builder" erstellt haben:

  1. Klicken Sie im Bereich "Query Builder" auf Speichern. Das Dialogfeld Abfrage speichern wird geöffnet. Der Abfrageausdruck befindet sich im Feld Abfrage.

  2. Fügen Sie einen Namen für die Abfrage hinzu.

    Namen sind auf 64 Zeichen beschränkt.

  3. Optional: Wenn Sie der Abfrage Zusammenfassungsfelder hinzufügen möchten, aktivieren Sie Zusammenfassungsfelder einbeziehen.

  4. Optional: Fügen Sie eine Beschreibung für Ihre Abfrage hinzu.

    Beschreibungen sind auf 1.000 Zeichen beschränkt. Geben Sie keine vertraulichen Informationen an.

  5. Wählen Sie im Dialogfeld die Option Abfrage speichern aus.

Ihre gespeicherten Abfragen werden im Bereich "Query Builder" auf dem Tab Gespeichert in einer Liste angezeigt.

Klicken Sie zum Ausführen einer gespeicherten Abfrage auf Abfrage ausführen.

Freigegebene Abfragen

Mit freigegebenen Abfragen können Nutzer eines Projekts ihre gespeicherten Abfragen miteinander teilen.

Die Rollen und Berechtigungen, die zum Aufrufen und Bearbeiten freigegebener Abfragen erforderlich sind, finden Sie auf der Seite "Zugriffssteuerung" im Abschnitt Berechtigungen und Rollen.

Abfrage freigeben

Sie können bereits gespeicherte Abfragen freigeben oder eine neue Abfrage freigeben.

So geben Sie eine neue Abfrage frei:

  1. Geben Sie im Query Builder eine Abfrage ein.

  2. Klicken Sie im Bereich "Query Builder" auf Speichern.

  3. Füllen Sie die Felder im Dialogfeld zum Speichern der Abfrage aus.

  4. Aktivieren Sie Für Projekt freigeben.

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

So teilen Sie eine bereits gespeicherte Abfrage:

  1. Wählen Sie Gespeichert aus.

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

  3. Aktivieren Sie im Dialogfeld zum Bearbeiten der Abfrage die Option Mit Projekt teilen und wählen Sie dann Abfrage aktualisieren aus.

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

Freigegebene Abfragen aufrufen

Um schnell alle freigegebenen Abfragen anzuzeigen, sortieren Sie die Spalte Sichtbarkeit so, dass geteilte Abfragen zuerst angezeigt werden:

  1. Wählen Sie den Tab Gespeichert aus.

  2. Wähle Alle aus.

  3. Sortieren Sie die Spalte Sichtbarkeit.

Sichtbarkeitsspalte ist sortiert

In der Spalte Sichtbarkeit werden Abfragen, die mit Ihnen geteilt sind, von Abfragen, die Sie für andere Nutzer des Projekts freigeben, voneinander getrennt.

Nur Ihre Abfragen anzeigen

Klicken Sie auf min, um freigegebene Abfragen anzusehen, die Sie erstellt oder freigegeben haben. Nun wird eine Liste der Abfragen angezeigt, die Sie erstellt und gespeichert haben. In der Spalte Sichtbarkeit werden Ihre nicht freigegebenen Private-Abfragen angezeigt. Von Ihnen freigegebene Abfragen werden durch Für mich freigegeben gekennzeichnet.

Vorgeschlagene Abfragen

Logging generiert vorgeschlagene Abfragen anhand seiner Kenntnisse der von Ihnen verwendeten Google Cloud-Produkte. Es schlägt Abfragen vor, die Ihnen helfen können, Probleme zu erkennen, und bietet einen Einblick in den Gesamtzustand Ihrer Systeme. Wird beispielsweise festgestellt, dass Sie Google Kubernetes Engine verwenden, kann Logging eine Abfrage vorschlagen, die alle Fehlerlogs für Ihre Container findet.

So zeigen Sie im Query Builder-Bereich vorgeschlagene Abfragen an und führen sie aus:

  1. Klicken Sie auf den Tab Vorgeschlagen.

    Tab "Vorgeschlagene Abfragen", auf dem mehrere Abfragen angezeigt werden

  2. Prüfen Sie die Beschreibung der vorgeschlagenen Abfrage.

  3. Führen Sie einen der folgenden Schritte aus, um die Details einer vorgeschlagenen Suchanfrage anzuzeigen:

    a. Klicken Sie auf die Zeile.

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

  4. Im Query Builder sehen Sie die Abfrage und die Optionen zum Ausführen oder Speichern.

    a. Klicken Sie zum Speichern der Abfrage auf Speichern. Die Abfrage wird in der Liste Gespeichert angezeigt. Dort können Sie die Abfrage später ausführen.

    b. Klicken Sie zum Ausführen der Abfrage auf Run (Ausführen). Die Abfrage wird unter Abfragen-Preview im Query Builder-Fenster angezeigt.

  5. Nachdem Sie die Abfrage überprüft haben, klicken Sie auf Abfrage ausführen. Das Ergebnis der vorgeschlagenen Abfrage wird unter Abfrageergebnisse angezeigt.

Vorgeschlagene Abfragen werden dynamisch basierend auf dem Google Cloud-Projektkontext erstellt. Bei aufeinanderfolgendem Ladevorgängen werden möglicherweise nicht die gleichen Abfragen in derselben Reihenfolge angezeigt. Das ist ganz normal.

Aktuelle Abfragen

Der Bereich "Query Builder" enthält den Tab Aktuell. Wenn Sie eine Abfrage ausführen, wird sie in die Abfrageliste Aktuell aufgenommen, die die letzten 10.000 Abfragen über einen Zeitraum von 30 Tagen enthält.

Der Tab "Aktuell" enthält die letzten Abfragen.

Um die letzten Abfragen anzusehen, wählen Sie im Query Builder-Fenster den Tab Aktuell aus. Auf dem Tab Aktuell stehen folgende Optionen zur Verfügung:

  • Streamen: Streamt Logs basierend auf den angegebenen Abfrageparametern.
  • Ausführen. Führt die Abfrage aus.
  • Weitere Optionen . Hiermit können Sie die Abfrageparameter mit den Optionen zum Ausführen der Abfrage oder zum Speichern in der Liste der Gespeicherten Abfragen anzeigen. Sie können die Abfrage auch direkt auswählen, um diese Optionen aufzurufen.

    Klicken Sie zum Ausführen der Abfrage auf Ausführen.

    Klicken Sie zum Speichern der Abfrage auf Speichern unter und füllen Sie folgende Felder aus:

    • Name (erforderlich): Geben Sie einen Namen an.
    • Beschreibung (optional): Geben Sie eine Beschreibung ein, um den Zweck der Abfrage zu identifizieren.
    • Zusammenfassungsfelder einschließen (optional): Aktivieren Sie Zusammenfassende Felder einschließen und geben Sie die Felder an, die angezeigt werden sollen.
    • Zusammenfassungsfelder kürzen (optional): Aktivieren Sie Zusammenfassungsfelder kürzen und wählen Sie die Anzahl der zu kürzenden Zeichen aus, und ob die Kürzung vom Anfang oder Ende ausgehend erfolgen soll.

    Klicken Sie auf Abfrage speichern. Die Abfrage ist jetzt in der Liste "Gespeicherte Abfragen" verfügbar.

Sie können auch Ihre letzten Abfragen filtern. Der Filter nutzt den Text im Ausdruck Ihrer Abfrage.