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 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 aufrufen und ansehen, um Probleme zu beheben.

Aggregierte Vorgänge wie das Zählen der Logeinträge mit einem bestimmten Muster werden im Log-Explorer nicht unterstützt. Für zusammengefasste Vorgänge aktivieren Sie Analysen für den 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 – Übersicht.

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

Erste Schritte

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 beschrieben werden:

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

Symbolleiste Aktion

Mit den Funktionen der Symbolleiste Aktion können Sie Folgendes tun:

  • Umfang eingrenzen: Grenzen Sie Ihre Suche nur nach Logs in Ihrem aktuellen Cloud-Projekt oder nach einer oder mehreren Speicheransichten ein. Weitere Informationen zum Umfang finden Sie unter Umfang eingrenzen.
  • Weitere Informationen: Links zu relevanten Dokumenten und Themen
  • Link freigeben: Erstellen Sie eine gekürzte URL der aktuellen Abfrage und kopieren Sie sie in die Zwischenablage. So können Sie eine Abfrage leichter freigeben. 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 Logansichten in Ihren Logbuckets verwalten.

  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 können Sie Folgendes tun:

  • Tab Query (Abfragen): Erstellen und optimieren Sie Abfragen mit den folgenden Funktionen:

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

    • Suchfeld: Hiermit finden Sie Protokolleinträge, die Ihren Suchbegriffen oder Wortgruppen entsprechen. Weitere Informationen finden Sie unter Text in Logfeldern suchen.

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

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

  • Tab Zuletzt verwendet: 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 mit Ihnen geteilt 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 Bibliothek: Abfragen von Google 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 angezeigt und ausgeführt werden können.

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

  • Logs streamen: Sehen Sie sich Logeinträge an, während sie in 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 sie auch im Feld „Abfrageeditor“ angezeigt und als Teil Ihres Abfrageausdrucks ausgewertet.

Nachdem Sie die Abfrage geprüft haben, klicken Sie auf Abfrage ausführen. Logs, die Ihrer Abfrage entsprechen, werden im Bereich Abfrageergebnisse aufgelistet. Die Bereiche Histogramm und Logfelder werden ebenfalls an den Abfrageausdruck angepasst.

Logs streamen

Sie können Logs streamen, während sie von Logging aufgenommen werden. Sie können auch 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. Wenn Logging die Logdaten aufnimmt, werden nur die Logs, die der Abfrage entsprechen, im Bereich Abfrageergebnisse angezeigt. Wird keine Abfrage bereitgestellt, zeigt Logging jedes Log so an, wie es aufgenommen wird.

Wenn Sie das Streaming beenden möchten, klicken Sie auf Streaming beenden oder scrollen Sie im Bereich Abfrageergebnisse.

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse haben Sie folgende Möglichkeiten:

  • Bereich Logs anzeigen: Dieser Bereich im Log-Explorer-Seitenlayout kann schnell ein- oder ausgeblendet werden.
  • Bereich Histogramm anzeigen: Diesen Bereich im Log-Explorer-Seitenlayout schnell ein- oder ausblenden.
  • Messwert erstellen: Richten Sie einen logbasierten Messwert auf der Grundlage des aktuellen Abfrageausdrucks ein.
  • Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigung auf der Grundlage Ihres aktuellen Abfrageausdrucks ein.
  • Zu jetzt springen: Führen Sie eine erzwungene Aktualisierung Ihrer Abfrageergebnisse durch, um die aktuelle Zeit einzubeziehen. Wenn die Zeitraumauswahl einen benutzerdefinierten Zeitraum verwendet und ein Ende 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. Beachten Sie, dass der Abfrageausdruck nicht geändert wird, wenn Sie dieses Feature verwenden.
  • Weitere Aktionen: Verwenden Sie diese weiteren Optionen, um logbasierte Benachrichtigungen zu verwalten oder eine Senke zu 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.

Zum Ein- oder Ausblenden des Bereichs Logfelder klicken Sie in der Symbolleiste Ergebnisse auf die Schaltfläche Logfelder.

Der Bereich Logfelder wird anhand einer ausgeführten Abfrage im Feld „Abfrageeditor“ 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 mit der linken Maustaste 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. Sie können ein benutzerdefiniertes Feld auch aus der Liste entfernen. Klicken Sie dazu im Bereich Abfrageergebnisse mit der linken Maustaste darauf und wählen Sie Aus "Logfelder" entfernen aus.

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 verfeinern 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 Feld „Abfrageeditor“ 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 der 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-Funktionen

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, die durch Histogrammbalken dargestellt werden und derzeit im Bereich Abfrageergebnisse angezeigt werden. Die Zeitachse hilft Ihnen dabei, sich die Logs anzusehen, die Sie sich derzeit im größeren Zeitraum Ihrer 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.

