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

Log-Explorer verwenden

Hinweis

Zur Anzeige der Logs, die Sie von einem AWS-Konto (Amazon Web Services) an Logging senden, wählen Sie in der Projektauswahl in der Google Cloud Console das AWS-Verbindungsprojekt und dann Verwenden Sie die Legacy-Loganzeige. Das AWS-Verbindungsprojekt speichert den Amazon Resource Name (ARN) für Ihr AWS-Konto und verknüpft Ihr AWS-Konto mit Google Cloud-Diensten. Weitere Informationen finden Sie unter Projekt oder Konto einem Arbeitsbereich hinzufügen.

Erste Schritte

So gehen Sie zum Log-Explorer:

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

Sie befinden sich jetzt im Log-Explorer.

Oberfläche des Log-Explorers

Mit der Oberfläche des Log-Explorers können Sie Logs abrufen, Logdaten parsen und analysieren und Ihre Abfrageparameter verfeinern.

Benutzeroberfläche für den Log-Explorer

  1. Seite „Logs Explorer“: Ermöglicht das Erstellen, Analysieren und Optimieren von Abfragen.
  2. Organisation und Projektauswahl: Ermöglicht das Aufrufen von Logs auf Organisations- oder Projektebene.
  3. Query Builder: Ermöglicht das Erstellen von Abfragen entweder über die Drop-down-Menüs oder über die Query Builder-Sprache. Hier finden Sie auch Tabs mit Informationen zu Ihren gespeicherten und aktuellen Suchanfragen.
  4. Log-Felder (Beta): Hiermit können Sie aggregierte Ergebnisse für resource.type, resource.labels, logName und severity abrufen und Sie haben eine effizientere Möglichkeit zur Verfeinerung einer Abfrage.
  5. Histogramm: Ermöglicht die Visualisierung der Häufigkeit Ihrer Logdaten.
  6. Abfrageergebnisse: Ermöglicht die Anzeige der mit Ihrer Abfrage abgerufenen Logs.
  7. Logeinträge: Ermöglicht die Anzeige von Logeinträgen im strukturierten JSON-Format.
  8. Zeitzone: Ermöglicht das Ändern der Zeitzone, in der die Logs angezeigt werden.
  9. Seitenlayout: Ermöglicht das Aktivieren und Deaktivieren der Bereiche Histogramm und Logfeld-Explorer.
  10. Zeitraumauswahl: Ermöglicht das Einschränken der Ergebnisse nach Zeitraum. Standardmäßig beträgt der Zeitraum eine Stunde.
  11. Abfrage ausführen: Ermöglicht das Ausführen Ihrer Abfragen, nachdem Sie sie im Query Builder-Fenster erstellt haben.
  12. 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.
  13. Aktionen: Ermöglicht das Ausführen bestimmter Aktionen für Ihre Logs, z. B. das Erstellen eines logbasierten Messwerts oder eines Senkenziels.
  14. 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.
  15. Logzusammenfassung verbergen: Ermöglicht das Ausblenden der Zeile mit der Logzusammenfassung aus den Abfrageergebnissen.
  16. Verschachtelte Logfelder maximieren oder minimieren: Ermöglicht das Maximieren oder Minimieren verschachtelter Felder.
  17. In Zwischenablage kopieren: Ermöglicht das Kopieren des Logeintrags im JSON-Format.
  18. Speichern: Ermöglicht das Speichern von Abfragen, die über den Tab Gespeichert angezeigt und ausgeführt werden können.
  19. Trace-Daten: Ermöglicht das Aufrufen von Trace-Details und das Optimieren Ihrer Abfrage basierend auf dem Trace.
  20. Abfrageergebnisse maximieren und minimieren: Ermöglicht das Erweitern des Bereichs mit Abfrageergebnissen, um weitere Logeinträge aufzurufen.
  21. Zeitraum anpassen: Ermöglicht die Anpassung des Zeitraums für Abfragen durch Anpassung der Ziehpunkte. Klicken Sie nach dem Anpassen der Ziehpunkte auf Ausführen, um den in der Abfrage verwendeten Zeitraum zu aktualisieren.
  22. Suche verfeinern: Ermöglicht es, ihre Suche auf Logs in Ihrem aktuellen Projekt oder auf eine oder mehrere Speicheransichten zu begrenzen.
  23. Logeintrag anpinnen: Anpinnen eines Logeintrags an die Bereiche Abfrageergebnisse und Histogramm. Abhängig von der Konfiguration des Abfrageergebnissebereichs pinnt Logging das Log entweder oben oder unten im Bereich Abfrageergebnisse an, um die Option zu aktivieren.
  24. Link zu einem Logeintrag kopieren: Ermöglicht die Freigabe eines Links zu einem Logeintrag.
  25. Histogramm des Darstellungsbereichs: Zeigt den Zeitraum der Logs an, die derzeit im Bereich Abfrageergebnisse angezeigt werden.
  26. 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.
  27. Logs streamen: Ermöglicht den Aufruf von Logeinträgen, während diese von Logging aufgenommen werden.

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

  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.

