Logs-Explorer verwenden

Dieses Dokument bietet einen Überblick über den Log-Explorer in der Google Cloud Console, mit dem Sie Logdaten abrufen, ansehen und analysieren können.

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 auf dieser Seite:

  1. Symbolleiste von Aktion
  2. Bereich Abfrage
  3. Symbolleiste von Ergebnisse
  4. Bereich Logfelder
  5. Histogramm
  6. Bereich Abfrageergebnisse

Symbolleiste Aktion

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

  • Optionen: Rufen Sie die Legacy-Loganzeige auf, senden Sie Feedback und rufen Sie eine Zusammenfassung der neuen Log-Explorer-Funktionen auf.
  • Umfang eingrenzen: Suche können nach Logs in Ihrem aktuellen Cloud-Projekt oder nach einer oder mehreren Speicheransichten beschränkt werden. Weitere Informationen zum Umfang finden Sie unter Umfang eingrenzen.
  • Hier finden Sie Links zu relevanten Dokumentationen und Themen.
  • Link teilen: Erstellen Sie eine verkürzte URL der aktuellen Abfrage und kopieren Sie sie in die Zwischenablage. Dadurch wird die Freigabe der Abfrage erleichtert. 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 Umfang 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

Verwenden Sie dazu die Funktionen des Abfragebereichs:

  • Tab Abfrage: Erstellen und optimieren Sie Abfragen mit den folgenden Funktionen:

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

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

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

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

  • Tab Zuletzt geöffnet: Hier sehen Sie die Abfragen, die Sie zuletzt ausgeführt haben. Weitere Informationen finden Sie unter Letzte Abfragen verwenden.

  • Tab Gespeichert: Sehen Sie sich Ihre gespeicherten Abfragen und Abfragen an, die andere Nutzer des Cloud-Projekts für Sie freigegeben haben. Weitere Informationen finden Sie unter Abfragen speichern und Abfragen freigeben.

  • Tab Vorschläge: Hier finden Sie vorgeschlagene Abfragen basierend auf den Ressourcen in Ihrem Cloud-Projekt. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen verwenden.

  • Tab Bibliothek: Auf dieser Seite können Sie von Google bereitgestellte Abfragen aufrufen und ausführen. Weitere Informationen finden Sie unter Abfragen aus der Bibliothek auswählen.

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

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

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

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

Logs streamen

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

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

Klicken Sie auf Streaming beenden oder scrollen Sie im Bereich Abfrageergebnisse, um das Streaming zu beenden.

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse haben Sie folgende Möglichkeiten:

  • Bereich Logs anzeigen: Sie können diesen Bereich im Log-Explorer von Seiten schnell ein- oder ausblenden.
  • Histogramm-Bereich anzeigen: Dieser Bereich kann im Log-Explorer-Seitenlayout schnell ein- oder ausgeblendet werden.
  • Messwert erstellen: Richte einen logbasierten Messwert basierend auf deinem aktuellen Abfrageausdruck ein.
  • Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigung basierend auf Ihrem aktuellen Abfrageausdruck ein.
  • Zu jetzt springen: Erzwingen Sie eine Aktualisierung Ihrer Abfrageergebnisse, um die aktuelle Uhrzeit einzuschließen. 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: Mit den folgenden Optionen können Sie logbasierte Benachrichtigungen verwalten oder eine Senke erstellen.

Bereich Logfelder

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

Sie können den Bereich Logfelder ein- oder ausblenden, indem Sie in der Symbolleiste Ergebnisse auf die Schaltfläche Logfelder klicken.

Der Bereich Logfelder wird basierend auf 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 im Bereich Logfelder hinzugefügt. Wenn Sie einen bestimmten jsonPayload.message-Wert auswählen, wird er in das Feld „Abfrageeditor“ eingefügt.

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.

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

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, dargestellt durch Histogrammbalken, 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 Anpassen der Histogramm-Zeitsteuerelemente wird der Abfrageausdruck im Query-Bereich 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.

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

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

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

  • Die Konsolen-URL wird aktualisiert und enthält den timestamp des letzten Logs, das gemäß des Zeitraums der ausgewählten Histogrammleiste erfasst wurde.

