Logs mit dem Log-Explorer aufrufen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Dieses Dokument bietet einen Überblick ü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 Logs suchen und ansehen, um Probleme zu beheben.

Der Log-Explorer unterstützt keine aggregierten Vorgänge wie das Zählen der Logeinträge, die ein bestimmtes Muster enthalten. Für zusammengefasste Vorgänge aktivieren Sie Analysen im Log-Bucket und verwenden dann die Seite Loganalyse. Außerdem können Sie mit dem Log-Explorer Logs in Buckets mit aktivierter Analyse aufrufen. Weitere Informationen finden Sie unter Loganalyse.

Sie können Logs auch mit der Logging API und der Google Cloud CLI lesen.

Mehr erfahren

So beginnen Sie mit der Verwendung des Log-Explorers:

  • Prüfen Sie, ob Sie die richtige Rolle für die Identitäts- und Zugriffsverwaltung haben, um Logs aufrufen zu können. Informationen zu IAM-Rollen und Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

  • 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.

  • Wenn Sie lokale Logs und Logs der Hybrid-Cloud über BindPlane aufnehmen, finden Sie diese unter dem Ressourcentyp generic_node.

  • Rufen Sie den Log-Explorer auf:

    Zu „Log-Explorer“

    Wählen Sie das entsprechende Cloud-Projekt aus.

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 Aktion

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

  • Umfang eingrenzen: Wählen Sie für die Suche nur Logs im aktuellen Cloud-Projekt oder eine oder mehrere Speicheransichten aus. Weitere Informationen zum Umfang finden Sie unter Umfang eingrenzen.
  • Weitere Informationen: Links zu relevanten Dokumentationen und Themen
  • Link freigeben: Erstellen Sie eine gekürzte URL der aktuellen Abfrage und kopieren Sie sie in die Zwischenablage. Dadurch wird es einfacher, eine Abfrage freizugeben. Die kopierte URL hat den entsprechenden absoluten Zeitraum, der durch den aktuellen Zeitraum Ihrer Abfrage dargestellt wird, z. B. 7:49:37 PM - 8:49:37 PM.

Bereich eingrenzen

Sie können den Umfang der im Log-Explorer angezeigten Logs mit der Option Bereich verfeinern eingrenzen. Sie können nur Logs im aktuellen Cloud-Projekt oder Logs in einer oder mehreren Speicheransichten prüfen. So verfeinern Sie den Bereich des Log-Explorers:

  1. Wählen Sie in der Symbolleiste Aktion die Option Umfang eingrenzen aus.

  2. Wählen Sie im Dialogfeld Bereich eingrenzen die Option Bereich nach aus.

    Dialogfeld "Bereich eingrenzen"

    • Mit der Option Bereich nach Projekt können Sie Logs prüfen, die vom aktuellen Cloud-Projekt generiert werden.

    • Mit Auf Speicherort einschränken können Sie Logs basierend auf einer oder mehreren Speicheransichten prüfen. Weitere Informationen zu Logansichten finden Sie unter Zugriff auf Bucket-Ebene konfigurieren.

  3. Wenn Sie Bereich nach Speicher auswählen, wählen Sie einen oder mehrere Buckets aus, die Sie ansehen möchten.

    Das Dialogfeld enthält Speicheransichten, die folgende Bedingungen erfüllen:

    • Der Nutzer hat Zugriff auf die Speicheransicht.
    • Die Log-Buckets gehören zum ausgewählten Cloud-Projekt oder das ausgewählte Cloud-Projekt hat zuvor Logs an die Storage-Buckets weitergeleitet.
  4. Klicken Sie auf Anwenden.

Bereich Abfrage

Im Bereich Abfrage haben Sie folgende Möglichkeiten:

  • Tab Abfrage: Abfragen mit den folgenden Funktionen erstellen und optimieren:

    • Zeitraumauswahl: Abfrageergebnisse nach Zeitraum einschränken. Weitere Informationen finden Sie unter Zeitraumauswahl verwenden.

    • Suchfeld: Sucht Logeinträge, die Ihren Suchbegriffen oder Wortgruppen entsprechen. Weitere Informationen finden Sie unter In Logfeldern nach Text suchen.

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

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

  • Tab Zuletzt geöffnet: Hier sehen Sie Abfragen, die Sie kürzlich 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 Cloud-Projekts für Sie freigegeben haben. Weitere Informationen finden Sie unter Abfragen speichern und Abfragen freigeben.

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

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

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

  • Abfrage löschen: Löschen oder zurücksetzen Sie die Auswahl, die Sie beim Erstellen einer Abfrage im Bereich Abfrage getroffen haben.

  • Streamlogs: Sehen Sie sich Logeinträge an, während sie von Logging aufgenommen werden. 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 für den Abfrageeditor nicht angezeigt wird, aktivieren Sie Abfrage anzeigen. Wenn Sie Suchbegriffe in das Suchfeld eingeben, werden diese Begriffe auch im Feld des Abfrageeditors angezeigt und als Teil des Abfrageausdrucks ausgewertet.

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