In der Histogrammzeitleiste sind die Schnelleinstellungen zu sehen.

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

  • Zeitleiste vor- und zurückbewegen: 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: Klicken Sie auf das Herauszoomen-Symbol, um die in der Zeitachse angezeigten Daten zu erweitern. Klicken Sie auf das Zoomsymbol , um die in der Zeitachse angezeigten Daten einzuschränken.

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

In der Zeitachse des Histogramms werden die Scroll-Zeit- und Zoom-Zeitsteuerelemente angezeigt.

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 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 Zeitachse Histogramm. 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 die Logeinträge ansehen, die mit Ihren Abfrageausdrücken und dem von Ihnen ausgewählten Zeitraum übereinstimmen. Dazu verwenden Sie die Histogramme des Histogramms oder die Zeitraumauswahl:

Bereich "Abfrageergebnisse"

Im Bereich Abfrageergebnisse haben Sie folgende Möglichkeiten:

  • Abfrageergebnisse: Sehen Sie sich die abgerufenen Logeinträge aus Ihrer Abfrage im strukturierten JSON-Format an. Klicken Sie auf Vollbild-Abfrageergebnisse eingeben , um die Abfrageergebnisse zu maximieren.
  • Zeitzone: Ändern Sie die Zeitzone, in der Logs angezeigt werden.
  • Logs herunterladen: Laden Sie Logs aus den Abfrageergebnissen herunter.
  • Ähnliche Logs ausblenden: Blenden Sie viele ähnliche Logs in den Abfrageergebnissen aus.
  • Trace-Daten: Sehen Sie sich die Trace-Details an und verfeinern Sie Ihre Abfrage basierend auf dem Trace. Weitere Informationen finden Sie unter Trace-Daten ansehen.
  • Logzusammenfassung ausblenden: Logzeile in den Abfrageergebnissen ausblenden.
  • Verschachtelte Logfelder maximieren oder minimieren: Verschachtelte Felder maximieren oder minimieren.
  • In Zwischenablage kopieren: Der Logeintrag wird im JSON-Format kopiert.
  • Link in einen Logeintrag kopieren: Geben Sie einen Link zu einem Logeintrag frei. Weitere Informationen finden Sie unter Link zu einem Logeintrag kopieren.
  • Schaltfläche Bearbeiten in der Spaltenüberschrift Zusammenfassung: Fügen Sie den Zusammenfassungszeilen Ihrer Logeinträge den Wert eines Logfelds hinzu. Sie können die standardmäßigen Zusammenfassungsfelder auch vollständig ausblenden, um eine reine Textdarstellung Ihrer Einträge zu erhalten. Weitere Informationen finden Sie unter Zusammenfassungsfelder hinzufügen und verwalten.
  • Logeintrag anpinnen: Logeintrag werden in den Bereichen Abfrageergebnisse und Histogramm angepinnt. Weitere Informationen finden Sie unter Logs anpinnen.
  • Scrollscroll: Scrollt die Logs in Abfrageergebnisse. Die URL wird so angepasst, dass cursorTimestamp enthalten ist. Damit wird angegeben, dass die timestamp des neuesten Log im aktuellen Abfrageergebnisse angezeigt wird.

Im Bereich mit den Abfrageergebnissen können Sie auf die Werte eines Felds klicken, um Folgendes zu tun:

  • Übereinstimmende Einträge anzeigen: Abfrage für übereinstimmende Logeinträge.
  • Übereinstimmende Einträge ausblenden: Abfrage von Logeinträgen, die nicht mit dem ausgewählten Ausdruck übereinstimmen.
  • Feld in Zusammenfassungszeile einfügen: Fügen Sie das Feld als Zusammenfassungszeile für Logeinträge hinzu.

Zusammenfassungsfelder hinzufügen und verwalten

Mithilfe von Zusammenfassungsfeldern können Sie Muster in Ihren Logs schneller erkennen.

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

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

Der Log-Explorer bietet Standardfelder für Zusammenfassungen, die von Ihren aktuellen Abfrageergebnissen abhängen, sowie benutzerdefinierte Zusammenfassungsfelder, mit denen Sie beliebige Felder in LogEntry ausrichten können.