So wählen Sie das Feature Zur Zeit scrollen aus:

  1. Bewegen Sie den Mauszeiger auf einen Balken in der Histogrammzeitachse. Ein Bereich mit zusammengefassten Informationen zu den Logdaten für den angegebenen Zeitraum wird angezeigt.

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

    Wenn Sie alternativ auf eine Histogrammleiste klicken, statt den Mauszeiger darauf zu bewegen, entspricht dies der Auswahl von Zur Zeit scrollen.

Das Feature Auf Zeit zoomen ist ähnlich wie Zur Zeit scrollen, führt jedoch eine Abfrage Ihrer Logdaten basierend auf dem Zeitraum aus, der von einer ausgewählten Histogrammleiste erfasst wird. Wenn Sie das Feature Auf Zeit zoomen auswählen, geschieht Folgendes:

  • Die Logdaten, die Sie im Bereich Abfrageergebnisse sehen, werden entsprechend der Zeitraumbeschränkung der ausgewählten Histogrammleiste aktualisiert und eingegrenzt.
  • Die Konsolen-URL wird aktualisiert und enthält den timestamp des letzten Logs, das gemäß des Zeitraums der ausgewählten Histogrammleiste erfasst wurde.
  • Das Histogramm ändert sich so, dass nur Logs mit einem timestamp-Wert angezeigt werden, der innerhalb des Zeitraums der ausgewählten Histogrammleiste liegt.
  • Die Daten im Bereich Logfelder werden entsprechend dem Zeitraum angepasst, der durch die ausgewählte Histogrammleiste erfasst wurde.

So wählen Sie das Feature Auf Zeit zoomen aus:

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

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

Abfrageergebnisse

Im Bereich Abfrageergebnisse können Sie die Logeinträge untersuchen, die mit Ihren Abfrageausdrücken und dem ausgewählten Zeitraum übereinstimmen. Verwenden Sie dazu die Histogramme des Histogramms oder die Zeitraumauswahl:

Bereich "Abfrageergebnisse"

Verwenden Sie die Funktionen im Bereich Abfrageergebnisse so:

  • Abfrageergebnisse: Sehen Sie sich die abgerufenen Logeinträge aus der Abfrage im strukturierten JSON-Format an. Klicken Sie zum Maximieren der Abfrageergebnisse auf Vollbild-Abfrageergebnisse eingeben .
  • Zeitzone: Ändern Sie die Zeitzone, in der die Logs angezeigt werden.
  • Protokolle herunterladen: Protokolle herunterladen aus Ihren Abfrageergebnissen.
  • Ähnliche Logs ausblenden: Große Mengen ähnlicher Logs ausblenden in den Abfrageergebnissen.
  • 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: Hiermit blenden Sie die Logzusammenfassung in den Abfrageergebnissen aus.
  • 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: Link zu einem Logeintrag teilen. Weitere Informationen finden Sie unter Link zu einem Logeintrag kopieren.
  • Schaltfläche Bearbeiten in der Spaltenüberschrift Zusammenfassung: Fügen Sie den Wert eines Logfelds in die Zusammenfassungszeilen Ihrer Logeinträge ein. Sie können die standardmäßigen Zusammenfassungsfelder auch vollständig ausblenden, um eine Rohtextanzeige Ihrer Einträge zu erhalten. Weitere Informationen finden Sie unter Zusammenfassungsfelder hinzufügen und verwalten.
  • Logeintrag anpinnen: Sie können einen Logeintrag an die Bereiche Abfrageergebnisse und Histogramm anpinnen. Weitere Informationen finden Sie unter Logs anpinnen.
  • Scrollscroll: Scrolle die Logs unter Abfrageergebnisse. Die URL wird so angepasst, dass sie cursorTimestamp enthält. Das gibt die timestamp des neuesten Logs an, das im aktuellen Bereich Abfrageergebnisse angezeigt wird.