Logs streamen

Sie können Logs streamen, während Logging sie aufnimmt, oder Sie können eine Abfrage hinzufügen, mit der nur die Logs gestreamt werden, die der Abfrage entsprechen.

Um Logs anhand einer Abfrage zu streamen, fügen Sie im Bereich Abfrage eine Abfrage hinzu und wählen dann Logs streamen aus. Während Logging die Logdaten aufnimmt, werden nur die Logs, die mit der Abfrage übereinstimmen, im Bereich Abfrageergebnisse angezeigt. Wird keine Abfrage bereitgestellt, zeigt Logging jedes Log so an, wie es aufgenommen wird.

Klicken Sie zum Beenden des Streamings auf Streaming beenden oder scrollen Sie im Bereich Abfrageergebnisse.

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse haben Sie folgende Möglichkeiten:

  • Bereich Logs anzeigen: Sie können diesen Bereich schnell im Seitenlayout von Log-Explorer ein- oder ausblenden.
  • Bereich Histogramm anzeigen: Dieser Bereich kann im Seitenlayout von Log-Explorer schnell ein- oder ausgeblendet werden.
  • Messwert erstellen: Richten Sie einen logbasierten Messwert basierend auf dem aktuellen Abfrageausdruck ein.
  • Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigung basierend auf Ihrem aktuellen Abfrageausdruck ein.
  • Zu jetzt springen: Erzwingen Sie eine Aktualisierung Ihrer Abfrageergebnisse, um die aktuelle Zeit einzubeziehen. Wenn für die Zeitraumauswahl ein benutzerdefinierter Zeitraum verwendet wird und eine Endzeit festgelegt ist, wird die Abfrage mit einem Standardzeitraum von einer Stunde ausgeführt. Andernfalls wird das aktuelle Startdatum oder die aktuelle Dauer aktualisiert und die Abfrage wird ausgeführt. Der Abfrageausdruck wird bei Verwendung dieser Funktion nicht geändert.
  • Weitere Aktionen: Mit diesen weiteren Optionen können Sie logbasierte Benachrichtigungen verwalten oder eine Senke erstellen.

Bereich Logfelder

Der Bereich Logfelder bietet eine allgemeine Zusammenfassung der Logdaten und eine effizientere Möglichkeit zur Verfeinerung einer Abfrage. Darin werden die Logeinträge nach verschiedenen Dimensionen aufgeschlüsselt, die den Feldern in diesen Einträgen entsprechen. Für jedes Feld werden im Bereich Logfelder Werte und deren Vorkommen in absteigender Reihenfolge angezeigt. Die Anzahl der Logfelder entspricht dem Zeitraum in der Zeitraumauswahl.

Wenn Sie den Bereich Logfelder ein- oder ausblenden möchten, klicken Sie in der Symbolleiste Ergebnisse auf die Schaltfläche Logfelder.

Der Bereich Logfelder wird basierend auf einer im Abfrageeditorfeld ausgeführten Abfrage ausgefüllt und aktualisiert.

Wenn die Abfrage leer ist, wird im Bereich Logfelder die Anzahl der Logeinträge nach den Feldern Ressourcentyp und Schweregrad angezeigt.

Bereich "Logfelder".

Wenn Sie Bereich nach Speicher ausgewählt haben, werden auch die Projekt-ID und die entsprechende Anzahl von Logeinträgen angezeigt.

Wenn Sie im Bereich Logfelder einen Ressourcentyp auswählen, füllen Sie eine Reihe relevanter Felder basierend auf den Ressourcenlabels aus. Auf diese Weise können Sie Logdaten für diesen bestimmten Ressourcentyp untersuchen. Um sie zu entfernen, klicken Sie neben dem Feld Ressourcentyp auf 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. So fügen Sie dem Bereich Logfeld ein Feld hinzu:

  1. Maximieren Sie im Bereich Abfrageergebnisse einen Logeintrag, indem Sie auf die Schaltfläche "Maximieren" klicken.

  2. Klicken Sie auf den Wert eines Felds. 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 Array-Indexen im Pfad; beispielsweise protoPayload.authorizationInfo[0].resource.

Logs mithilfe des Bereichs Logfelder analysieren