Optionen nach Auswahl des Feldwerts

Bereich eingrenzen

Sie können den Umfang der im Log-Explorer angezeigten Logs im Bereich Bereich verfeinern eingrenzen. Sie können nur nach Logs innerhalb des aktuellen Projekts oder in einer oder mehreren Speicheransichten suchen.

Führen Sie die folgenden Schritte aus, um den Bereich des Log-Explorers einzuschränken.

  1. Wählen Sie im Menü „Logging“ Log-Explorer aus.

    Log-Explorer aufrufen

  2. Wählen Sie Bereich eingrenzen aus.

  3. Wählen Sie im Steuerfeld Bereich eingrenzen die Option Nach Umfang aus.

    Steuerfeld "Bereich eingrenzen"

    • Mit der Option Auf Projekt beschränken können Sie Logs prüfen, die vom aktuellen Projekt generiert werden.

    • Mit Auf Speicherort einschränken können Sie Logs basierend auf einer oder mehreren Speicheransichten prüfen. Weitere Informationen zu Log-Ansichten finden Sie unter Logansichten in Ihren Log-Buckets verwalten.

  4. Unter Auf Speicherort einschränken wählen Sie einen oder mehrere Buckets aus.

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

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

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 mit diesem Wert eingefügt wurde.

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.

Bereich „Logfelder“

Der Bereich Logfelder bietet eine allgemeine Zusammenfassung der Logdaten und eine effizientere Möglichkeit zur Verfeinerung einer Abfrage. Darin wird die Anzahl der Logeinträge für das angegebene Logfeld abnehmend sortiert angezeigt. Die Anzahl der Logfelder entspricht dem Zeitraum, der im Feld Histogramm festgelegt ist.

Der Bereich Logfelder wird anhand einer ausgeführten Abfrage ausgefüllt und aktualisiert. Wenn eine Abfrage leer ist, wird im Bereich Logfelder die Anzahl der Logeinträge nach Ressourcentyp und Log-Schwerefeldern angezeigt

Im Bereich „Logfelder“ werden die Daten des Logfelds angezeigt.

Bereich „Logfelder“ verwenden

Sie können im Query Builder Felder aus dem Bereich Logfelder hinzufügen, um eine Abfrage einzugrenzen und zu verfeinern. Klicken Sie dazu im Feld Logfelder auf einen Feldwert. Dadurch wird das Logfeld in Query Builder eingefügt und die Abfrage automatisch ausgeführt. Dazu wird das Logfeld der ursprünglichen Abfrage mit dem Operator AND als Ausdruck hinzugefügt.

Beim Ausführen einer Abfrage wird die Anzahl der Logfelder inkrementell geladen, da die Logeinträge schrittweise gescannt werden. Wenn die Abfrage abgeschlossen ist – erkennbar am Ausblenden der blauen Fortschrittsanzeige –, sehen Sie die Gesamtzahl für alle Logfelder.

Feld "Histogramm"

Im Feld "Histogramm" können Sie die Verteilung der Logs im Zeitverlauf visualisieren. Damit lassen sich Trends in Ihren Logdaten leichter erkennen und Probleme beheben.

Feld "Histogramm" aktivieren

Um das Feld "Histogramm" zu aktivieren, wählen Sie Seitenlayout aus und klicken auf das Kästchen Histogramm. Das Feld Histogramm wird dann angezeigt.

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

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

Feld "Histogramm" verwenden

Wenn Sie eine Abfrage ausführen, wird ein Histogramm generiert. Es zeigt die Häufigkeit übereinstimmender Logeinträge für den ausgewählten Zeitraum an.

Logs analysieren

