Logs-Explorer verwenden

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

  • Informationen zum Lesen von Logeinträgen mithilfe der Logging API finden Sie unter entries.list.
  • Informationen zum Lesen von Logeinträgen mithilfe des Cloud SDK finden Sie unter Logeinträge lesen.

Verwenden Sie die Legacy-Loganzeige, um die Logs aufzurufen, die Sie von einem AWS-Konto (Amazon Web Services) an Logging senden.

Erste Schritte

So verwenden Sie den Log-Explorer:

  • Prüfen Sie, ob Sie die richtige Rolle für Identity and Access Management haben, um Logs aufzurufen. Informationen zu IAM-Berechtigungen finden Sie in der Anleitung zur Zugriffssteuerung.

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

Über die Oberfläche von Logs Explorer können Sie Logs abrufen, Logdaten parsen und analysieren sowie Ihre Abfrageparameter optimieren.

Benutzeroberfläche für den Log-Explorer

Der Log-Explorer enthält die folgenden Bereiche:

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

Aktionsleiste

Bereich der Aktionsleiste

Der Bereich Aktionsleiste bietet folgende Funktionen:

  1. Optionen: Damit können Sie die Legacy-Loganzeige aufrufen, Feedback senden und eine Zusammenfassung der neuen Logging-Features aufrufen.
  2. Bereich eingrenzen: Ermöglicht das Einschränken Ihrer Suche nach Logs in Ihrem aktuellen Cloud-Projekt oder nach einer oder mehreren Speicheransichten. Weitere Informationen zum Umfang finden Sie unter Bereich eingrenzen.
  3. Link teilen: Hiermit können Sie eine Kurz-URL der aktuellen Abfrage erstellen und in die Zwischenablage kopieren, um die Abfrage zu vereinfachen. Es stehen zwei Optionen zur Verfügung: Mit absolutem Zeitraum kopieren und Mit relativem Zeitraum kopieren. Wenn Sie Mit absolutem Zeitraum kopieren auswählen, enthält die kopierte URL den entsprechenden absoluten Zeitraum, 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 für die kopierte URL der aktuelle relative Zeitraum ausgewählt. Beispiel: 1 hour.
  4. Zeitraumauswahl: Hiermit können Sie Abfrageergebnisse nach Zeitraum einschränken. Der Standardzeitraum beträgt eine Stunde.
  5. Seitenlayout: Ermöglicht das Aktivieren und Deaktivieren der Bereiche Histogramm und Logfeld-Explorer.
  6. Lernen: Links zu relevanten Dokumentationen

Bereich eingrenzen

Mit der Option Bereich eingrenzen können Sie den Bereich der im Log-Explorer angezeigten Logs optimieren. Sie können nur Logs im aktuellen Cloud-Projekt oder in einer oder mehreren Speicheransichten suchen. So optimieren 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 Umfang nach aus.

    Dialogfeld "Bereich eingrenzen"

    • Mit Bereich nach Projekt können Sie Logs durchsuchen, 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 Log-Buckets verwalten.

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

    Das Dialogfeld enthält Speicheransichten, die die folgenden 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 Möglichkeiten:

  1. Query Builder-Feld: Ermöglicht das Erstellen von Abfragen mit der Logging-Abfragesprache.
  2. Drop-down-Menüs von Query Builder: Ermöglicht das Hinzufügen von Abfrageausdrücken nach Ressource, Logname und Schweregrad. Weitere Informationen finden Sie unter Drop-down-Menüs von Query Builder.
  3. Zuletzt verwendet: Die letzten Abfragen werden angezeigt. Weitere Informationen finden Sie unter Aktuelle Abfragen.
  4. Gespeichert: Ermöglicht das Aufrufen Ihrer gespeicherten Abfragen und Abfragen, die andere Nutzer des Cloud-Projekts mit Ihnen geteilt haben. Weitere Informationen finden Sie unter Gespeicherte Abfragen und Freigegebene Abfragen.
  5. Vorgeschlagen: Hiermit können Sie vorgeschlagene Abfragen aufrufen, die auf den Ressourcen in Ihrem Cloud-Projekt basieren. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen.
  6. Speichern: Ermöglicht das Speichern von Abfragen, die über den Tab Gespeichert aufgerufen und ausgeführt werden können.
  7. Streamlogs: Damit können Sie Logeinträge aufrufen, wenn Logging sie aufnimmt. Weitere Informationen finden Sie unter Stream-Logs.
  8. Ausführen: Ermöglicht das Ausführen von Abfragen, nachdem Sie sie im Feld "Query Builder" erstellt haben.