Sie können sowohl benutzerdefinierte als auch Standard-Zusammenfassungsfelder über ein Bearbeitungsmenü in Ihren Abfrageergebnissen verwalten. Sie können auch direkt aus einem erweiterten Logeintrag benutzerdefinierte Zusammenfassungsfelder hinzufügen.

Benutzerdefiniertes Zusammenfassungsfeld aus einem Logeintrag hinzufügen

So fügen Sie ein benutzerdefiniertes Zusammenfassungsfeld direkt aus einem Logeintrag hinzu:

  1. Maximieren Sie einen Logeintrag, indem Sie auf die Schaltfläche „Maximieren“ klicken.

  2. Klicken Sie auf den Wert eines Felds und wählen Sie Feld in Zusammenfassungszeile einfügen aus.

Das Zusammenfassungsfeld wird jetzt als Chip vor den Logeinträgen angezeigt, die dieses Feld enthalten.

Wenn Sie ein benutzerdefiniertes Zusammenfassungsfeld entfernen möchten, klicken Sie in der Logeintragszeile auf den entsprechenden Chip und wählen Sie Feld aus Zusammenfassungszeile entfernen aus. Weitere Informationen zu benutzerdefinierten Zusammenfassungsfeldern finden Sie im nächsten Abschnitt.

Zusammenfassungsfelder über das Bearbeitungsmenü verwalten

So verwalten Sie Ihre benutzerdefinierten und standardmäßigen Zusammenfassungsfelder über das Bearbeitungsmenü:

  1. Klicken Sie auf Bearbeiten, um das Bearbeitungsmenü zu öffnen:

    Im Bereich für die Abfrageergebnisse wird die Schaltfläche zum Bearbeiten von Zusammenfassungsfeldern angezeigt.

  2. Führen Sie im Dialogfeld Zusammenfassungsfelder verwalten die folgenden Schritte aus:

    1. Aktivieren oder deaktivieren Sie mithilfe des Umschalters die Option Standardzusammenfassungsfelder.

      Wenn Sie die standardmäßigen Zusammenfassungsfelder deaktivieren und keine benutzerdefinierten Zusammenfassungsfelder hinzufügen, werden Ihre Logeinträge im Rohtextformat angezeigt.

    2. Fügen Sie den benutzerdefinierten Zusammenfassungsfeldern Namen von benutzerdefinierten Feldern hinzu.

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

      • Automatische Vervollständigung anhand der Logs, die derzeit in Ihren Abfrageergebnissen angezeigt werden.
      • 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 mit der Funktion zur automatischen Vervollständigung vorgeschlagen wird.

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

    3. Sie können die Kürzung für die benutzerdefinierten Zusammenfassungsfelder aktivieren oder deaktivieren. Verwenden Sie die Ein-/Aus-Schaltfläche , um Zusammenfassungsfelder zu kürzen, um die Anzeige der Werte des Zusammenfassungsfelds zu kü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 werden soll.

  3. Klicken Sie auf Anwenden.

    Die Zusammenfassungsfelder werden jetzt in den Abfrageergebnissen aktualisiert.

Ähnliche Logeinträge ausblenden

Sie können Logs ausblenden, um schnell große Mengen ähnlicher Logeinträge aus den Abfrageergebnissen zu entfernen.

Wenn Sie eine Abfrage ausführen, werden die Abfrageergebnisse auf Muster analysiert, die im Bereich Abfrageergebnisse zur Anzeige gesendet werden. Logeinträge werden dann anhand von ähnlichen Logfeldinhalten automatisch gruppiert. Wenn ein signifikantes Muster erkannt wird, wird im Bereich Abfrageergebnisse ein Banner mit dem Prozentsatz ähnlicher Ergebnisse angezeigt, die ausgeblendet werden können:

Ähnliches Logbanner ausblenden

Klicken Sie auf Ähnliche Einträge ausblenden, um ähnliche Logs auszublenden. Dadurch wird der Abfrage eine Klausel hinzugefügt und die Abfrageergebnisse neu geladen.

Wenn Sie eine Vorschau der ausgeblendeten Logeinträge sehen möchten, klicken Sie auf Vorschau. Es wird ein separates Fenster geöffnet, in dem das gefundene Muster beschrieben wird. Außerdem werden Beispiele für die ausgeblendeten Einträge angezeigt.

