Logs mit dem Log-Explorer aufrufen

Dieses Dokument bietet Ihnen eine Übersicht über den Log-Explorer in der Google Cloud Console, mit dem Sie Logdaten abrufen, ansehen und analysieren können. Mit dem Log-Explorer können Sie Ihre Logs suchen und anzeigen, um Probleme zu beheben. Sie können Logs auch mit der Logging API und der Google Cloud CLI lesen.

Jedes Element des Histogramms zeigt die ungefähre Anzahl von Logeinträgen an, die in dem mit dem Element verknüpften Zeitintervall empfangen wurden. Um die genaue Anzahl der innerhalb eines Zeitintervalls empfangenen Logeinträge zu erhalten, verwenden Sie Log Analytics oder kopieren Sie Logs in einen Cloud Storage-Bucket.

Wenn Sie zusammengefasste Vorgänge für Ihre Logeinträge ausführen möchten, z. B. die Anzahl der Logeinträge mit einem bestimmten Muster, müssen Sie den Log-Bucket auf die Verwendung von Loganalysen aktualisieren und dann Abfragen über die Seite Loganalysen ausführen. Sie können den Log-Explorer weiterhin verwenden, um Logs in Log-Buckets anzusehen, die auf Loganalysen aktualisiert wurden. Weitere Informationen finden Sie unter Übersicht über Loganalysen.

Mehr erfahren

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, damit Sie die erforderlichen Berechtigungen zum Ansehen von Logs im Log-Explorer erhalten:

  • Sehen Sie sich alle Logs im Bucket _Required und Logs in der Ansicht _Default des Buckets _Default an: Loganzeige (roles/logging.viewer) für Ihr Projekt.
  • Sehen Sie sich alle Logs in den Buckets _Required und _Default an, einschließlich Datenzugriffslogs: Betrachter privater Logs (roles/logging.privateLogViewer) für Ihr Projekt.
  • Sehen Sie sich Logs an, die in einer Logansicht eines benutzerdefinierten Log-Buckets gespeichert sind: Zugriffsfunktion für Logansichten (roles/logging.viewAccessor) für das Projekt, das den benutzerdefinierten Bucket enthält. Wenn Sie die Rolle „Accessor Accessor“ ohne Bedingungen haben, können Sie Logs aufrufen, die in einer beliebigen Logansicht für benutzerdefinierte Log-Buckets gespeichert sind. Ein Beispiel finden Sie unter Logs aus einem Bucket lesen.
  • Eingeschränkte LogEntry-Felder in einem Bucket ansehen: Zugriffsfunktion für Logfelder (roles/logging.fieldAccessor) in Ihrem Projekt aufrufen. Weitere Informationen finden Sie unter Zugriff auf Feldebene konfigurieren.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

So beginnen Sie mit der Verwendung des Log-Explorers:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Logging und anschließend Log-Explorer aus:

    Zum Log-Explorer

  2. Wählen Sie das entsprechende Google Cloud-Projekt aus.

    Wenn Sie Amazon Web Services Elastic Compute Cloud (AWS EC2) verwenden, befinden sich Ihre Logeinträge im AWS-Connector-Projekt, das Ihr AWS-Konto mit Google Cloud-Diensten verknüpft.

Oberfläche des Log-Explorers

Über die Benutzeroberfläche des Log-Explorers können Sie Logs abrufen, Logdaten parsen und analysieren und Ihre Abfrageparameter verfeinern.

Benutzeroberfläche für den Log-Explorer

Der Log-Explorer enthält die folgenden Abschnitte, die auf dieser Seite ausführlich beschrieben werden:

  1. Symbolleiste Aktion
  2. Bereich Abfrage
  3. Symbolleiste Ergebnisse
  4. Bereich Logfelder
  5. Histogramm
  6. Bereich Abfrageergebnisse

Symbolleiste für Aktionen

Mit den Funktionen der Symbolleiste Aktion haben Sie folgende Möglichkeiten:

  • Bereich eingrenzen: Definieren Sie die Suche anhand von Logs im aktuellen Google Cloud-Projekt oder nach einer oder mehreren Speicheransichten. Weitere Informationen zum Geltungsbereich finden Sie unter Bereich eingrenzen.
  • Lernen: Hier finden Sie Links zu relevanter Dokumentation und Themen.
  • Link teilen: Erstellen Sie eine verkürzte URL der Abfrage und kopieren Sie sie in die Zwischenablage, um das Teilen der Abfrage zu erleichtern. Bei der kopierten URL wird der entsprechende absolute Zeitraum durch den Zeitraum Ihrer Abfrage dargestellt, z. B. 7:49:37 PM - 8:49:37 PM.

Bereich eingrenzen

Wenn Ihre Logs in Log-Buckets gespeichert sind, können Sie diese im Log-Explorer ansehen. Je nach ausgewähltem Projekt müssen Sie möglicherweise den Bereich des Log-Explorers anpassen, um Logs anzuzeigen, die in bestimmten Log-Buckets gespeichert sind.

Standardmäßig zeigt der Log-Explorer alle Logs an, die von Ressourcen im aktuellen Projekt generiert wurden oder direkt an das aktuelle Projekt weitergeleitet und dann in einem Log-Bucket gespeichert werden. Im Log-Explorer werden standardmäßig keine Logs angezeigt, die von Ressourcen in einem anderen Projekt generiert und dann an einen Log-Bucket im aktuellen Projekt weitergeleitet wurden.

Um festzulegen, welche Logs im Log-Explorer angezeigt werden, verwenden Sie die Schaltfläche Bereich optimieren in der Symbolleiste Aktion:

  • Zum Aufrufen aller Logs, die im aktuellen Projekt generiert oder direkt an das aktuelle Projekt weitergeleitet wurden, wählen Sie Umfang nach aktuellem Projekt aus.

    Eine Logsenke kann Logs an einen Log-Bucket im aktuellen Projekt, an einen Log-Bucket in einem anderen Projekt oder an ein anderes Projekt weiterleiten. Weitere Informationen finden Sie unter Logs an unterstützte Ziele weiterleiten.

  • Wenn Sie bestimmte Logs aufrufen möchten, die in Log-Buckets im aktuellen Projekt gespeichert sind, wählen Sie Bereich nach Speicher und dann eine oder mehrere Logansichten aus. Verwenden Sie diese Option, wenn Sie genauer steuern möchten, wer Zugriff auf welche Logs in den Log-Buckets im aktuellen Projekt hat.

    Weitere Informationen zum Erstellen und Verwalten von Logansichten finden Sie unter Logansichten für einen Log-Bucket konfigurieren.

  • Wenn Sie bestimmte Logs aufrufen möchten, die in Log-Buckets gespeichert sind, die sich in verschiedenen Projekten befinden, wählen Sie Bereich nach Speicher aus, klicken Sie in der Auswahl für die Projekt- und Logansicht auf Projekt importieren und wählen Sie eine oder mehrere Logansichten aus. Verwenden Sie diese Option, wenn Ihre Organisation mehrere Projekte hat, die jeweils eigene eindeutige Logs generieren, und Sie diese Logs zusammen im Log-Explorer ansehen möchten.

    Wenn Sie beispielsweise alle in einem Log-Bucket gespeicherten Logs ansehen möchten, wählen Sie die Ansicht _AllLogs aus:

    Dialogfeld zum Optimieren des Bereichs mit der Auswahl für die Projekt- und Logansicht.