Im Bereich mit den Abfrageergebnissen können Sie auf die Werte eines Felds klicken, um Folgendes auszuführen:

  • Übereinstimmende Einträge anzeigen: Abfrage für die passenden Logeinträge.
  • Übereinstimmende Einträge ausblenden: Abfrage für Logeinträge, die nicht mit dem ausgewählten Ausdruck übereinstimmen.
  • Feld in Zusammenfassungszeile hinzufügen: Fügen Sie das Feld als Zusammenfassungszeile zu Logeinträgen 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 anhand eines bestimmten LogEntry-Felds überfliegen. Oder Sie möchten Ihre Logeinträge nach einem bestimmten Feld/Wert-Paar gruppieren. Sie können den Ergebnissen Zusammenfassungsfelder hinzufügen, die als Chips am Anfang jeder Logeintragszeile angezeigt werden. Die folgende Abbildung zeigt Abfrageergebnisse mit dem Zusammenfassungsfeld resource.type, das den einzelnen Logeintragszeilen hinzugefügt wird:

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

Der Log-Explorer bietet Standard-Zusammenfassungsfelder, die von Ihren aktuellen Abfrageergebnissen abhängen, und benutzerdefinierte Zusammenfassungsfelder, mit denen Sie ein Targeting auf jedes Feld in BidRequest vornehmen 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 maximierten Logeintrag benutzerdefinierte Zusammenfassungsfelder hinzufügen.

Benutzerdefiniertes Zusammenfassungsfeld aus einem Logeintrag hinzufügen

So fügen Sie direkt aus einem Logeintrag ein benutzerdefiniertes Zusammenfassungsfeld 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 angezeigt, bevor die Logeinträge mit diesem Feld erscheinen.

Klicken Sie zum Entfernen eines benutzerdefinierten Zusammenfassungsfelds auf den zugehörigen Chip in der Zeile für den Logeintrag und wählen Sie Feld aus Zusammenfassungszeile entfernen aus. Weitere Informationen zu Ihren benutzerdefinierten Zusammenfassungsfeldern finden Sie im nächsten Abschnitt.

Zusammenfassungsfelder über das Bearbeitungsmenü verwalten

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

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

    Im Bereich mit den Abfrageergebnissen wird die Schaltfläche zum Bearbeiten von Zusammenfassungsfeldern angezeigt.

  2. Gehen Sie im Dialogfeld Zusammenfassungsfelder verwalten so vor:

    1. Mit dem Schieberegler können Sie Standard-Zusammenfassungsfelder aktivieren oder deaktivieren.

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

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

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

      • Autocomplete mit den 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.

      Du kannst auch auf alle LogEntry-Felder ausrichten, unabhängig davon, ob sie mit der automatischen Vervollständigung vorgeschlagen werden.

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

    3. Sie können die Kürzung für Ihre benutzerdefinierten Zusammenfassungsfelder aktivieren oder deaktivieren. Mit dem Schieberegler können Sie die Zusammenfassungsfelder kürzen, um die Anzeige der Zusammenfassungsfelder zu kürzen. Wählen Sie dann aus, wie viele Zeichen angezeigt werden sollen, bevor das Feld gekürzt wird und ob der Anfang oder das Ende des Felds angezeigt wird.

      Tipp: Wenn Sie in Ihren Abfrageergebnissen den Mauszeiger auf ein abgeschnittenes Zusammenfassungsfeld bewegen, wird der vollständige Wert angezeigt.

  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, während sie im Bereich Abfrageergebnisse angezeigt werden. Die Logeinträge werden dann automatisch basierend auf dem Inhalt des Logfelds gruppiert. Wenn ein wichtiges Muster erkannt wird, wird im Bereich Abfrageergebnisse ein Banner mit dem Prozentsatz ähnlicher Ergebnisse angezeigt, die ausgeblendet werden können:

Banner „Ähnliche Logs“ ausblenden

Klicken Sie zum Ausblenden ähnlicher Logs auf Ähnliche Einträge ausblenden. Dadurch wird der Abfrage eine Klausel hinzugefügt und die Abfrageergebnisse aktualisiert.

Wenn Sie eine Vorschau der Protokolleinträge sehen möchten, die ausgeblendet werden sollen, klicken Sie auf Vorschau. Ein separates Fenster mit dem Muster wird geöffnet, das Beispiele für ausgeblendete Einträge enthält.

