Logs-Explorer verwenden

In diesem Leitfaden erfahren Sie, wie Sie Logs mit dem Log-Explorer der Google Cloud Console suchen und ansehen.

Sie können Logs auch mit der Logging API und dem Cloud SDK 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 Bereiche, die in den folgenden Abschnitten beschrieben werden:

  1. Aktionsleiste
  2. Query Builder
  3. Logfelder
  4. Histogramm
  5. Abfrageergebnisse

Aktionsleiste

Bereich "Aktionsleiste"

Der Bereich Aktionsleiste enthält folgende Features:

  1. Optionen: Ermöglicht das Aufrufen der Legacy-Loganzeige, das Senden von Feedback und das Aufrufen einer Zusammenfassung neuer Logging-Features.
  2. Suche verfeinern: Ermöglicht es, die Suche nach Logs in Ihrem aktuellen Cloud-Projekt oder auf eine oder mehrere Speicheransichten zu begrenzen. Weitere Informationen zum Eingrenzen des Bereichs finden Sie unter Bereich eingrenzen.
  3. Link freigeben: Hiermit können Sie eine Kurz-URL der aktuellen Abfrage erstellen und in die Zwischenablage kopieren, um das Freigeben einer Abfrage zu erleichtern. Es gibt zwei Optionen: Mit absolutem Zeitraum kopieren und Mit relativem Zeitraum kopieren. Wenn Sie Mit absolutem Zeitraum kopieren auswählen, wird für die kopierte URL der entsprechende absolute Zeitraum angezeigt, der durch den aktuellen Zeitraum dargestellt wird. Beispiel: 7:49:37 PM - 8:49:37 PM. Wenn Sie Mit relativem Zeitraum kopieren auswählen, wird der aktuelle relative Zeitraum in der kopierten URL ausgewählt. Beispiel: 1 hour.
  4. Zeitraumauswahl: Ermöglicht das Eingrenzen der Abfrageergebnisse nach Zeitraum. Standardmäßig beträgt der Zeitraum eine Stunde. Sie können auch die Option Zu Zeitpunkt springen verwenden, um den Zeitraum um einen bestimmten Zeitstempel zu beschränken und zu zentrieren.
  5. Seitenlayout: Ermöglicht das Aktivieren und Deaktivieren der Bereiche Histogramm und Logfeld-Explorer.
  6. Lernen: Ermöglicht das Aufrufen von Links zu relevanten Dokumentationen.

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.

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 im Bereich Aktionsleiste die Option Bereich 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. Unter Bereich nach Speicher wählen Sie einen oder mehrere Buckets aus.

    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.

Query Builder

Query Builder

Im Bereich Query Builder haben Sie folgende Optionen:

  1. Query Builder-Feld: Ermöglicht das Erstellen von Abfragen mithilfe der Logging-Abfragesprache.
  2. Drop-down-Menüs in Query Builder: Ermöglicht das Hinzufügen von Abfrageausdrücken basierend auf Ressource, Logname und Schweregrad. Weitere Informationen finden Sie unter Drop-down-Menüs in Query Builder.
  3. Letzte: Ermöglicht das Aufrufen der letzten Abfragen. Weitere Informationen finden Sie unter Letzte Abfragen.
  4. Gespeichert: Ermöglicht das Aufrufen von gespeicherten Abfragen und Abfragen, die andere Nutzer des Cloud-Projekts für Sie freigegeben haben. Weitere Informationen finden Sie unter Gespeicherte Abfragen und Freigegebene Abfragen.
  5. Vorgeschlagen: Zeigt die vorgeschlagenen Abfragen anhand der Ressourcen in Ihrem Cloud-Projekt an. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen.
  6. Speichern: Ermöglicht das Speichern von Abfragen, die über den Tab Gespeichert angezeigt und ausgeführt werden können.
  7. Logs streamen: Ermöglicht den Aufruf von Logeinträgen, während diese von Logging aufgenommen werden. Weitere Informationen finden Sie unter Logs streamen.
  8. Ausführen: Ermöglicht das Ausführen Ihrer Abfragen, nachdem Sie sie im Feld "Query Builder" erstellt haben.

Logs streamen

Sie können Ihre Logs streamen, während sie von Logging aufgenommen werden, oder einem Stream eine Abfrage hinzuzufügen, um dann nur die Logs zu streamen, die der Abfrage entsprechen.