Bereich Abfrage

Verwenden Sie die Features des Bereichs Abfrage, um Folgendes zu tun:

  • Tab Abfrage: Sie können Abfragen mithilfe der folgenden Funktionen erstellen und optimieren:

    • Zeitraumauswahl: Geben Sie einen Zeitraum für die Logs an, die Sie sich ansehen möchten. Weitere Informationen finden Sie unter Zeitraumauswahl verwenden.

    • Suchfeld: Hiermit suchen Sie nach Logeinträgen, die Ihren Suchbegriffen oder Wortgruppen entsprechen. Weitere Informationen finden Sie unter Nach Text in Logfeldern suchen.

    • Filtermenüs: Erstellen Sie Abfragen basierend auf Ressource, Logname und Schweregrad. Weitere Informationen finden Sie unter Filtermenüs verwenden.

    • Feld im Abfrageeditor: Erstellen Sie erweiterte Abfragen mit der Logging-Abfragesprache. Weitere Informationen finden Sie unter Erweiterte Abfragen schreiben.

  • Tab Zuletzt ausgeführt: Hier sehen Sie Abfragen, die Sie zuletzt ausgeführt haben. Weitere Informationen finden Sie unter Letzte Abfragen verwenden.

  • Tab Gespeichert: Hier finden Sie Ihre gespeicherten Abfragen und Abfragen, die andere Nutzer des Google Cloud-Projekts für Sie freigegeben haben. Weitere Informationen finden Sie unter Abfragen speichern und Abfragen freigeben.

  • Tab Vorschläge: Sehen Sie sich vorgeschlagene Abfragen basierend auf den Ressourcen in Ihrem Google Cloud-Projekt an. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen verwenden.

  • Tab Bibliothek: Hier können Sie von Google bereitgestellte Abfragen basierend auf Ihren Anwendungsfällen aufrufen und ausführen. Weitere Informationen finden Sie unter Abfragen aus der Bibliothek auswählen.

  • Speichern: Speichert Abfragen, die auf dem Tab Gespeichert angezeigt und ausgeführt werden können.

  • Abfrage löschen: Löscht die Auswahl, die Sie beim Erstellen einer Abfrage im Bereich Abfrage getroffen haben, und setzen Sie sie zurück.

  • Logs streamen: Logeinträge ansehen, während Logging sie in Log-Buckets speichert Weitere Informationen finden Sie unter Logs streamen.

  • Abfrage ausführen: Führen Sie Ihre Abfragen aus, nachdem Sie sie im Bereich Abfrage erstellt haben.

Wenn das Feld des Abfrageeditors nicht angezeigt wird, aktivieren Sie Abfrage anzeigen. Wenn Sie Suchbegriffe in das Suchtextfeld eingeben, werden diese Begriffe auch im Feld des Abfrageeditors angezeigt und als Teil des Abfrageausdrucks ausgewertet.

Nachdem Sie die Abfrage überprüft haben, klicken Sie auf Abfrage ausführen. Logs, die mit Ihrer Abfrage übereinstimmen, werden im Bereich Abfrageergebnisse aufgeführt. Die Bereiche Histogramm und Logfelder werden ebenfalls gemäß dem Abfrageausdruck angepasst.

Logs streamen

Sie können Logs streamen, da Logging sie in Log-Buckets speichert, oder Sie können eine Abfrage hinzufügen, um nur die Logs zu streamen, die der Abfrage entsprechen.

Wenn Sie Logs basierend auf einer Abfrage streamen möchten, fügen Sie im Bereich Abfrage eine Abfrage hinzu und wählen Sie dann Logs streamen aus. Da Logging die Logdaten in Log-Buckets speichert, werden im Bereich Abfrageergebnisse nur die Logs angezeigt, die der Abfrage entsprechen. Wenn keine Abfrage angegeben ist, zeigt Logging jedes Log so an, wie es gespeichert wurde.

Klicken Sie auf Streaming beenden oder scrollen Sie im Bereich Abfrageergebnisse, um das Streaming zu beenden.

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse stehen folgende Optionen zur Verfügung:

  • Log-Feld: Blendet den Bereich Log-Feld im Seitenlayout des Log-Explorers ein oder aus. Weitere Informationen finden Sie in diesem Dokument im Abschnitt Bereich Logfeld.
  • Histogramm: Sie können den Bereich Histogramm im Seitenlayout „Log-Explorer“ ein- oder ausblenden. Weitere Informationen finden Sie in diesem Dokument im Abschnitt Histogramm.
  • Ergebnisse analysieren: Fassen Sie Ihre Abfrageergebnisse mithilfe von Loganalysen zusammen und stellen Sie sie in einem Diagramm dar. Diese Schaltfläche ist nur sichtbar, wenn der ausgewählte Bereich einen Log-Bucket enthält, der für die Verwendung von Loganalysen aktualisiert wurde. Weitere Informationen finden Sie in diesem Dokument im Abschnitt Ergebnisse analysieren.
  • Messwert erstellen: Richten Sie einen logbasierten Messwert ein.
  • Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigung ein.
  • Zu jetzt springen: Die Abfrageergebnisse werden erzwungen, sodass die aktuelle Uhrzeit enthalten ist. Wenn für die Zeitraumauswahl ein benutzerdefinierter Bereich verwendet und eine Endzeit festgelegt ist, wird die Abfrage mit einem Standardzeitraum von einer Stunde ausgeführt. Andernfalls wird die Abfrage mit dem aktuellen Startdatum oder der aktuellen Dauer aktualisiert und die Abfrage ausgeführt. Der Abfrageausdruck wird bei Verwendung dieser Funktion nicht geändert.
  • Weitere Aktionen: Verwenden Sie diese zusätzlichen Optionen, um logbasierte Benachrichtigungen zu verwalten oder eine Senke zu erstellen.

Ergebnisse analysieren

Sie können Ihre Logdaten mithilfe von SQL-Abfragen auf der Seite Loganalysen aggregieren, analysieren und in Diagrammen darstellen, wenn Ihr Projekt Log-Buckets enthält, die auf die Verwendung von Loganalysen aktualisiert wurden. Wenn Sie vom Log-Explorer zur Seite „Loganalysen“ wechseln möchten, klicken Sie in der Symbolleiste Ergebnisse auf Ergebnisse analysieren.