Wenn Sie eine Abfrage eingrenzen und optimieren möchten, können Sie dem Ausdruck im Bereich Abfrage Feld-Wert-Paare aus dem Bereich Logfelder hinzufügen. Klicken Sie dazu im Bereich Logfelder auf den Wert eines Felds. Dadurch wird dem Ausdruck mithilfe des Operators AND das Feld/Wert-Paar hinzugefügt. Die Abfrage wird dann ausgeführt.

Sie können dem Bereich Logfelder verschachtelte Feld/Wert-Paare sowie Feld/Wert-Paare der obersten Ebene hinzufügen. Angenommen, Sie haben jsonPayload.message zum Bereich Logfelder hinzugefügt. Wenn Sie einen bestimmten jsonPayload.message-Wert auswählen, wird er im Abfrageeditorfeld ausgefüllt.

Die Bereiche Histogramm und Abfrageergebnisse ändern sich ebenfalls gemäß der aktuellen Abfrage.

Beim Ausführen einer Abfrage werden die Logeinträge gescannt und die Zahl der Logfelder ändert sich. Wenn die Abfrage abgeschlossen ist, wird die Gesamtzahl für alle Logfelder angezeigt.

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 die Schaltfläche Histogramm, um den Bereich Histogramm ein- oder auszublenden.

Histogramm-Features

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 in Form von Histogrammbalken an, die derzeit im Bereich Abfrageergebnisse angezeigt werden. Die Zeitachse hilft Ihnen, sich im aktuellen Abfragezeitraum an den Logs zu orientieren, die Sie sich gerade 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.

Die Zeitachse des Histogramms zeigt die Schnellsteuerung.

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

  • Verschieben Sie die Zeitachse nach vorne und hinten: Klicken Sie auf den Vorwärtspfeil, um die Zeitachse zu einem späteren Zeitpunkt zu verschieben. Klicken Sie auf den Zurückpfeil, um die Zeitachse zu einem früheren Zeitpunkt zu verschieben.

  • Heran- und herauszoomen: Klicke auf das Herauszoomen-Symbol, um die Daten auf der Zeitachse zu erweitern. Klicken Sie auf das Symbol zum Heranzoomen, um die in der Zeitachse angezeigten Daten 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 oben aufgeführten Zeitsteuerelementen bietet das Histogramm die Features Zur Zeit scrollen und Auf Zeit zoomen, um Ihnen eine genauere Kontrolle über das Histogramm und die Daten zu geben, die Sie in anderen Bereichen des Log-Explorers sehen.