Logs streamen

Sie können Ihre Logs streamen, während Logging sie aufnimmt, oder Sie können eine Abfrage hinzufügen, um nur die Logs zu streamen, die mit der Abfrage übereinstimmen.

Um Logs basierend auf einer Abfrage zu streamen, fügen Sie im Feld "Query Builder" eine Abfrage hinzu und wählen Sie dann Stream-Logs aus. Bei der Aufnahme der Logdaten in Logging werden im Bereich Abfrageergebnisse nur die Logs angezeigt, die mit der Abfrage übereinstimmen. Wenn keine Abfrage angegeben ist, zeigt Logging jedes Log an, sobald es aufgenommen wird.

Abfrage hinzufügen, bevor Logs ausgewählt werden

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 ist eine effizientere Möglichkeit, eine Abfrage zu verfeinern. Er zeigt die Logeinträge nach verschiedenen Dimensionen an, entsprechend den Feldern in diesen Einträgen. Für jedes Feld werden im Bereich Logfelder Werte und ihr Qualifikationsgrad 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 und dann das Kästchen Logfelder aus. Der Bereich Logfelder wird angezeigt.

Bereich LogLogfelder“ ausgewählt

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

Funktionen im Bereich Logfelder

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

Wenn Sie Bereich nach Speicher ausgewählt haben, werden auch Projekt-IDs und die entsprechenden Anzahlen von Logeinträgen angezeigt.

Wenn Sie im Bereich Logfelder einen Ressourcentyp auswählen, wird eine Reihe relevanter Felder basierend auf den Ressourcenlabels ausgefüllt. aus. Auf diese Weise können Sie Logdaten für diesen spezifischen Ressourcentyp untersuchen. Sie können sie entfernen, indem Sie neben dem Feld Ressourcentyp auf Löschen klicken.

Felder dem Bereich Logfelder hinzufügen

Sie können dem Bereich Logs bestimmte LogEntry-Schlüssel/Wert-Paare über die Logeinträge hinzufügen, die in den Abfrageergebnissen enthalten sind. . So fügen Sie dem Bereich Logs ein Feld hinzu:

  1. Maximieren Sie im Bereich Abfrageergebnisse einen Logeintrag durch Klicken auf die Schaltfläche zum Maximieren .

  2. Klicken Sie mit der linken Maustaste auf den Wert eines Felds. Wählen Sie im Menü die Option Feld zu Logfeldern hinzufü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.

Wenn Sie ein benutzerdefiniertes Feld aus dem Bereich Logfelder entfernen möchten, 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 Logfeldern entfernen aus.

Die folgenden Feldtypen können dem Bereich Logfelder nicht hinzugefügt werden:

  • Zeitbezogene Felder Beispiel: receiveTimestamp und protoPayload.startTime.
  • Felder mit hoher Kardinalität Beispiel: insertId und protoPayload.latency.
  • Felder mit Array-Indexen im Pfad Beispiel: protoPayload.authorizationInfo[0].resource.

Logs im Bereich Logfelder analysieren

Zum Eingrenzen und Verfeinern einer Abfrage können Sie dem Ausdruck Query Builder Feld/Wert-Paare aus dem Bereich Logfelder hinzufügen. Klicken Sie dazu im Bereich Logfelder auf den Wert eines Felds. Dadurch wird mithilfe des Operators AND das Feld/Wert-Paar zum Ausdruck hinzugefügt. Die Abfrage wird dann ausgeführt.

Im Bereich Logfelder können Sie verschachtelte Feld/Wert-Paare sowie Feld-Paare auf oberster 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 mit Daten gefüllt:

Logfelder und Query Builder-Bereiche mit benutzerdefiniertem Feld.

Die Bereiche Histogramm und Abfrageergebnisse ändern sich auch entsprechend der aktuellen Abfrage.

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

Histogramm

Im Bereich Histogramm können Sie die Verteilung von Logs im Zeitverlauf darstellen. Das Histogramm wird beim Ausführen einer Abfrage neu generiert. Dadurch können Sie Trends in Ihren Logdaten leichter erkennen und Probleme beheben.

Histogrammbereich aktivieren

Wählen Sie zum Aktivieren des Histogrammbereichs Seitenlayout und dann das Kästchen Histogramm aus. Der Bereich Histogramm wird angezeigt.

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

Wenn Sie den Histogrammbereich deaktivieren möchten, entfernen Sie das Häkchen neben Histogramm.

Histogrammfunktionen

Histogrammbereich.

  1. Histogrammbalken: Jeder Histogrammbalken stellt einen Zeitraum dar. Jeder Balken enthält eine 3-Farb-Aufschlüsselung für die Logschwereebenen, die im Zeitraum jedes Balkens erfasst wurden. Die Farben geben die folgenden Log-Schwerestufen an:

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

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

  2. Zeitsteuerung: Hiermit können Sie den Zeitraum für Abfragen anpassen. Weitere Informationen zu diesen Optionen finden Sie unter Logs mit Zeitsteuerung analysieren.

  3. Histogrammzeitachse: Zeigt den Zeitraum der Logs an, dargestellt durch Histogrammbalken, die derzeit im Bereich Abfrageergebnisse angezeigt werden. Mithilfe der Zeitachse können Sie sich auf die Logs konzentrieren, die Sie aktuell im größeren Zeitraum der Abfrage ansehen.

Logs mit Zeitsteuerung analysieren

Mit den Zeitsteuerungen des Histogramms können Sie Ihre Logdaten untersuchen und analysieren.

Die Zeit schnell anpassen

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

Auf der Zeitachse des Histogrammbereichs werden die Schnellzeitsteuerung angezeigt.

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

  • Zeitachse verschieben: 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 Symbol zum Herauszoomen , um die in der Zeitachse angezeigten Daten zu erweitern. Klicken Sie auf das Zoomsymbol , um die in der Zeitachse angezeigten Daten einzugrenzen.

Wenn Sie diese Zeitsteuerung verwenden, werden die Logdaten in den Bereichen Abfrageergebnisse und Logfelder entsprechend dem von der Histogrammzeitachse erfassten Zeitraum angepasst.

Beachten Sie, dass Zeitachsenänderungen zwischen der aktuellen Zeit ("jetzt") und 30 Tagen beschränkt sind.

Scrollen oder auf Zeit zoomen

Zusätzlich zu den oben genannten Zeitsteuerelementen bietet das Histogramm die Features Scrollen zu Zeit und Heranzoomen in Zeit, um Ihnen eine detailliertere Kontrolle der Histogramm und die Daten, die Sie in anderen Bereichen des Log-Explorers sehen.

Auf der Zeitachse des Histogrammbereichs werden die Steuerelemente für Scrollen zur Zeit und für das Zoomen auf die Zeit eingeblendet.

Möglicherweise interessiert dich eine bestimmte Histogrammleiste basierend auf ihrer relativen Größe oder Schweregraden. Sie können diese Histogrammleiste auswählen, um die Logdaten anzupassen, die Sie im Log-Explorer sehen.

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

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

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

  • Die Konsolen-URL wird aktualisiert und enthält die timestamp des letzten Logs, das vom Zeitraum der ausgewählten Histogrammleiste erfasst wurde.

So wählen Sie die Funktion Zur Zeit scrollen aus:

  1. Bewegen Sie den Mauszeiger in der Histogramm-Zeitachse auf einen Balken. Ein Bereich mit einer Zusammenfassung der Logdaten für den angegebenen Zeitraum wird angezeigt.

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

    Das Klicken auf eine Histogrammleiste, statt den Mauszeiger darauf zu bewegen, entspricht dem Auswählen von Scrollen zu Zeit.