Die Schaltfläche Ergebnisse analysieren ist nur sichtbar, wenn der ausgewählte Bereich einen Log-Bucket enthält, der für die Verwendung von Loganalysen aktualisiert wurde. Wenn Sie beispielsweise Bereich nach Speicherbereich mithilfe der Schaltfläche Bereich eingrenzen ausgewählt haben, wird die Schaltfläche Ergebnisse analysieren angezeigt, wenn für mindestens ein Bucket im Speicherbereich ein Upgrade auf Loganalysen durchgeführt wurde. Informationen zum Upgrade eines Log-Buckets auf die Verwendung von Log Analytics finden Sie unter Log-Bucket auf die Verwendung von Log Analytics upgraden.

Wenn Sie auf Ergebnisse analysieren klicken, geschieht Folgendes:

  • Der Zeitraum im Log-Explorer wird möglicherweise automatisch angepasst, sodass auf der Seite Loganalysen aussagekräftige Logdaten zur Verfügung stehen.

  • Die Seite Loganalysen wird in einem neuen Tab geöffnet und übersetzt die aktuelle Abfrage in der Logging-Abfragesprache automatisch in eine SQL-Abfrage.

  • Der im Log-Explorer ausgewählte Bereich wird in eine entsprechende FROM-Klausel in der SQL-Abfrage konvertiert:

    • Wenn Sie Bereich nach aktuellem Projekt ausgewählt haben, werden die Buckets _Required und _Default abgefragt.

    • Wenn Sie Bereich nach Speicher ausgewählt und eine oder mehrere Logansichten ausgewählt haben, werden nur die Log-Buckets im aktuellen Projekt abgefragt, die die ausgewählten Logansichten enthalten.

    • Wenn Sie Bereich nach Speicher ausgewählt und eine Logansicht in einem anderen Projekt angegeben haben, werden keine Log-Buckets abgefragt.

Auf der Seite Loganalysen können Sie die Ergebnisse in Tabellenform oder als Diagramm ansehen. Auf dem Tab Diagramm können Sie die Daten auswählen, die im Diagramm dargestellt werden sollen, die Diagrammkonfiguration anpassen oder ein Diagramm in einem benutzerdefinierten Dashboard speichern. Informationen zum Erstellen von Diagrammen aus den Abfrageergebnissen und zum Speichern von Diagrammen in einem benutzerdefinierten Dashboard finden Sie unter Diagramme zu Abfrageergebnissen mit Loganalysen erstellen.

Informationen zur Verwendung von SQL zum Schreiben von Abfragen in Loganalysen finden Sie unter Logs in Loganalysen abfragen und ansehen.

Bereich Logfelder

Der Bereich Logfelder bietet eine allgemeine Zusammenfassung der Logdaten und eine effiziente Möglichkeit, eine Abfrage zu verfeinern. Im Bereich werden Logeinträge nach verschiedenen Dimensionen aufgeschlüsselt, die den Feldern in diesen Einträgen entsprechen.

Nachdem Sie die Abfrage im Feld des Abfrageeditors ausgeführt haben, wird der Bereich Logfelder anhand der Ergebnisse der Abfrage gefüllt. In diesem Bereich wird die Anzahl der Logeinträge für jede unterstützte Dimension angezeigt. Für jede Dimension können Sie eine Auswahl treffen. Die folgenden Dimensionen sind immer verfügbar:

  • Ressourcentyp

    Wenn Sie mit BindPlane lokale und Hybrid-Cloud-Logs schreiben, wählen Sie den Ressourcentyp Generic Node (Generischer Knoten) aus.

  • Schweregrad

    Wenn Sie möchten, dass die Abfrage nach mehreren Schweregraden filtern soll, verwenden Sie das Menü Schweregrad.

Möglicherweise wird die Dimension Dienst angezeigt:

  • Wenn Sie Logs mit dem Ressourcentyp Kubernetes Container haben und diese nicht nach Ressourcentyp gefiltert haben, enthält das Menü Service (Dienst) einen Eintrag. Die Einträge in diesem Menü werden dynamisch durch die Werte des Labels k8s-pod/app der Ressource bestimmt.

    Wenn als Ergebnis Ihrer Abfrage beispielsweise ein Logeintrag wie der folgende angezeigt wird, enthält das Dienstmenü den Dienst myservice:

    {
     ...
     labels: {
         compute.googleapis.com/resource_name: "mycluster1"
         k8s-pod/app: "myservice"
         k8s-pod/pod-template-hash: "5ffcd94fdd"
      }
      logName: "projects/my-project/logs/stdout"
      resource: {
         labels: {6}
         type: "k8s_container"
      }
      ...
    }
    
  • Wenn Sie nach dem Ressourcentyp Geprüfte Ressource filtern, wird das Menü Dienst ausgefüllt. Die Einträge in diesem Menü werden dynamisch durch die Werte des Labels service der Ressource bestimmt.

Andere Dimensionen wie die Projekt-ID werden entsprechend Ihrer Auswahl aufgeführt. Beispielsweise wird die Dimension Projekt-ID aufgeführt, wenn die Abfrage der Logeinträge auf diejenigen Einträge beschränkt ist, deren Ressourcentyp Kubernetes-Container ist, oder wenn Sie Bereich nach Speicher ausgewählt haben.

Abfrage optimieren

Sie können die Abfrage eingrenzen, indem Sie im Bereich Logfelder einen Wert auswählen. Wenn Sie beispielsweise unter Schweregrad die Option Fehler auswählen, wird der Abfragebereich aktualisiert und enthält dann severity=ERROR.

Der folgende Screenshot zeigt das Feld im Abfrageeditor, nachdem im Bereich Logfelder ein Schweregrad und ein Ressourcentyp ausgewählt wurden:

Beispiel für den Bereich „Logfelder“ mit zwei Auswahlmöglichkeiten

Wenn Sie eine Auswahl entfernen möchten, klicken Sie auf X löschen.

Felder im Bereich Logfelder hinzufügen

Sie können bestimmte LogEntry-Schlüssel-Wert-Paare aus den Logeinträgen, die im Bereich Abfrageergebnis angezeigt werden, zum Bereich Logfeld hinzufügen. Wenn Sie beispielsweise häufig nach dem Wert des Felds jsonPayload.message filtern, fügen Sie es dem Bereich Logfeld hinzu.

So fügen Sie dem Bereich Log-Feld ein Feld hinzu:

  1. Maximieren Sie im Bereich Abfrageergebnisse einen Logeintrag durch Klicken auf Maximieren.

  2. Wählen Sie einen Feldwert aus. Wählen Sie im Menü die Option Feld in Bereich "Logfelder" einfügen aus.

    Das benutzerdefinierte Feld wird im Bereich Logfelder als Liste von Schlüssel/Wert-Paaren angezeigt.