Wenn Sie ähnliche Logs ausblenden, werden keine Informationen außerhalb der Log-Explorer-Sitzung gespeichert. Jede Abfrage generiert nur eine neue Analyse, die auf den angezeigten Logs basiert. Je nach Art der zurückgegebenen Logeinträge werden von verschiedenen Abfragen verschiedene Teile der Logeinträge analysiert.

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. Klicke auf das Stecknadelsymbol .

Wenn Sie einen Logeintrag anpinnen, wird der Hintergrund abgedunkelt und es wird ein Stecknadelsymbol 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. Auf der Grundlage des angepinnten Logeintrags timestamp wird im Bereich Histogramm außerdem das Symbol „Anpinnen“ angezeigt:

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

Wenn Sie den Logeintrag loslösen möchten, klicken Sie noch einmal auf das Stecknadelsymbol.

Angepinnten Logeintrag in Ressourcenkontexten ansehen

Wenn Sie einen Logeintrag anpinnen und ihn in verschiedenen Ressourcenkontexten aufrufen, wird die Abfrage mit denselben Ressourceninformationen 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 den folgenden Ressourcenkontexten ansehen:

    • Same resource.type: Die Abfrage wird mit demselben resource.type noch einmal ausgeführt.

    • Same resource.labels: Die Abfrage wird mit demselben resource.labels noch einmal ausgeführt.

    • Dasselbe trace: Die Abfrage wird mit demselben Trace 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 Stecknadelsymbol und wählen Sie dann eine der folgenden Menüoptionen aus:

  • Zum Logeintrag scrollen: Der Logeintrag wird im aktuellen Bereich Abfrageergebnisse angezeigt und der angepinnte Logeintrag wird im Kontext von Logs zu Standorten in der Nähe angezeigt.
  • Auf Logeintrag zoomen: Grenzen Sie den Zeitraum ein, der im Bereich Histogramm angezeigt wird, und optimieren 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

Informationen zu vorgeschlagenen 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

Für bestimmte Compute Engine-Ressourcentypen wie gce_instance und gce_network wird der Ressourcenname mit der Ressourcen-ID an mehreren Stellen im Log-Explorer angezeigt. Für den Ressourcentyp gce_instance 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.

Hier können Sie Namen von Compute Engine-Ressourcen sehen:

  • Filterfiltermenüs im Abfragebereich: Compute Engine-Ressourcentypen zeigen Ressourcennamen mit den entsprechenden Ressourcen-IDs als Unterstrich.
  • Logfelder: Compute Engine-Ressourcentypen zeigen den Ressourcennamen in den Felddimensionen anstelle der Ressourcen-ID an.
  • Abfrageergebnisse: Bei Compute Engine-VM-Instanzlogs werden im Feld resource.labels Metadaten mit dem entsprechenden Ressourcennamen angezeigt.
  • Zusammenfassungsfelder: Bei Compute Engine-VM-Instanzlogs zeigt der Chip statt der Ressourcen-ID den Ressourcennamen an.

Problembehebung

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

Wenn Probleme beim Aufrufen von Logs in Senkenzielen auftreten, lesen Sie die Informationen unter Fehlerbehebung bei Routing und Senken.

Cloud-Projekt- oder Organisations-ID abrufen

Wenn Sie ein Cloud-Projekt oder eine Organisations-ID von überall in der Google Cloud Console abrufen möchten, maximieren Sie die Liste der Cloud-Projekte über die 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.

  • Wird der richtige Bereich 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 an eine Ressource senden, ohne einen Bucket anzugeben, verwendet Cloud Logging den Verlauf der Senken im Google Cloud-Projekt, um festzustellen, wo Einträge für diese Ressource geschrieben wurden. Wenn Cloud Logging mehr als 200 Buckets erkennt, in die möglicherweise Einträge geschrieben wurden, schlägt die Abfrage mit der Nachricht 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 Zeitachse mit dem Histogramm oder der Zeitraumauswahl anpassen. Wenn Sie diese Zeitsteuerung anpassen, wird der Abfrageausdruck im Bereich Abfrage 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.