einAuf Zeit zoomen ähnliche Funktion wieZur Zeit scrollen , führt jedoch eine Abfrage Ihrer Logdaten anhand des Zeitraums durch, der von einer ausgewählten Histogrammleiste erfasst wird. Wenn Sie die Funktion Auf Zeit zoomen auswählen, geschieht Folgendes:

  • Die Logdaten, die im Bereich Abfrageergebnisse angezeigt werden, werden entsprechend der Zeitraumbeschränkung der ausgewählten Histogrammleiste neu geladen und eingegrenzt.
  • Die Konsolen-URL wird aktualisiert und enthält die timestamp des letzten Logs, das vom Zeitraum 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 Zeitraumauswahl wird auf den Zeitraum aktualisiert, der von der ausgewählten Histogrammleiste erfasst wird.
  • Die Daten im Bereich Logfelder werden entsprechend dem Zeitraum angepasst, der von der ausgewählten Histogrammleiste erfasst wird.

So wählen Sie die Funktion Auf Zeit zoomen aus:

  1. Bewegen Sie den Mauszeiger in der Histogramm-Zeitachse auf einen Balken. Ein Bereich mit einer Zusammenfassung der Logdaten für den angegebenen Zeitraum wird angezeigt.

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

Abfrageergebnisse

Bereich mit Abfrageergebnissen

Im Bereich Abfrageergebnisse können Sie sich die Logeinträge ansehen, die mit den Abfrageausdrücken übereinstimmen.

  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: Hiermit können Sie den Bereich mit den Abfrageergebnissen maximieren, 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 die Optimierung Ihrer Abfrage anhand des Trace. Weitere Informationen finden Sie unter Trace-Daten ansehen.
  6. Logzusammenfassung ausblenden: Hiermit können Sie die Logzusammenfassungszeile in den Abfrageergebnissen ausblenden.
  7. Verschachtelte Logfelder maximieren oder minimieren: Verschachtelte Felder maximieren oder minimieren
  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 einzuschließen. 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 sie mit dem aktuellen Startdatum oder der aktuellen Dauer aktualisiert und die Abfrage wird ausgeführt.
  11. Aktionen: Ermöglicht das Einrichten eines logbasierten Messwerts, das Erstellen eines Senkenziels oder das Herunterladen der Logs. Weitere Informationen zum Herunterladen von Logs finden Sie unter Logs herunterladen.
  12. Konfigurieren: Hiermit können Sie den Wert eines Logfelds zur Zusammenfassungszeile am Anfang oder Ende des Logeintrags hinzufügen. Außerdem können Sie festlegen, 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: Ermöglicht das Anpinnen eines Logeintrags in den Bereichen Abfrageergebnisse und Histogramm. Weitere Informationen finden Sie unter Protokolle anpinnen.
  14. Scroll-Scrollen: Wenn Sie die Logs in Abfrageergebnisse scrollen, passt die URL cursorTimestamp an. Dies gibt die timestamp von {101 an. }neuestes Log im aktuellen Bereich Abfrageergebnisse angezeigt.

Im Bereich der Abfrageergebnisse können Sie auf die Werte eines Felds klicken, um Folgendes auszuführen:

Optionen nach Auswahl des Feldwerts

  1. Übereinstimmende Einträge anzeigen: Ermöglicht die Suche nach übereinstimmenden Logeinträgen.
  2. Übereinstimmende Einträge ausblenden: Damit können Sie nach Log-Einträgen suchen, 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 zeigt beispielsweise den Wert für das Zusammenfassungsfeld resource.labels.pod_name vor den Logs, 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

Wenn Sie einen Logeintrag anpinnen, können Sie einen relevanten Logeintrag hervorheben.

Bewegen Sie den Mauszeiger auf den Logeintrag, den Sie anpinnen möchten, und wählen Sie dann das Stecknadelsymbol aus. Nachdem Sie einen Logeintrag angepinnt haben, wird der Hintergrund abgeblendet und es wird ein Stecknadelsymbol angezeigt.