Zum Entfernen eines benutzerdefinierten Felds aus dem Bereich Logfelder klicken Sie neben dem Feld auf Entfernen.

Beachten Sie, dass die folgenden Feldtypen nicht zum Bereich Logfelder hinzugefügt werden können:

  • Zeitbezogene Felder; beispielsweise receiveTimestamp und protoPayload.startTime.
  • Felder mit hoher Kardinalität; beispielsweise insertId und protoPayload.latency.
  • Felder mit Arrayindexen im Pfad, z. B. protoPayload.authorizationInfo[0].resource

Histogramm

Im Bereich Histogramm können Sie die Verteilung von Logs im Zeitverlauf visualisieren. Das Histogramm wird neu erstellt, wenn Sie eine Abfrage ausführen. Dadurch können Sie leichter Trends in den Logdaten erkennen und Probleme beheben.

Klicken Sie in der Symbolleiste Ergebnisse auf Histogramm, um den Bereich Histogramm ein- oder auszublenden.

Histogrammfunktionen

Bereich "Histogramm"

  1. Histogrammleiste: Jede Histogrammleiste stellt einen Zeitraum dar. Jeder Balken enthält eine dreifarbige Aufschlüsselung der Log-Schweregrade, die im Zeitraum der einzelnen Leisten erfasst wurden. Die Farben stellen folgende Log-Schweregrade dar:

    • Blau: Niedrige Schweregrade, wie Standard, Fehlerbehebung, Info und Hinweis.
    • Gelb: Mittlere Schweregrade wie Warnung.
    • Rot: Hohe Schweregrade wie Fehler, Kritisch, Benachrichtigung und Notfall.

    Jede Histogrammleiste enthält ein Menü mit Optionen zum Analysieren der Logs.

  2. Zeitsteuerung: Hiermit können Sie den Zeitraum der Logs anpassen, die im Bereich Abfrageergebnisse angezeigt werden. Weitere Informationen zu diesen Optionen finden Sie unter Logs mithilfe von Zeiteinstellungen analysieren.

  3. Zeitachse: Zeigt den Zeitraum der Logs an, dargestellt durch Histogrammbalken, die im Bereich Abfrageergebnisse angezeigt werden. Die Zeitachse hilft Ihnen bei der Orientierung zu den Logs, die Sie für den größeren Zeitraum der Abfrage ansehen.

Logs mithilfe von Zeitsteuerelementen analysieren

Sie können die Zeitsteuerelemente des Histogramms verwenden, um Ihre Logdaten zu untersuchen und zu analysieren.

Zeit schnell anpassen

Das Histogramm bietet Zeitsteuerelemente, mit denen Sie die im Log-Explorer angezeigten Daten schnell anpassen können.

Zeitachse des Histogramms mit den Steuerelementen für die Schnellzeit.

  • Ziehpunkte der Zeitachse: Ziehen Sie die Ziehpunkte der Zeitachse nach innen, um die Daten einzugrenzen, oder nach außen, um die Daten in der Zeitachse des Histogramms zu erweitern. Klicken Sie auf Ausführen.

  • Bewegen Sie die Zeitachse vor und zurück: Klicken Sie auf den Vorwärtspfeil , um die Zeitachse auf einen späteren Zeitpunkt zu verschieben. Klicken Sie auf den Rückwärtspfeil , um die Zeitachse zu einem früheren Zeitpunkt zu verschieben.

  • Heran- und herauszoomen: Klicken Sie auf Herauszoomen, um die auf der Zeitachse angezeigten Daten zu vergrößern. Klicken Sie auf Heranzoomen, um die angezeigten Daten auf der Zeitachse einzugrenzen.

Änderungen an der Zeitleiste müssen zwischen dem aktuellen Zeitpunkt ("jetzt") und vor 30 Tagen liegen.

Zur Zeit scrollen oder zoomen

Zusätzlich zu den zuvor aufgeführten Steuerelementen für die Zeit bietet das Histogramm die Funktionen Zur Zeit scrollen und An Zeit zoomen. Damit können Sie das Histogramm und die Daten, die in anderen Bereichen des Log-Explorers angezeigt werden, genauer steuern.

Die Zeitachse des Histogrammbereichs mit den Steuerelementen für das Scrollen zur Zeit und zum Zoomen auf die Zeit.

Möglicherweise interessiert Sie bestimmte Histogrammleisten wegen ihrer relativen Größe oder ihrer Schweregrade. Sie können diese Histogrammleisten auswählen, um die im Log-Explorer angezeigten Logdaten anzupassen.

Mit der Funktion Zu Zeit scrollen können Sie Ihre Logdaten durchsuchen, ohne die Werte in den Bereichen Histogramm und Logfelder zu ändern. Wenn Sie das Feature Zur Zeit scrollen auswählen, geschieht Folgendes:

  • Die im Bereich Abfrageergebnisse angezeigten Logdaten werden entsprechend dem Zeitraum angepasst, der von der ausgewählten Histogrammleiste erfasst wurde.

    Die Abfrage wird nicht ausgeführt. Es kann jedoch eine partielle Aktualisierung der Daten erfolgen, um sicherzustellen, dass im Bereich Abfrageergebnisse Logs angezeigt werden, die dem Zeitraum der ausgewählten Histogrammleiste entsprechen.

  • Die Konsolen-URL wird aktualisiert und enthält den timestamp des letzten Logs, das gemäß des Zeitraums der ausgewählten Histogrammleiste erfasst wurde.

So wählen Sie das Feature Zur Zeit scrollen aus:

  1. Halten Sie den Mauszeiger über einen Balken in der Zeitachse des Histogramms. Ein Bereich mit zusammengefassten Informationen zu den Logdaten für den angegebenen Zeitraum wird angezeigt.

  2. Wählen Sie in diesem Bereich die Option Zur Zeit scrollen aus.

    Wenn Sie auf eine Histogrammleiste klicken, können Sie auch Zur Zeit scrollen auswählen.

Das Feature Auf Zeit zoomen ist ähnlich wie Zur Zeit scrollen, führt jedoch eine Abfrage Ihrer Logdaten basierend auf dem Zeitraum aus, der von einer ausgewählten Histogrammleiste erfasst wird. Wenn Sie das Feature Auf Zeit zoomen auswählen, geschieht Folgendes:

  • Die Logdaten, die Sie im Bereich Abfrageergebnisse sehen, werden entsprechend der Zeitraumbeschränkung der ausgewählten Histogrammleiste aktualisiert und eingegrenzt.
  • Die Konsolen-URL wird aktualisiert und enthält den timestamp des letzten Logs, das gemäß des Zeitraums der ausgewählten Histogrammleiste erfasst wurde.
  • Das Histogramm ändert sich so, dass nur Logs mit einem timestamp-Wert angezeigt werden, der innerhalb des Zeitraums der ausgewählten Histogrammleiste liegt.
  • Die Daten im Bereich Logfelder werden entsprechend dem Zeitraum angepasst, der durch die ausgewählte Histogrammleiste erfasst wurde.