Auf der Zeitachse des Histogramms sind die Steuerelemente für das Scrollen zur Zeit und das Zoomen auf die Uhrzeit zu sehen.

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 Scroll to time (Zum Zeitpunkt 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. Bewegen Sie den Mauszeiger auf einen Balken in der Histogrammzeitachse. 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 alternativ auf eine Histogrammleiste klicken, statt den Mauszeiger darauf zu bewegen, entspricht dies der Auswahl von Zur Zeit scrollen.

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. Bewegen Sie den Mauszeiger auf einen Balken in der Histogramm-Zeitachse. 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

Verwenden Sie den Bereich Abfrageergebnisse, um die Ergebnisse Ihrer Abfragen anzusehen. Zur Unterstützung bei der Fehlerbehebung von Anwendungen können Sie die Details einzelner Logeinträge aufrufen sowie Logeinträge gruppieren und analysieren, um Muster in Ihren Logs zu finden.

Muster in Zusammenfassungsfeldern mithilfe von Zusammenfassungsfeldern suchen

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

Im Log-Explorer werden Logs mit vorangestelltem grünem Text für Ressourcentypen angezeigt.

Der Log-Explorer bietet standardmäßige Zusammenfassungsfelder und benutzerdefinierte Zusammenfassungsfelder. Standard-Zusammenfassungsfelder hängen von Ihren aktuellen Abfrageergebnissen ab. Mit benutzerdefinierten Zusammenfassungsfeldern können Sie ein beliebiges Feld in der LogEntry auswählen.

So ändern Sie die Zusammenfassungsfelder:

  1. Klicken Sie in der Spalte Zusammenfassung auf 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 haben Sie folgende Möglichkeiten:

    • Wenn Logeinträge im Rohtextformat angezeigt werden sollen, deaktivieren Sie mit dem Umschalter die Standardzusammenfassungsfelder. Fügen Sie dann keine benutzerdefinierten Zusammenfassungsfelder hinzu.

    • Fügen Sie Benutzerdefinierte Zusammenfassungsfelder beliebige benutzerdefinierte Feldnamen hinzu.

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

      • Automatische Vervollständigung mit den aktuell in den Abfrageergebnissen angezeigten Logs
      • 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 mit der Funktion für die automatische Vervollständigung vorgeschlagen wird.

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

    • Sie können die Kürzung für Ihre benutzerdefinierten Zusammenfassungsfelder aktivieren oder deaktivieren. Verwenden Sie die Ein-/Aus-Schaltfläche , um Zusammenfassungsfelder zu kürzen, um die Anzeige der Zusammenfassungsfeldwerte zu verkürzen. Wählen Sie dann aus, wie viele Zeichen angezeigt werden sollen, bevor das Feld abgeschnitten wird und ob der Anfang oder das Ende des Felds angezeigt wird.

  3. Klicken Sie auf Anwenden.

    Die Zusammenfassungsfelder werden jetzt in den Abfrageergebnissen aktualisiert.

Abfrageergebnisse suchen

Wenn Sie den Inhalt der Abfrageergebnisse suchen möchten, klicken Sie im Bereich Abfrageergebnisse auf In Ergebnissen suchen und geben Sie den Suchbegriff ein. 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 werden hervorgehoben.

Ähnliche Logeinträge ansehen

Sie können Logeinträge aufrufen, die einem ausgewählten Logeintrag ähnlich sind, sodass Sie sich auf für Sie interessante Logs konzentrieren können.

So rufen Sie ähnliche Logeinträge auf:

  1. Maximieren Sie im Bereich Abfrageergebnisse den Logeintrag .

  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 neu geladen:

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

So rufen Sie eine Vorschau der ähnlichen Logeinträge auf:

  1. Maximieren Sie im Bereich Abfrageergebnisse den Logeintrag .

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

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

    • Das gefundene Muster
    • Der Prozentsatz der Logeinträge, die das Muster enthalten
    • Beispiellogeinträge, die das Muster enthalten

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

    Im Dialogfeld „Vorschau von Logeinträgen“ können Sie ähnliche Logeinträge ein- oder ausblenden.

Ähnliche Logeinträge ausblenden

Sie können ähnliche Logeinträge ausblenden. Dadurch können Sie Logs aus den Abfrageergebnissen 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 hin untersucht und Logeinträge werden dann basierend auf dem Inhalt des entsprechenden Logfelds automatisch gruppiert. Wenn ein signifikantes Muster erkannt wird, wird im Bereich Abfrageergebnisse ein Banner mit dem Prozentsatz der Ergebnisse angezeigt, die ausgeblendet werden können:

    Ähnliches Logbanner ausblenden.

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

    Vorschau: Ein separates Fenster mit dem gefundenen Muster und Beispielen für die Einträge wird geöffnet.

    Wenn Sie ähnliche Logs ausblenden, werden außerhalb der Log-Explorer-Sitzung keine Informationen gespeichert. Jede Abfrage erzeugt nur auf Grundlage der angezeigten Logs eine neue Analyse. Unterschiedliche Abfragen analysieren verschiedene Teile der Logeinträge, je nach Art der zurückgegebenen Logs.

  • Logeinträge, die einem bestimmten Logeintrag ähnlich sind, werden ausgeblendet. So blenden Sie Logeinträge ähnlich wie ein Logeintrag aus:

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

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

Logeinträge, die einem Feld entsprechen, ein- oder ausblenden

Sie können Logeinträge, die einem Feld in einem Logeintrag entsprechen, ein- oder ausblenden und sich so auf Einträge mit demselben Feldinhalt konzentrieren.

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

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

  2. Klicken Sie im Logeintrag auf einen Wert, z. B. compute.googleapis.com (serviceName).

    Sie sehen das folgende Menü:

    Menü mit Optionen zum Einblenden und Einblenden 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, die ähnliche Einträge ein- oder ausblendet, und die Abfrageergebnisse werden mit neuen Ergebnissen aktualisiert.

Logeinträge anpinnen

Nachdem Sie eine Abfrage ausgeführt haben, können Sie einen Logeintrag markieren, 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 das Stecknadelsymbol .

Nachdem Sie einen Logeintrag angepinnt haben, wird der Hintergrund abgedunkelt und das Stecknadelsymbol wird angezeigt. Im Bereich Histogramm wird außerdem ein angepinntes Symbol angezeigt, das auf dem 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 Symbol zum Anpinnen.

Logs anzeigen, die der Ressource eines angepinnten Logeintrags entsprechen

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.

Gehen Sie so vor, um einen Logeintrag anzuheften und Logeinträge anzuzeigen, die dem gleichen Ressourcentyp oder den Ressourcenlabels entsprechen:

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

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

    • Wählen Sie Same resource.type aus, um die Abfrage noch einmal mit demselben resource.type wie im angepinnten Log auszuführen.

      Angenommen, Sie anpinnen einen Logeintrag mit dem resource.type k8s_node. 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 im angepinnten Log ausführen möchten, wählen Sie Same resource.labels aus.

    • Wählen Sie Gleicher Trace aus, um die Abfrage noch einmal mit demselben trace wie im angepinnten Log auszuführen.

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

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 das Stecknadelsymbol und wählen Sie eine der folgenden Menüoptionen aus:

  • Scroll to log entry (Zum Logeintrag scrollen): Bringen Sie den Logeintrag in den aktuellen Bereich Abfrageergebnisse und sehen Sie den angepinnten Logeintrag im Kontext von Logs in der Nähe an.
  • Zoom to log entries (Zum Logeintrag zoomen): Schränken Sie den Zeitraum ein, der im Bereich Histogramm angezeigt wird, und optimieren Sie Ihre 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 Trace-Details ansehen.
  • 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

Für bestimmte Logs wie GKE- und Compute Engine-Logs können Sie auf den Ressourcentyp in der Zusammenfassungszeile des Logs klicken, um ein Menü mit folgenden Optionen aufzurufen:

  • 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 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 im Bereich Abfrageergebnisse auf Herunterladen.

  2. Wählen Sie im Dialogfeld Logs herunterladen das CSV- oder JSON-Format aus.

  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.

Beispielabfragen

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

Compute Engine-Logs ansehen

Bei bestimmten Compute Engine-Ressourcentypen, z. B. gce_instance und gce_network, wird der Ressourcenname mit der Ressourcen-ID an mehreren Stellen im Log-Explorer angezeigt. Für den Ressourcentyp gce_instance wird beispielsweise der VM-Name neben der VM-ID angezeigt. Anhand der Ressourcennamen können Sie die richtige Ressourcen-ID ermitteln, auf der Sie Abfragen erstellen können.

Compute Engine-Ressourcennamen können an folgenden Stellen angezeigt werden:

  • Filtermenüs im Abfragebereich: Compute Engine-Ressourcentypen zeigen Ressourcennamen mit den entsprechenden Ressourcen-IDs als Subtext an.
  • Logfelder: In Compute Engine-Ressourcentypen wird in den Felddimensionen der Ressourcenname und nicht die Ressourcen-ID angezeigt.
  • Abfrageergebnisse: Bei Logs der VM-Instanz von Compute Engine werden im Feld resource.labels Metadaten mit dem entsprechenden Ressourcennamen angezeigt.
  • 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.

Informationen zu Problemen beim Aufrufen von Logs in Senkenzielen finden Sie unter Fehlerbehebung für Routing und Senken.

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

Logs, die in die Konsole einer Compute Engine-Instanz geschrieben wurden, sind im Log-Explorer möglicherweise nicht verfügbar. So rufen Sie diese Logs auf:

  1. Rufen Sie die Liste der VM-Instanzen für Ihr Google Cloud-Projekt auf:

    Zu Seite „VM-Instanzen“

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

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

Cloud-Projekt- oder Organisations-ID abrufen

Wenn Sie von einem beliebigen Ort in der Google Cloud Console ein Cloud-Projekt oder eine Organisations-ID abrufen möchten, maximieren Sie die Liste der Cloud-Projekte über die Cloud-Projekt- und Organisationsauswahl und suchen Sie in der Spalte ID nach der 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:

  • Wurde das richtige Cloud-Projekt ausgewählt? Ist dies nicht der Fall, wählen Sie in der Cloud-Projekt- und Organisationsauswahl das erforderliche Cloud-Projekt aus.

  • Nutzt Ihr Cloud-Projekt Ressourcen, die Logs generieren, und sind diese Ressourcen aktiv? Auch bei einem neuen Cloud-Projekt sollten Audit-Logs vorhanden sein, die dessen Erstellung dokumentieren. 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 Umfang zum Aufrufen von Logs verwendet? Eine Anleitung zum Anpassen des Suchbereichs finden Sie unter Umfang 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, verwendet Cloud Logging den Verlauf der Senken im Google Cloud-Projekt, um zu bestimmen, 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 passen die Zeitachse des Histogramms mithilfe der Zeitsteuerelemente des Histogramms oder der Zeitraumauswahl an. Durch das Anpassen dieser Zeitsteuerelemente ä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 anfordern

Informationen zum Anfordern von Support finden Sie auf der Supportseite für die Operations-Suite von Google Cloud.