Wenn Sie ähnliche Logs ausblenden, werden außerhalb der Log-Explorer-Sitzung keine Informationen gespeichert. Außerdem gibt es für jede Abfrage eine neue Analyse, die nur auf den angezeigten Logs basiert. Verschiedene Abfragen analysieren unterschiedliche Teile der Logeinträge, je nachdem, welche Arten von Logs zurückgegeben werden.

Logeinträge anpinnen

Sie können einen Logeintrag anpinnen, um einen relevanten Logeintrag zu markieren.

So pinnen Sie einen Logeintrag an:

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

Nachdem Sie einen Logeintrag angepinnt haben, wird der Hintergrund abgeblendet und das Symbol „Anpinnen“ wird angezeigt.

Wenn Sie einen Logeintrag anpinnen und die Abfrage noch einmal ausführen, wird der angepinnte Logeintrag entweder oben oder unten im Bereich Abfrageergebnisse angezeigt, je nachdem, wie Sie die Logdaten konfiguriert haben. Im Bereich Histogramm wird außerdem ein PIN-Symbol basierend auf dem angepinnten Logeintrag timestamp angezeigt:

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

Klicken Sie noch einmal auf das Symbol zum Anpinnen, um den Logeintrag loszulösen.

Angepinnten Logeintrag im Ressourcenkontext ansehen

Wenn Sie einen Logeintrag anpinnen und in verschiedenen Ressourcenkontexten aufrufen, wird die Abfrage mit denselben Ressourceninformationen wie beim angepinnten Logeintrag noch einmal ausgeführt.

So rufen Sie den angepinnten Logeintrag in verschiedenen Ressourcenkontexten auf:

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

  2. Im Menü „Anpinnen“ können Sie sich den Logeintrag in folgenden Ressourcenkontexten ansehen:

    • Identisch resource.type: Die Abfrage wird mit derselben resource.type wie im angepinnten Log noch einmal ausgeführt.

    • Identisch resource.labels: Die Abfrage wird mit derselben resource.labels wie im angepinnten Log noch einmal ausgeführt.

    • Identisch trace: Die Abfrage wird mit demselben Trace noch einmal ausgeführt wie beim angepinnten Log.

    • Alle anzeigen: Löscht die Abfrage und führt sie noch einmal aus.

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 Symbol „Anpinnen“ und wählen Sie eine der folgenden Menüoptionen aus:

  • Zum Logeintrag scrollen: Logeintrag in den aktuellen Bereich Abfrageergebnisse verschieben und den angepinnten Logeintrag im Kontext von Logs in der Nähe ansehen.
  • Auf Logeintrag zoomen: Grenzen Sie den Zeitraum ein, der im Bereich Histogramm angezeigt wird, 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 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 Google Kubernetes Engine-Logs zu finden.

Compute Engine-Logs ansehen

Bei bestimmten Compute Engine-Ressourcentypen wie gce_instance und gce_network wird der Ressourcenname im Ressourcen-Explorer an mehreren Stellen im Log-Explorer angezeigt. Für den Ressourcentyp gce_instance sehen Sie beispielsweise den VM-Namen neben der VM-ID. 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: In Compute Engine-Ressourcentypen werden Ressourcennamen mit den entsprechenden Ressourcen-IDs als Subtext angezeigt.
  • Logfelder: In Compute Engine-Ressourcentypen wird in den Felddimensionen der Ressourcenname und nicht die Ressourcen-ID angezeigt.
  • Abfrageergebnisse: Bei Compute Engine-VM-Instanzlogs werden im Feld resource.labels Metadaten mit dem entsprechenden Ressourcennamen angezeigt.
  • Zusammenfassungsfelder: Bei Compute Engine-VM-Instanzlogs wird anstelle der Ressourcen-ID der Ressourcenname angezeigt.

Problembehebung

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 bei Routing und Senken.

Cloud-Projekt- oder Organisations-ID abrufen

Wenn Sie von einer beliebigen Stelle in der Google Cloud Console ein Cloud-Projekt oder eine Organisations-ID erhalten möchten, maximieren Sie die Liste der Cloud-Projekte über das Cloud-Projekt und die 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 ausführen, 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 Einträge möglicherweise 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 Histogrammzeitachse mit den Zeitsteuerungen des Histogramms oder der Zeitraumauswahl anpassen. Durch das Anpassen dieser Zeitsteuerelemente wird der Abfrageausdruck im Bereich Query nicht geändert.

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.