So wählen Sie das Feature Auf Zeit zoomen aus:

  1. Halten Sie den Mauszeiger auf einen Balken in der Histogrammzeitleiste. Ein Bereich mit zusammengefassten Informationen zu den Logdaten für den angegebenen Zeitraum wird angezeigt.

  2. Wählen Sie im Bereich die Option Auf Zeit zoomen aus.

Abfrageergebnisse

Im Bereich Abfrageergebnisse können Sie sich die Ergebnisse Ihrer Abfragen ansehen. Zur Unterstützung bei der Fehlerbehebung in Ihren Anwendungen können Sie die Details einzelner Logeinträge ansehen und Logeinträge gruppieren und analysieren, um Muster in den Logs zu erkennen. Wenn Gemini in dem Projekt aktiviert ist, in dem Sie sich die Logs ansehen, können Sie mit Gemini auch einen Logeintrag zusammenfassen.

Die Spalte Zeit konfigurieren

In der Spalte Zeit im Bereich Abfrageergebnisse werden die Zeitstempel Ihrer Logeinträge angezeigt. Sie können die Spalte Zeit so anpassen, dass nur bestimmte Teile des Zeitstempels sichtbar sind. Dadurch entsteht mehr horizontaler Platz, sodass Sie weitere Informationen im Logeintrag sehen können.

Klicken Sie zum Auswählen der anzuzeigenden Teile des Zeitstempels auf das Menü Zusätzliche Zeitoptionen in der Spalte Zeit und wählen Sie dann eine der folgenden Optionen aus:

  • Datum, Uhrzeit und Zeitzone

  • Datum und Uhrzeit (Standardeinstellung)

  • Nur Uhrzeit

Muster in Logs mithilfe von Zusammenfassungsfeldern finden

Angenommen, Sie sehen sich die Logeinträge in Ihren Abfrageergebnissen an und möchten die Ergebnisse schnell nach einem bestimmten LogEntry-Feld suchen. Oder vielleicht möchten Sie Ihre Logeinträge nach einem bestimmten Feld/Wert-Paar gruppieren. Sie können Ihren Ergebnissen Zusammenfassungsfelder hinzufügen, die am Anfang jeder Logeintragszeile als Chips angezeigt werden. Die folgende Abbildung zeigt beispielsweise Abfrageergebnisse mit dem Zusammenfassungsfeld resource.type in jeder Logeintragszeile:

Im Log-Explorer werden Logs angezeigt, denen Ressourcentypen mit vorangestelltem grünem Text vorangestellt sind.

Der Log-Explorer bietet Standard-Zusammenfassungsfelder und benutzerdefinierte Zusammenfassungsfelder. Standard-Zusammenfassungsfelder hängen von den aktuellen Abfrageergebnissen ab. Mit benutzerdefinierten Zusammenfassungsfeldern können Sie ein beliebiges Feld im LogEntry auswählen.

Um Zusammenfassungsfelder in den Abfrageergebnissen auszublenden, verwenden Sie die Ein/Aus-Schaltfläche Zusammenfassungsfelder . Wenn diese Ein/Aus-Schaltfläche aktiviert ist, werden die Ergebnisse im Rohtextformat angezeigt. Standardmäßig wird der Inhalt jedes Logeintrags so gekürzt, dass er in eine Zeile passt. Wenn Sie bis zu 10 Zeilen pro Logeintrag anzeigen möchten, verwenden Sie die Ein/Aus-Schaltfläche für Zeilenumbruch . Leerräume werden in jedem Logeintrag beibehalten.

Wenn Sie bestimmte Zusammenfassungsfelder ausblenden möchten, aktivieren Sie Zusammenfassungsfelder und klicken Sie dann auf Zusammenfassungsfeld ausblenden.

So ändern Sie Zusammenfassungsfelder:

  1. Klicken Sie in der Spalte Zusammenfassung auf die Schaltfläche Bearbeiten, um das Bearbeitungsmenü zu öffnen.

    Im Bereich mit den Abfrageergebnissen wird die Schaltfläche zum Bearbeiten von Zusammenfassungsfeldern angezeigt.

  2. Im Dialogfeld Zusammenfassungsfelder verwalten können Sie Folgendes tun:

    • Fügen Sie den benutzerdefinierten Zusammenfassungsfeldern die Namen benutzerdefinierter Felder hinzu.

      Für die Auswahl des Zusammenfassungsfelds stehen folgende Features zur Verfügung:

      • Die automatische Vervollständigung anhand der Logs, die in den Abfrageergebnissen angezeigt werden, wird verwendet.
      • Feldkorrektur für zulässige Zeichen in Anführungszeichen

      Wenn Sie beispielsweise jsonPayload.id-field eingeben, wird der Wert in jsonPayload."id-field" geändert.

      Sie können auch ein beliebiges LogEntry-Feld auswählen, unabhängig davon, ob es Ihnen durch die Funktion für die automatische Vervollständigung vorgeschlagen wird.

      Wenn Sie ein vorhandenes benutzerdefiniertes Zusammenfassungsfeld entfernen möchten, klicken Sie im zugehörigen Chip auf das X.

    • Sie können die Kürzung für benutzerdefinierte Zusammenfassungsfelder aktivieren oder deaktivieren.

      Wenn Sie die Anzeige der Werte des Zusammenfassungsfelds verkürzen möchten, verwenden Sie die Ein/Aus-Schaltfläche neben Benutzerdefinierte Zusammenfassungsfelder kürzen. Sie können auswählen, wie viele Zeichen angezeigt werden sollen, bevor das Feld abgeschnitten wird, und ob der Anfang oder das Ende des Felds angezeigt werden soll.

    • Standard-Zusammenfassungsfelder ein- oder ausblenden:

      Maximieren Sie das Menü Standardzusammenfassungsfelder ein- oder ausblenden, um festzulegen, welche Standardzusammenfassungsfelder in Ihren Abfrageergebnissen angezeigt werden.

  3. Klicken Sie auf Anwenden.

    Die Zusammenfassungsfelder werden jetzt in den Abfrageergebnissen aktualisiert.

In Abfrageergebnissen suchen

Klicken Sie im Bereich Abfrageergebnisse auf In Ergebnissen suchen und geben Sie einen Suchbegriff ein, um im Inhalt von Abfrageergebnissen zu suchen. Mit diesem Filter können Sie Informationen in Ihren Logeinträgen finden, ohne eine neue Abfrage erstellen zu müssen.