Wenn Sie einen Logeintrag anpinnen und Ihre Abfrage noch einmal ausführen, wird der angepinnte Logeintrag je nach Konfiguration der Logdaten entweder oben oder unten im Bereich Abfrageergebnisse angezeigt. Außerdem wird im 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.

Wenn Sie den Logeintrag loslösen möchten, wählen Sie das Symbol pinAnpinnen“ und dann Logeintrag loslösen aus.

Angepinnten Logeintrag im Ressourcenkontext ansehen

Wählen Sie das angepinnte Symbol aus und wählen Sie Ressourcen anpinnen und anzeigen aus, um den angepinnten Logeintrag im Ressourcenkontext anzeigen zu lassen.

Anpinnen und anzeigen im Ressourcenkontext ist ausgewählt.

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

Angepinnten Logeintrag im Bereich Histogramm ansehen

Im Bereich Histogramm können Sie einen angepinnten Logeintrag markieren, scrollen und weitere Details prüfen.

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

  • Zum Logeintrag scrollen: Mit dieser Option wird der Logeintrag im aktuellen Bereich Abfrageergebnisse angezeigt. Außerdem sehen Sie den angepinnten Logeintrag im Kontext Ihrer Nähe. Logs.
  • Auf Logeintrag zoomen: Mit dieser Option wird der Zeitraum angezeigt, der im Histogramm angezeigt wird, und die Abfrage kann so optimiert werden, dass die Logs in der Nähe des angepinnten Logs isoliert werden. aus.

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 zu den Inhalten im Detailbereich finden Sie unter Trace-Details anzeigen.
  • 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 Sie unter Abtastrate.

Monitoring-Daten aufrufen

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

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

Menü "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 ihn auswählt, legt Logging den Logeintrag im Bereich Abfrageergebnisse an.

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

Logs herunterladen

Sie können Ihre Protokolle im CSV- oder JSON-Format herunterladen. Zum Herunterladen von Logs benötigen Sie eine der folgenden Rollen von Identity and Access Management:

  • 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

Auf der Seite Beispielabfragen mit dem Log-Explorer finden Sie vorgeschlagene Abfragen, mit denen Sie Logs finden können, die Sie interessieren könnten. Sie können beispielsweise 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

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

ID für das Projekt wird angezeigt

Logeinträge werden nicht angezeigt

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

  • Ist das richtige Cloud-Projekt ausgewählt? Falls nicht, wählen Sie das richtige Cloud-Projekt aus der Cloud-Projekt- und Organisationsauswahl aus.

  • Verwendet Ihr Cloud-Projekt Ressourcen, die Logs generieren und gibt es Aktivitäten für diese Ressourcen? Selbst wenn das Cloud-Projekt neu ist, sollte es Audit-Logs enthalten, in denen die Erstellung des Projekts dokumentiert wird. Prüfen Sie im Abschnitt Dienste zu Ressourcentypen zuordnen auf der Seite mit der Liste der überwachten Ressourcen, ob Sie eine Ressource verwenden, die Logs generiert.

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

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

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

  • Sie können keine Logeinträge sehen, die älter als die Aufbewahrungsdauer von Logging sind. Informationen über die geltende Aufbewahrungsfrist finden Sie unter Log-Aufbewahrungsdauer.

  • Bei hoher Auslastung kann es beim Senden von Logs an Logging oder beim Empfang und Aufrufen der Logs 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 abgeschlossen werden. Möglicherweise wird diese Meldung als "Frist abgelaufen, bevor der Vorgang abgeschlossen werden kann" angezeigt. Versuchen Sie, die Abfrage spezifischer zu formulieren oder den Zeitraum zu verkü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 festzustellen, wo Einträge für diese Ressource möglicherweise geschrieben wurden. Wenn Cloud Logging mehr als 200 Buckets identifiziert, in die Einträge geschrieben worden sein könnten, schlägt die Abfrage mit der Meldung Error: Invalid query fehl.

Zur Behebung dieses Problems optimieren Sie den Bereich Ihrer Abfrage auf eine Teilmenge des Speichers. Weitere Informationen finden Sie unter Bereich eingrenzen.

Support anfordern

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