Um Ihre Logdaten zu analysieren, bewegen Sie den Mauszeiger auf einen Balken im Feld Histogramm und wählen Sie Zu Zeitpunkt springen aus, um einen kleineren Zeitraum auszuwählen. Dadurch wird eine neue Abfrage mit dieser Zeitraumbeschränkung ausgeführt.

Loghistogramme mit Pop-up-Dialogfeld "Zu Zeitpunkt springen"

Das Feld Histogramm bietet einen Darstellungsbereich, der den Zeitraum der Logs anzeigt, die im Bereich Abfrageergebnisse angezeigt werden. Mit dem Darstellungsbereich können Sie sich auf die Logs konzentrieren, die Sie sich im größeren Zeitraum ansehen.

Die Größe des Darstellungsbereichs basiert auf der Dauer zwischen dem Höchstwert und dem Minimum timestamp der Logeinträge, die im Bereich Abfrageergebnisse angezeigt werden.

Im Bereich "Histogramm" wird der Darstellungsbereich angezeigt.

Trace-Daten

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 Flyout-Fenster 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.

Logs anpinnen

Durch das Anpinnen eines Logs können Sie einen relevanten Logeintrag hervorheben. Bewegen Sie dazu den Mauszeiger auf das Log, das Sie anpinnen möchten, und klicken Sie dann auf das Stecknadelsymbol . Der angepinnte Hintergrund ist ausgegraut und ein Stecknadelsymbol wird angezeigt.

Sobald Sie ein Log angepinnt und Ihre Abfrage noch einmal ausgeführt haben, wird das angepinnte Log dann abhängig davon, wie Ihre Logs konfiguriert sind, entweder oben oder unten im Bereich Abfrageergebnisse angezeigt. Außerdem wird auf dem Bereich Histogramm ein Pin-Symbol 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 Symbol "Anpinnen" und dann die Option Logeintrag loslösen aus.

Angepinnten Logeintrag im Ressourcenkontext ansehen

Sie können das angepinnte Log im Ressourcenkontext ansehen. Dadurch können Sie Logeinträge im angepinnten Log mit dem Ressourcentyp des angepinnten Logs prüfen.

Klicken Sie auf das Symbol "Anpinnen" und wählen Sie Logeinträge anpinnen und anzeigen aus, um das angepinnte Log im Ressourcenkontext anzuzeigen.

Anpinnen und anzeigen im Ressourcenkontext ist ausgewählt.

Logging füllt den Query Builder mit dem Ressourcentyp aus dem angepinnten Log 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 das angepinnte Log auswählen und dann auf Zum Logeintrag heranzoomen klicken, um den Zeitraum im Bereich Histogramm zu begrenzen. Auf diese Weise können Sie Ihre Abfrage verfeinern, um die Logs in der Nähe des angepinnten Logs zu isolieren.

Der Zeitraum des Histogramms ist begrenzt.

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 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 die folgenden Rollen, 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 und wählen Sie aus, ob die Logs auf Ihren Computer oder in Google Drive heruntergeladen oder auf einem neuen Tab angezeigt werden sollen.

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

Logs streamen

Sie können alle 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 Bereich Query Builder eine Abfrage hinzu und wählen dann Logs streamen aus. Während Logging Logdaten aufnimmt, werden im Bereich Abfrageergebnis nur die Logs angezeigt, die mit der Abfrage übereinstimmen. Wird keine Abfrage bereitgestellt, so zeigt Logging jedes Log so an, wie es aufgenommen wird.

Abfrage vor dem Streamen von Logs hinzufügen

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

Fehlerbehebung

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

Cloud-Projekt oder Organisation auswählen

Verwenden Sie die Projekt- und Organisationsauswahl, um ein Cloud-Projekt von einer beliebigen Stelle in der Google Cloud Console, einschließlich des Log-Explorers, auszuwählen:

Auswahl eines Projekts aus dem Dropdown-Menü

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 Projekte in der Projekt- und Organisationsauswahl und suchen Sie die 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 Projekt ausgewählt? Ist dies nicht der Fall, wählen Sie in der Projekt- und Organisationsauswahl das erforderliche Projekt aus.

  • Nutzt Ihr Projekt Ressourcen, die Logs generieren, und sind diese Ressourcen aktiv? Auch bei einem neuen 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, um sicherzustellen, dass die gesuchten Logs nicht versehentlich ausgeschlossen werden.

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

  • Logeinträge, die älter als die Aufbewahrungsdauer von Logging sind, 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.

Support

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