Begriffe, die den Suchkriterien entsprechen, werden in Logeinträgen im Bereich Abfrageergebnisse hervorgehoben:

Logeinträge mit übereinstimmenden Suchbegriffen sind hervorgehoben.

Ähnliche Logeinträge ansehen

Sie können Logeinträge aufrufen, die einem ausgewählten Logeintrag ähneln, sodass Sie sich auf die relevanten Logs konzentrieren können.

So rufen Sie ähnliche Logeinträge auf:

  1. Klicken Sie im Bereich Abfrageergebnisse bei einem Logeintrag auf Maximieren.

  2. Klicken Sie auf Ähnliche Einträge und wählen Sie Ähnliche Einträge anzeigen aus.

    Die Abfrage wird mit einer Abfrage ähnlich der folgenden aktualisiert und die Abfrageergebnisse werden neu geladen:

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

So rufen Sie eine Vorschau ähnlicher Logeinträge auf:

  1. Klicken Sie im Bereich Abfrageergebnisse bei einem Logeintrag auf Maximieren.

  2. Maximieren Sie das Menü Ähnliche Einträge und wählen Sie Vorschau ähnlicher Einträge aus.

    Ein separates Dialogfeld mit den folgenden Informationen wird geöffnet:

    • Das gefundene Muster
    • Prozentsatz der Logeinträge, die das Muster enthalten
    • Beispiel für Logeinträge, die das Muster enthalten

    In diesem Dialogfeld können Sie Logeinträge ein- oder ausblenden:

    Mit dem Dialogfeld „Vorschau der Logeinträge“ können Sie ähnliche Logeinträge ein- oder ausblenden.

Ähnliche Logeinträge ausblenden

Sie können ähnliche Logeinträge ausblenden, um Logs aus den Abfrageergebnissen zu entfernen.

Es gibt zwei Möglichkeiten, ähnliche Logeinträge auszublenden:

  • Große Mengen automatisch gruppierter Logeinträge ausblenden. Wenn Sie eine Abfrage ausführen, werden die Abfrageergebnisse auf Muster analysiert und Logeinträge dann automatisch nach ähnlichen Logfeldinhalten gruppiert. Wenn ein signifikantes Muster erkannt wird, wird im Bereich Abfrageergebnisse ein Banner mit dem Prozentsatz der Ergebnisse angezeigt, die ausgeblendet werden können:

    Banner für ähnliche Logs ausblenden.

    Ähnliche Einträge ausblenden: Mit dieser Schaltfläche wird der Abfrage eine Klausel hinzugefügt und die Abfrageergebnisse neu geladen.

    Vorschau: Ein separates Fenster wird geöffnet, in dem das gefundene Muster beschrieben und Beispiele der Einträge angezeigt werden.

    Wenn Sie ähnliche Logs ausblenden, werden keine Informationen außerhalb der Log-Explorer-Sitzung gespeichert. Jede Abfrage generiert eine neue Analyse, die nur auf den angezeigten Logs basiert. Mit verschiedenen Abfragen werden unterschiedliche Teile der Logeinträge analysiert, je nachdem, welche Arten von Logs zurückgegeben werden.

  • Blenden Sie Logeinträge aus, die einem bestimmten Logeintrag ähneln. So blenden Sie Logeinträge aus, die einem Logeintrag ähnlich sind:

    1. Klicken Sie im Logeintrag auf Maximieren, dann auf das Menü Ähnliche Einträge und wählen Sie Ähnliche Einträge ausblenden aus.

      Die Abfrage wird aktualisiert und der Bereich Abfrageergebnisse wird neu geladen. Logeinträge, die dem ausgewählten Logeintrag ähneln, werden nicht angezeigt.

Logeinträge ansehen oder ausblenden, die mit einem Feld übereinstimmen

Sie können Logeinträge, die mit einem Feld in einem Logeintrag übereinstimmen, ein- oder ausblenden, sodass Sie sich auf Einträge konzentrieren können, die denselben Feldinhalt enthalten.

So blenden Sie Logeinträge ein oder ausblenden, die mit einem bestimmten Feld in einem Logeintrag übereinstimmen:

  1. Klicken Sie im Bereich Abfrageergebnisse für den Logeintrag auf Maximieren.

  2. Klicken Sie auf den Wert eines Felds im Logeintrag, z. B. compute.googleapis.com (ein serviceName).

    Das folgende Menü wird angezeigt:

    Menü mit Optionen zum Ein- und Ausblenden von Logeinträgen basierend auf einem bestimmten Feld.

  3. Wählen Sie Übereinstimmende Einträge anzeigen oder Übereinstimmende Einträge ausblenden aus.

    Die Abfrage wird mit einer Abfrage aktualisiert, mit der ähnliche Einträge ein- oder ausgeblendet werden, und die Abfrageergebnisse werden mit neuen Ergebnissen neu geladen.

Logeinträge anpinnen

Nachdem Sie eine Abfrage ausgeführt haben, können Sie einen Logeintrag hervorheben, indem Sie ihn anpinnen. Der angepinnte Logeintrag bleibt im Bereich Abfrageergebnisse zentriert. Wenn Sie eine neue Abfrage ausführen und der angepinnte Logeintrag nicht enthalten ist, werden Sie aufgefordert, den Logeintrag loszulösen.

So pinnen Sie einen Logeintrag an:

  1. Bewegen Sie den Mauszeiger auf den Logeintrag, den Sie anpinnen möchten.
  2. Klicken Sie auf Anpinnen.

Nachdem Sie einen Logeintrag angepinnt haben, wird der Hintergrund dunkler dargestellt und das Anpinnen-Symbol wird angezeigt. Im Bereich Histogramm wird außerdem ein Stecknadelsymbol angezeigt, das auf der timestamp des angepinnten Logeintrags basiert:

Der Log-Explorer zeigt einen angepinnten Logeintrag im Bereich "Abfrageergebnisse" und "Histogramm" an.

Wenn Sie einen Logeintrag loslösen möchten, klicken Sie noch einmal auf das Stecknadelsymbol.

Logs anzeigen, die mit der Ressource eines angepinnten Logeintrags übereinstimmen

Nachdem Sie einen Logeintrag angepinnt haben, können Sie eine neue Abfrage ausführen, mit der Logeinträge angezeigt werden, die dem Ressourcentyp oder den Ressourcenlabels des angepinnten Logs entsprechen.