Wenn Sie Logs auf Basis einer Abfrage streamen möchten, fügen Sie im Feld "Query Builder" eine Abfrage hinzu und wählen dann Logs streamen aus. Während Logging die Logdaten aufnimmt, werden im Bereich Abfrageergebnis nur die Logs angezeigt, die mit der Abfrage übereinstimmen. Wird keine Abfrage bereitgestellt, zeigt Logging jedes Log so an, wie es aufgenommen wird.

Abfrage vor dem Streaming von Logs hinzufügen

Um das Streaming zu beenden, wählen Sie Streaming beenden aus oder scrollen im Bereich Abfrageergebnisse nach unten.

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.

Bereich Logfelder aktivieren

Wählen Sie zum Aktivieren des Bereichs Logfelder die Option Seitenlayout aus und klicken Sie auf das Kästchen Logfelder. Der Bereich Logfelder wird angezeigt.

Ausgewählter Bereich "Logfelder"

Wenn Sie den Bereich Logfelder deaktivieren möchten, entfernen Sie das Häkchen aus dem Kästchen Logfelder.

Features des Bereichs Logfelder

Der Bereich Logfelder wird anhand einer ausgeführten Abfrage im Query Builder befü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.

    Menü mit Option zum Hinzufügen eines Felds.

    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 Query Builder-Ausdruck 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 dem Bereich Logfelder jsonPayload.message hinzugefügt. Wenn Sie einen bestimmten jsonPayload.message-Wert auswählen, wird der Bereich Query Builder gefüllt:

Bereiche "Logfelder" und "Query Builder" mit benutzerdefiniertem Feld.

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.

Bereich "Histogramm" aktivieren

Um den Bereich "Histogramm" zu aktivieren, wählen Sie Seitenlayout aus und klicken auf das Kästchen Histogramm. Der Bereich Histogramm wird angezeigt.

Das Seitenlayout ist geöffnet und "Histogramme" wurde ausgewählt

Um den Bereich "Histogramm" zu deaktivieren, entfernen Sie das Häkchen aus dem Kästchen Histogramm.

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. Histogramm-Zeitachse: Zeigt den Zeitraum der Logs an, dargestellt durch Histogrammleisten, die derzeit im Bereich Abfrageergebnisse angezeigt werden. Mithilfe der Zeitachse können Sie sich auf die Logs konzentrieren, die Sie sich gerade im 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.

Tipp: Wenn Sie die Zeitsteuerung des Histogramms anpassen, werden die Logdaten in den Bereichen Abfrageergebnisse und Logfelder entsprechend dem von der Histogramm-Zeitleiste erfassten Zeitbereich angepasst. Durch das Anpassen der Zeitsteuerelemente des Histogramms wird der Abfrageausdruck im Bereich Query Builder nicht geändert.

Zeit schnell anpassen

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

Zeitachse des Histogrammbereichs mit den Steuerelementen zur schnellen Zeitanpassung.

  • Ziehpunkte der Zeitachse: Ziehen Sie die Ziehpunkte der Zeitachse nach unten, um die Daten einzugrenzen, oder nach außen, um die Daten in der Histogramm-Zeitachse 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 Abwärtspfeil, um die Zeitachse auf einen früheren Zeitpunkt zu verschieben.

  • Vergrößern und verkleinern: Klicken Sie auf das Symbol zum Herauszoomen, um die in der Zeitachse angezeigten Daten 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.

Zeitachse des Histogrammbereichs zeigt die Zeitsteuerelemente "Zur Zeit scrollen" und "Auf Zeit zoomen".

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 dem Feature Zur 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. 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 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

Bereich "Abfrageergebnisse"