So pinnen Sie einen Logeintrag an und lassen sich Logeinträge anzeigen, die demselben Ressourcentyp oder denselben Ressourcenlabels entsprechen:

  1. Klicken Sie neben dem angepinnten Log auf den Abwärtspfeil , um das Menü zum Anpinnen zu maximieren.

  2. Treffen Sie im Menü „Anpinnen“ eine Auswahl:

    • Wenn Sie die Abfrage noch einmal mit demselben resource.type wie das angepinnte Log ausführen möchten, wählen Sie Same resource.type aus.

      Angenommen, Sie pinnen einen Logeintrag mit einem resource.type von k8s_node an. Wenn Sie Same resource.type auswählen, wird die Abfrage noch einmal ausgeführt, um alle Logeinträge mit resource.type="k8s_node" anzuzeigen.

    • Wenn Sie die Abfrage noch einmal mit demselben resource.labels wie das angepinnte Log ausführen möchten, wählen Sie Same resource.labels aus.

    • Wenn Sie die Abfrage noch einmal mit demselben trace wie das angepinnte Log ausführen möchten, wählen Sie Gleicher Trace aus.

    • Wählen Sie Alle anzeigen aus, um die Abfrage zu löschen und alle Logeinträge anzuzeigen.

Angepinnten Logeintrag im Bereich Histogramm ansehen

Im Bereich Histogramm können Sie einen angepinnten Logeintrag hervorheben, zu ihm scrollen und weiter untersuchen.

Klicken Sie im Bereich Histogramm auf Anpinnen und wählen Sie dann eine der folgenden Menüoptionen aus:

  • Zum Logeintrag scrollen: Rufen Sie den Logeintrag im aktuellen Bereich Abfrageergebnisse auf und sehen Sie sich den angepinnten Logeintrag im Kontext der Logs in der Nähe an.
  • Auf Logeintrag zoomen: Grenzen Sie den im Bereich Histogramm angezeigten Zeitraum ein und verfeinern Sie die Abfrage, um die Logs in der Nähe des angepinnten Logs zu isolieren.

Trace-Daten ansehen

Wenn ein Logeintrag sowohl das Feld trace als auch das Latenzfeld enthält, werden sowohl das Latenz- als auch das Trace-Symbol angezeigt.

Anzeige von Logeinträgen mit Trace-Daten.

Wenn ein Logeintrag nur das Feld trace enthält, wird nur das Trace-Symbol angezeigt.

Logeinträgen, die nur das Trace-Feld enthalten, werden mit einem Trace-Symbol angezeigt.

Klicken Sie auf das Trace-Symbol, um die Trace-Daten für den Logeintrag aufzurufen. Folgende Einstellungen können Sie vornehmen:

  • Trace-Details anzeigen: Zeigt den übergeordneten Span und die untergeordneten Traces zusammen mit Details zum Trace an. Klicken Sie auf In Trace ansehen, um weitere Details zu Trace aufzurufen. Weitere Informationen zum Inhalt im Detailbereich finden Sie unter Traces suchen und untersuchen.
  • Alle Logs für diesen Trace anzeigen: Führt die Abfrage aus und fügt das auf die Kennung des mit dem Logeintrag verknüpften Trace befüllte Feld trace hinzu, um die Abfrage zu verfeinern.

  • Nur verfolgte Anfragen anzeigen: Führt die Abfrage aus und setzt das Feld traceSampled auf True, um diese zu verfeinern. Weitere Informationen zur Stichprobenerhebung finden sich unter Abtastrate.

Monitoring-Daten ansehen

Bei bestimmten Logs, z. B. GKE- und Compute Engine-Logs, können Sie den Ressourcentyp in der Zusammenfassungszeile des Logs auswählen, um ein Menü mit den folgenden Optionen anzuzeigen:

  • Monitoring-Details ansehen: Öffnet einen Detailbereich für eine GKE-Ressource. Informationen zum Detailbereich finden Sie unter Ressourcendetails ansehen.
  • In Monitoring ansehen: Öffnet die Seite Monitoring für die Ressource.
  • In GKE ansehen oder In Compute Engine ansehen: Öffnet die Seite Details für die Ressource innerhalb der GKE- oder Compute Engine-Benutzeroberfläche.

Anzeige des Menüs "Log-Explorer" für GKE-Ressourcen.

Wenn Sie einen Link zu einem Log freigeben möchten, maximieren Sie einen Logeintrag und wählen Sie Link kopieren aus. Der Link wird in die Zwischenablage kopiert. Sie können den Link an Nutzer senden, die Zugriff auf das Google Cloud-Projekt haben. Wenn ein Nutzer den Link in einen Browser einfügt oder auswählt, wird der Logeintrag in Logging im Bereich Abfrageergebnisse angepinnt.

Kopieren Sie den, um den Logeintrag für andere freizugeben.

Logs herunterladen

Sie können Ihre Protokolle im CSV- oder JSON-Format herunterladen. Sie benötigen eine der folgenden IAM-Rollen (Identity and Access Management), um Logs herunterzuladen:

  • Logging-Administrator (roles/logging.admin)
  • Zugriffsberechtigter für Logbetrachtung (roles/logging.viewAccessor)

So laden Sie Ihre Logs herunter:

  1. Klicken Sie in der Symbolleiste des Bereichs Abfrageergebnisse auf Herunterladen.

  2. Wählen Sie im Dialogfeld Logs herunterladen das CSV- oder JSON-Format aus und klicken Sie dann auf Herunterladen.

  3. Wählen Sie aus, was mit den Logdaten geschehen soll. Folgende Einstellungen können Sie vornehmen:

    • Laden Sie die Daten auf Ihren Computer herunter.
    • Laden Sie die Daten in Google Drive herunter.
    • Sehen Sie sich die Daten in einem neuen Tab an.

    Wenn Sie eine CSV-Datei speichern und Google Drive auswählen, können Sie die Datei in Google Tabellen öffnen.

Informationen zur Fehlerbehebung finden Sie unter Das Herunterladen von Logs schlägt fehl.

Beispielabfragen

Vorgeschlagene Abfragen, sortiert nach Google Cloud-Produkt und -Anwendungsfall, finden Sie unter Beispielabfragen mit dem Log-Explorer. Beispielsweise können Sie Kubernetes-Abfragen ausführen, um Google Kubernetes Engine-Logs zu finden.

Compute Engine-Logs ansehen

Bei bestimmten Compute Engine-Ressourcentypen wie gce_instance und gce_network wird an verschiedenen Stellen im Log-Explorer der Ressourcenname mit der Ressourcen-ID als Untertext angezeigt. Für den Ressourcentyp gce_instance wird beispielsweise der VM-Name zusammen mit der VM-ID angezeigt. Anhand der Ressourcennamen können Sie die richtige Ressourcen-ID ermitteln, für die Sie Abfragen erstellen können.