Im Bereich Abfrageergebnisse können Sie die Logeinträge untersuchen, die Ihren Abfrageausdrücken und dem Zeitbereich entsprechen, den Sie mit den Zeitsteuerungen des Histogramms oder der Zeitbereichsauswahl ausgewählt haben.

  1. Abfrageergebnisse: Ermöglicht die Anzeige der mit Ihrer Abfrage abgerufenen Logs.
  2. Logeinträge: Ermöglicht die Anzeige von Logeinträgen im strukturierten JSON-Format.
  3. Abfrageergebnisse maximieren und minimieren: Ermöglicht das Erweitern des Bereichs mit Abfrageergebnissen, um weitere Logeinträge aufzurufen.
  4. Zeitzone: Ermöglicht das Ändern der Zeitzone, in der die Logs angezeigt werden.
  5. Trace-Daten: Ermöglicht das Aufrufen von Trace-Details und das Optimieren Ihrer Abfrage basierend auf dem Trace. Weitere Informationen finden Sie unter Trace-Daten ansehen.
  6. Logzusammenfassung verbergen: Ermöglicht das Ausblenden der Zeile mit der Logzusammenfassung aus den Abfrageergebnissen.
  7. Verschachtelte Logfelder maximieren oder minimieren: Ermöglicht das Maximieren oder Minimieren verschachtelter Felder.
  8. In Zwischenablage kopieren: Ermöglicht das Kopieren des Logeintrags im JSON-Format.
  9. Link zu einem Logeintrag kopieren: Ermöglicht die Freigabe eines Links zu einem Logeintrag. Weitere Informationen finden Sie unter Link zu einem Logeintrag kopieren.
  10. Zu jetzt springen: Ermöglicht das Ausführen einer erzwungenen Aktualisierung, um die aktuelle Uhrzeit einzubinden. Wenn für die Zeitraumauswahl ein benutzerdefinierter Bereich verwendet wird und eine Endzeit festgelegt ist, wird die Abfrage mit dem Standardzeitraum von einer Stunde ausgeführt. Andernfalls wird die Abfrage mit dem aktuellen Startdatum oder mit der aktuellen Dauer aktualisiert und ausgeführt. Beachten Sie, dass der Abfrageausdruck nicht geändert wird, wenn Sie dieses Feature verwenden.
  11. Aktionen: Ermöglicht das Ausführen bestimmter Aktionen für Ihre Logs, z. B. das Erstellen eines logbasierten Messwerts oder eines Senkenziels. Weitere Informationen zum Herunterladen von Logs finden Sie unter Logs herunterladen.
  12. Konfigurieren: Ermöglicht das Hinzufügen des Werts eines Logfelds zur Zusammenfassungszeile am Anfang oder Ende des Logeintrags. Außerdem können Sie auswählen, ob die neuesten Logs zuerst oder zuletzt angezeigt werden sollen. Weitere Informationen zum Hinzufügen eines Zusammenfassungsfelds finden Sie unter Zusammenfassungsfelder hinzufügen.
  13. Logeintrag anpinnen: Anpinnen eines Logeintrags an die Bereiche Abfrageergebnisse und Histogramm. Weitere Informationen finden Sie unter Logs anpinnen.
  14. Cursor-Scroll: Wenn Sie durch die Logs in Abfrageergebnisse scrollen, wird der URL cursorTimestamp hinzugefügt, was den timestamp des neuesten Logs angibt, das im aktuellen Bereich Abfrageergebnisse angezeigt wird.

Im Bereich der Abfrageergebnisse können Sie auf die Werte eines Felds klicken und folgende Aktionen ausführen:

Optionen nach Auswahl des Feldwerts

  1. Übereinstimmende Einträge anzeigen: Ermöglicht die Suche nach übereinstimmenden Logeinträgen.
  2. Übereinstimmende Einträge ausblenden: Ermöglicht das Abfragen von Logeinträgen, die nicht mit dem ausgewählten Ausdruck übereinstimmen.
  3. Feld in Zusammenfassungszeile einfügen: Ermöglicht das Hinzufügen des Felds als Zusammenfassungszeile zu Logeinträgen.

Zusammenfassungsfelder hinzufügen

Zusammenfassungsfelder bieten die Möglichkeit, Muster in Ihren Logs schneller zu ermitteln. Die folgende Abbildung enthält beispielsweise den Wert für das Zusammenfassungsfeld resource.labels.pod_name, das vor den Logs eingefügt wurde, die diesen Wert enthalten.

Logs werden im Log-Explorer mit einem grünen Text angezeigt, der Pod-Namen anzeigt.

Zusammenfassungsfeld aus einem Logeintrag hinzufügen

Mit den folgenden Schritten können Sie einem Logeintrag ein Zusammenfassungsfeld hinzufügen:

  1. Klicken Sie zur Maximierung des Logeintrags auf die Maximierungsschaltfläche .

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

    Das Zusammenfassungsfeld wird nun vor den Logeinträgen angezeigt, die dieses Feld enthalten.

Zusammenfassungsfeld mithilfe der Schaltfläche Konfigurieren hinzufügen

Mit den folgenden Schritten fügen Sie mithilfe der Schaltfläche Konfigurieren ein Zusammenfassungsfeld hinzu:

  1. Klicken Sie auf Konfigurieren und wählen Sie Zusammenfassungsfelder verwalten aus.

    Auswahl von "Zusammenfassungsfelder verwalten" aus dem Drop-down-Menü "Konfigurieren"

  2. Fügen Sie Felder hinzu.

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

    • Automatische Vervollständigung anhand der aktuell 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.

  3. Klicken Sie auf Zusammenfassungsfelder kürzen, um die Anzeige der Werte des Zusammenfassungsfelds zu kürzen. Wählen Sie dann aus, wie viele Zeichen angezeigt werden sollen, wenn das Feld gekürzt wird, und ob der Anfang oder das Ende des Felds angezeigt werden soll.

  4. Klicken Sie auf Anwenden.

    Das Zusammenfassungsfeld wird nun vor den Logeinträgen angezeigt, die dieses Feld enthalten.

Logeinträge anpinnen

Durch das Anpinnen eines Logeintrags können Sie einen relevanten Logeintrag hervorheben.

Bewegen Sie dazu den Mauszeiger auf den Logeintrag, den Sie anpinnen möchten, und klicken Sie dann auf das Stecknadelsymbol . Der angepinnte Hintergrund ist ausgegraut und ein Stecknadelsymbol wird angezeigt.

Wenn Sie einen Logeintrag anpinnen und die Abfrage noch einmal ausführen, wird der angepinnte Logeintrag abhängig davon, wie Ihre Logdaten konfiguriert sind, entweder oben oder unten im Bereich Abfrageergebnisse angezeigt. Außerdem wird auf dem Bereich Histogramm ein Stecknadelsymbol angezeigt, das auf dem timestamp des angepinnten Logs basiert.

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

Wählen Sie dazu das Stecknadelsymbol und dann die Option Logeintrag loslösen aus.

Angepinnten Logeintrag im Ressourcenkontext ansehen

Klicken Sie auf das Stecknadelsymbol und wählen Sie Logeinträge für Ressource anpinnen und ansehen aus, um das angepinnte Log im Ressourcenkontext anzuzeigen.

Anpinnen und anzeigen im Ressourcenkontext ist ausgewählt.

Logging füllt den Query Builder mit dem Feld resource.type aus dem angepinnten Logeintrag aus und führt die Abfrage aus. Sie können sich jetzt das angepinnte Log in Verbindung mit dem Ressourcentyp ansehen.

Angepinnten Logeintrag im Bereich Histogramm ansehen

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

Wählen Sie im Bereich Histogramm das Stecknadelsymbol aus und wählen Sie dann eine der folgenden Menüoptionen aus:

  • Zum Logeintrag scrollen: Mit dieser Option wird der Logeintrag in den aktuellen Bereich Abfrageergebnisse verschoben und der angepinnte Logeintrag im Kontext von Logs in der Nähe angezeigt.
  • Zum Logeintrag zoomen: Diese Option begrenzt den Zeitraum, der im Bereich Histogramm angezeigt wird, und Sie können Ihre Abfrage verfeinern, um die Logs in der Nähe des angepinnten Logs zu isolieren.

Der Zeitraum des Histogramms ist begrenzt.

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 jetzt 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. Wählen Sie Aktionen und dann Logs herunterladen aus.

    Laden Sie Logs über die Schaltfläche „Aktion“ herunter.

  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

Die Seite Beispielabfragen mit dem Log-Explorer bietet vorgeschlagene Abfragen, mit denen Sie Logs finden, die für Sie von Interesse sein können. Beispiel: Sie können Kubernetes-bezogene Abfragen ausführen, um Google Kubernetes Engine-Logs zu finden.

Fehlerbehebung

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

Cloud-Projekt- oder Organisations-ID abrufen

Zum Abrufen einer Cloud-Projekt- oder Organisations-ID an einer beliebigen Stelle in der Google Cloud Console erweitern Sie die Liste der Cloud-Projekte in der Cloud-Projekt- und Organisationsauswahl und suchen Sie die Cloud-Projekt-ID in der Spalte 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.

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 ermitteln, wo Einträge für diese Ressource geschrieben wurden. Wenn Cloud Logging mehr als 200 Buckets ermittelt, in die 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 Histogrammzeitachse mit den Zeitsteuerelementen des Histogramms oder der Zeitraumauswahl an. Durch das Anpassen dieser Zeitkontrollen wird der Abfrageausdruck im Bereich Query Builder 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.