Compute Engine-Ressourcennamen werden an folgenden Stellen angezeigt:

  • Filtermenüs im Bereich Abfrage: Compute Engine-Ressourcentypen zeigen Ressourcennamen mit den entsprechenden Ressourcen-IDs als Untertext an.
  • Logfelder: Bei Compute Engine-Ressourcentypen wird in den Felddimensionen der Ressourcenname und nicht die Ressourcen-ID angezeigt.
  • Abfrageergebnisse: Für Compute Engine-VM-Instanzlogs zeigt das Feld resource.labels Metadaten mit dem entsprechenden Ressourcennamen an.
  • Zusammenfassungsfelder: Bei Compute Engine-VM-Instanzlogs zeigt der Chip den Ressourcennamen anstelle der Ressourcen-ID an.

Fehlerbehebung

In diesem Abschnitt wird erläutert, wie Sie häufige Probleme bei der Verwendung von Log-Explorer beheben können.

Falls beim Aufrufen von Logs in Senkenzielen Probleme auftreten, lesen Sie die Informationen unter Fehlerbehebung beim Routing und Senken.

Herunterladen der Protokolle fehlgeschlagen

Sie verwenden den Log-Explorer und klicken Sie auf Herunterladen. Der Befehl wird gestartet, aber nicht ausgeführt oder meldet einen Fehler.

Um dieses Problem zu beheben, verkürzen Sie die Ausführungszeit des Befehls. Versuchen Sie dazu Folgendes:

  • Verringern Sie im Dialogfeld Logs herunterladen den Wert für Maximale Anzahl von Logeinträgen.
  • Reduzieren Sie den Zeitraum, über den Logs abgefragt werden.
  • Klicken Sie in der Symbolleiste mit den Abfrageergebnissen auf Ähnliche Einträge ausblenden, bevor Sie mit dem Download beginnen.
  • Ändern Sie die Abfrage so, dass indexierte Felder verwendet werden.

Konsolenlogs für eine VM-Instanz können nicht gefunden werden

In die Console einer Compute Engine-Instanz geschriebene Logs sind im Log-Explorer möglicherweise nicht verfügbar. So rufen Sie diese Logs auf:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Compute Engine und dann VM-Instanzen aus:

    Zu Seite VM-Instanzen

  2. Wählen Sie die Instanz und dann Serieller Port 1 (Konsole) im Abschnitt Logs der Seite aus.

Sie können Instanzen so konfigurieren, dass die Ausgabe des seriellen Ports an Cloud Logging gesendet wird. Weitere Informationen finden Sie unter Logging für die Ausgabe des seriellen Ports aktivieren und deaktivieren.

Google Cloud-Projekt oder Organisations-ID abrufen

Wenn Sie von einer beliebigen Stelle in der Google Cloud Console eine Google Cloud-Projekt- oder eine Organisations-ID abrufen möchten, maximieren Sie in der Google Cloud-Projekt- und Organisationsauswahl die Liste der Google Cloud-Projekte und suchen Sie in der Spalte ID nach der Google Cloud-Projekt-ID:

ID für das Projekt wird angezeigt

Logeinträge werden nicht angezeigt

Wenn keine Logeinträge angezeigt werden, prüfen Sie Folgendes:

  • Ist das richtige Google Cloud-Projekt ausgewählt? Falls nicht, wählen Sie in der Auswahl für das Google Cloud-Projekt und die Organisation das richtige Google Cloud-Projekt aus.

  • Verwendet Ihr Google Cloud-Projekt Ressourcen, die Logs generieren, und gibt es Aktivitäten in diesen Ressourcen? Auch wenn das Google Cloud-Projekt neu ist, sollte es Audit-Logs haben, die die Tatsache dokumentieren, dass es erstellt wurde. Prüfen Sie, ob Sie eine Ressource verwenden, die Logs generiert. Informationen dazu finden Sie auf der Seite "Liste überwachter Ressourcen" im Abschnitt "Dienste Ressourcentypen zuordnen" auf.

  • Ist der Zeitraum zu kurz? Prüfen Sie, ob der Zeitraum in Ihrer Abfrage korrekt ist.

  • Prüfen Sie Ihre aktuellen Ausschlussabfragen, damit die gesuchten Logs nicht versehentlich ausgeschlossen werden.

  • Wird der richtige Bereich zum Ansehen von Logs verwendet? Eine Anleitung zum Anpassen des Suchumfangs finden Sie unter Bereich eingrenzen.

Meine Abfrage ist korrekt, aber ich sehe immer noch keine Logeinträge

  • Logeinträge, die die Aufbewahrungsdauer von Logging vom Alter her überschritten haben, werden nicht angezeigt. Die für Logs geltende Aufbewahrungsdauer entnehmen Sie dem Abschnitt Aufbewahrungsdauer von Logs.

  • Bei hoher Auslastung kann es beim Senden der Logs an Logging sowie bei deren Empfang oder Anzeige zu Verzögerungen kommen.

  • Im Log-Explorer sehen Sie keine Logeinträge, die Zeitstempel in der Zukunft haben, bis die aktuelle Zeit mit dem Vorkommen versehen ist. Ursache ist meist eine Zeitverzerrung in der Anwendung, aus der die Logs stammen.

  • Der Abfragebereich war zu groß und konnte nicht innerhalb eines angemessenen Zeitraums abgearbeitet werden. Möglicherweise wird dies als "Frist abgelaufen, bevor der Vorgang beendet werden konnte" angezeigt. Versuchen Sie, die Abfrage spezifischer zu machen oder den Zeitraum zu kürzen.

Abfrage gibt einen Fehler zurück

Wenn Sie eine Abfrage für eine Ressource senden, ohne einen Bucket anzugeben, ermittelt Cloud Logging anhand des Verlaufs der Senken im Google Cloud-Projekt, wo Einträge für diese Ressource geschrieben wurden. Wenn Cloud Logging mehr als 200 Buckets erkennt, in die möglicherweise Einträge geschrieben wurden, schlägt die Abfrage mit der Meldung Error: Invalid query fehl.

Um dieses Problem zu beheben, verfeinern Sie den Umfang Ihrer Abfrage auf eine Teilmenge des Speichers. Weitere Informationen finden Sie unter Bereich eingrenzen.

Zeitraum der Abfrageergebnisse stimmt nicht mit der Abfrage überein

Die Logdaten, die in den Bereichen Abfrageergebnisse und Logfelder angezeigt werden, werden entsprechend dem Zeitraum angepasst, der von der Histogrammzeitachse erfasst wird. Sie können die Zeitachse des Histogramms über die Zeitsteuerelemente des Histogramms oder über die Zeitraumauswahl anpassen. Durch das Anpassen dieser Zeitsteuerungen ändert sich der Abfrageausdruck im Bereich Abfrage nicht.

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.

Support kontaktieren

Informationen dazu, wie Sie Unterstützung erhalten, finden Sie auf der Supportseite zur Beobachtbarkeit von Google Cloud.