Logs mit dem Log-Explorer aufrufen

In diesem Dokument finden Sie eine Übersicht über den Log-Explorer in der Google Cloud Console. Mit diesem Tool können Sie Logeinträge abrufen, ansehen und analysieren, die in Log-Buckets gespeichert sind. Wenn Sie einzelne Logeinträge und eine Abfolge von Logeinträgen aufrufen und analysieren, können Sie Probleme beheben. Sie können Logdaten auch mit der Logging API und der Google Cloud CLI lesen.

Wenn Sie Aggregationsvorgänge auf Ihre Logeinträge ausführen möchten, z. B. die Anzahl der Logeinträge zählen, die ein bestimmtes Muster enthalten, führen Sie ein Upgrade des Log-Buckets auf Log Analytics durch und führen Sie dann Abfragen auf der Seite Log Analytics in der Google Cloud Console aus. Sie können weiterhin den Log-Explorer verwenden, um Logs in Log-Buckets aufzurufen, die auf Log Analytics umgestellt wurden. Weitere Informationen finden Sie unter Log Analytics-Übersicht.

Im Rest dieses Dokuments wird beschrieben, wie Sie den Logs Explorer verwenden.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Protokolleinträgen im Protokoll-Explorer benötigen:

  • So rufen Sie Logeinträge im _Required-Bucket und in der _Default-Ansicht des _Default-Buckets auf oder wählen Sie einen Logumfang aus: Log-Viewer (roles/logging.viewer) für Ihr Projekt, Ihren Ordner oder Ihre Organisation.
  • So rufen Sie alle Logeinträge in den Buckets _Required und _Default auf: Betrachter privater Logs (roles/logging.privateLogViewer) für Ihr Projekt, Ihren Ordner oder Ihre Organisation
  • So rufen Sie eingeschränkte LogEntry-Felder in einem Log-Bucket auf: Zugriffsberechtigung für Logs-Feld (roles/logging.fieldAccessor) für das Projekt, den Ordner oder die Organisation, in dem bzw. der der Log-Bucket gespeichert ist. Informationen zum Einschränken des Zugriffs auf LogEntry-Felder finden Sie unter Zugriff auf Feldebene konfigurieren.
  • So rufen Sie Logeinträge auf, die in einer Loganzeige in einem Log-Bucket gespeichert sind, und laden Sie sie herunter: Zugriffssteuerung für Logs (roles/logging.viewAccessor) für das Projekt, den Ordner oder die Organisation, die den Log-Bucket enthält. Informationen dazu, wie Sie nur auf eine bestimmte Logansicht zugreifen können, finden Sie unter Zugriff auf eine Logansicht steuern.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Mehr erfahren

So beginnen Sie mit der Verwendung des Log-Explorers:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.

  2. Wählen Sie ein Google Cloud-Projekt, einen Ordner oder eine Organisation aus.

    Welche Logeinträge auf der Seite Log-Explorer angezeigt werden, hängt von folgenden Faktoren ab:

    • Die Ressourcen, in denen nach Logeinträgen gesucht wird.
    • Die Einstellung für den Zeitraum.
    • Ihre IAM-Rollen (Identity and Access Management) für die gesuchten Ressourcen.
    • Die Suchergebnisse werden anhand Ihrer Suchanfrage gefiltert. Wenn Sie beispielsweise die Abfrage severity>=ERROR hinzufügen, werden nur die Logeinträge mit einem Schweregrad von mindestens ERROR angezeigt.

    Standardmäßig wird auf der Seite Log-Explorer in den im standardmäßigen Logbereich aufgeführten Ressourcen nach Logeinträgen gesucht. Wenn auf diesen Bereich kein Zugriff möglich ist, wird auf der Seite nach den Logeinträgen gesucht, die aus dem ausgewählten Projekt, Ordner oder der ausgewählten Organisation stammen. Wenn ein Projekt ausgewählt ist, enthalten die Suchergebnisse die Logeinträge, die von einer Senke in einem anderen Projekt an das Projekt weitergeleitet und dann in einem Log-Bucket gespeichert werden.

    Nachdem die Seite Log-Explorer geöffnet wurde, können Sie auswählen, in welchen Ressourcen der Log-Explorer nach Logeinträgen sucht. Änderungen, die Sie über das Menü Umfang eingrenzen vornehmen, gelten nur für die aktuelle Sitzung.

Oberfläche des Log-Explorers

Über die Benutzeroberfläche des Log-Explorers können Sie Logeinträge anzeigen, parsen und analysieren sowie Abfrageparameter angeben. Der Log-Explorer enthält die folgenden Bereiche, die auf dieser Seite beschrieben werden:

  1. Hauptsymbolleiste
  2. Bereich Abfrage
  3. Bereich Logfelder
  4. Zeitachse
  5. Symbolleiste Abfrageergebnisse
  6. Bereich Abfrageergebnisse

Hauptsymbolleiste

Mit der primären Symbolleiste können Sie Folgendes tun:

  • Abfragebibliothek: Hier können Sie gespeicherte, aktuelle und vorgeschlagene Abfragen aufrufen. Weitere Informationen finden Sie unter Abfragen speichern und freigeben.
  • 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. Die kopierte URL enthält den entsprechenden absoluten Zeitraum, der durch den Zeitraum Ihrer Suchanfrage dargestellt wird, z. B. 7:49:37 PM - 8:49:37 PM.
  • Einstellungen: Hier können Sie die Ansicht der Seite „Log-Explorer“ anpassen und das Format der Abfrageergebnisse festlegen. Weitere Informationen finden Sie unter Einstellungen für die Anzeige von Protokolldaten festlegen.
  • Zeitraumauswahl: Hier können Sie einen Zeitraum für die Logeinträge festlegen, die Sie sich ansehen möchten. Weitere Informationen finden Sie unter Zeitauswahl verwenden.
  • Logs streamen: Sie können sich Logeinträge ansehen, während sie von Logging in Log-Buckets gespeichert werden. Weitere Informationen finden Sie unter Logs streamen.
  • Lernen: Hier finden Sie Links zu relevanten Dokumentationen und Themen.

Letzte, gespeicherte und vorgeschlagene Suchanfragen ansehen

Klicken Sie auf die Schaltfläche Abfragebibliothek, um kürzlich ausgeführte Abfragen, Abfragen, die Sie für die spätere Verwendung gespeichert haben, und vorgeschlagene Abfragen aufzurufen.

Auf dem Tab Abfragebibliothek sehen Sie Folgendes:

  • Letzte Abfragen: Hier sehen Sie die Abfragen, die Sie in letzter Zeit ausgeführt haben. Weitere Informationen finden Sie unter Letzte Abfragen verwenden.

  • Gespeicherte Abfragen: Hier können Sie Ihre gespeicherten Abfragen und Abfragen aufrufen, die andere Nutzer des Google Cloud-Projekts für Sie freigegeben haben. Weitere Informationen finden Sie unter Abfragen speichern und freigeben.

  • Vorgeschlagene Abfragen: Hier sehen Sie vorgeschlagene Abfragen, die auf den Ressourcen in Ihrem Google Cloud-Projekt basieren. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen verwenden.

  • Von Google Cloud bereitgestellte Abfragen: Hier finden Sie von Google Cloud bereitgestellte Abfragen, die auf häufigen Anwendungsfällen für verschiedene Google Cloud-Dienste basieren. Weitere Informationen finden Sie unter Abfragen aus der Bibliothek auswählen.

Einstellungen für die Anzeige von Protokolldaten festlegen

Wenn Sie anpassen möchten, wie die Protokolldaten in den Abfrageergebnissen dargestellt werden, klicken Sie auf die Schaltfläche Einstellungen und wählen Sie Ansicht, Format oder Zusammenfassungsfelder verwalten aus:

  • Wenn Sie die Bereiche Zeitachse und Logfelder ein- oder ausblenden, Zusammenfassungs-Chips in den Abfrageergebnissen ausblenden oder die Sortierreihenfolge Ihrer Protokolle ändern möchten, wählen Sie Ansicht aus.

  • Wenn Sie die Spalte Uhrzeit in den Abfrageergebnissen konfigurieren möchten, wählen Sie Format aus. Weitere Informationen finden Sie unter Spalte Uhrzeit konfigurieren.

  • Wenn Sie für jeden Logeintrag bis zu zehn Zeilen sehen möchten, wählen Sie Format und dann Zeilen umbrechen aus. Standardmäßig wird der Inhalt jedes Logeintrags auf eine Zeile gekürzt. Leerzeichen werden in jedem Logeintrag beibehalten.

  • Wenn Sie Muster in Ihren Protokollen mithilfe von Zusammenfassungsfeldern finden möchten, wählen Sie Zusammenfassungsfelder verwalten aus. Weitere Informationen finden Sie unter Muster in Ihren Protokollen mithilfe von Zusammenfassungsfeldern finden.

Spalte Zeit konfigurieren

In der Spalte Zeit im Bereich Abfrageergebnisse werden die Zeitstempel Ihrer Logeinträge angezeigt. Sie können die Spalte Zeit so anpassen, dass nur bestimmte Teile des Zeitstempels sichtbar sind. Dadurch wird mehr horizontaler Platz geschaffen, sodass Sie mehr Informationen im Logeintrag sehen können.

Wenn Sie auswählen möchten, welche Teile des Zeitstempels angezeigt werden sollen, klicken Sie auf das Dreipunkt-Menü  Einstellungen, wählen Sie Format und dann eine der folgenden Optionen aus:

  • Datum, Uhrzeit und Zeitzone

  • Datum und Uhrzeit (Standardeinstellung)

  • Nur Uhrzeit

Muster in Ihren Protokollen mithilfe von Zusammenfassungsfeldern erkennen

Angenommen, Sie sehen sich die Logeinträge in den Abfrageergebnissen an und möchten die Ergebnisse schnell nach einem bestimmten LogEntry-Feld durchsuchen. Oder vielleicht möchten Sie Ihre Protokolleinträge nach einem bestimmten Feld/Wert-Paar gruppieren. Sie können Ihren Ergebnissen Zusammenfassungsfelder hinzufügen, die als Chips am Anfang jeder Zeile des Logeintrags angezeigt werden.

Der Log-Explorer bietet Standard-Zusammenfassungsfelder und benutzerdefinierte Zusammenfassungsfelder. Die Standardzusammenfassungsfelder hängen von Ihren aktuellen Abfrageergebnissen ab. Bei benutzerdefinierten Zusammenfassungsfeldern können Sie jedes Feld in LogEntry auswählen.

Wenn Sie alle Chips für Zusammenfassungsfelder in den Abfrageergebnissen ein- oder ausblenden möchten, klicken Sie auf die Schaltfläche Einstellungen, wählen Sie Ansicht und dann Zusammenfassungs-Chips anzeigen aus. Wenn diese Option aktiviert ist, werden die Ergebnisse im Rohtextformat angezeigt.

Wenn Sie bestimmte Zusammenfassungsfelder ausblenden möchten, aktivieren Sie Zusammenfassungsfelder und klicken Sie dann auf Zusammenfassungsfeld ausblenden. So ändern Sie Zusammenfassungsfelder:

  1. Klicken Sie auf die Schaltfläche Einstellungen und wählen Sie Zusammenfassungsfelder verwalten aus.

  2. Im Dialogfeld Zusammenfassungsfelder verwalten haben Sie folgende Möglichkeiten:

    • Fügen Sie unter Benutzerdefinierte Zusammenfassungsfelder Namen für benutzerdefinierte Felder hinzu.

      Das Zusammenfassungsfeld unterstützt die automatische Vervollständigung und Feldkorrektur für zulässige Zeichen in Anführungszeichen. Wenn Sie beispielsweise jsonPayload.id-field eingeben, wird der Wert in jsonPayload."id-field" geändert.

      Sie können auch ein beliebiges LogEntry-Feld auswählen, unabhängig davon, ob es Ihnen über die Funktion „Autocomplete“ vorgeschlagen wird.

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

    • Sie können das Abschneiden für Ihre benutzerdefinierten Zusammenfassungsfelder aktivieren und deaktivieren.

      Wenn Sie die Anzeige der Werte des Zusammenfassungsfelds kürzen möchten, verwenden Sie die Ein/Aus-Schaltfläche  neben Benutzerdefinierte Zusammenfassungsfelder kürzen. Sie können auswählen, wie viele Zeichen angezeigt werden sollen, bevor das Feld gekürzt wird, und ob der Anfang oder das Ende des Felds angezeigt werden soll.

    • Standard-Zusammenfassungsfelder ein- oder ausblenden:

      Wenn Sie festlegen möchten, welche Standard-Zusammenfassungsfelder in den Abfrageergebnissen angezeigt werden, maximieren Sie das Menü Standard-Zusammenfassungsfelder ein‑ oder ausblenden.

  3. Klicken Sie auf Anwenden.

    Die Zusammenfassungsfelder in den Abfrageergebnissen wurden aktualisiert.

Logs nach Zeitraum ansehen

Mit der Zeitraumauswahl können Sie einen Zeitraum für die Logeinträge angeben, die Sie sich ansehen möchten.

Wenn Sie die Abfrageergebnisse erzwungen aktualisieren möchten, um die aktuelle Uhrzeit einzubinden, klicken Sie auf keyboard_tab Zu jetzt springen.

Logs streamen

Sie können Logs streamen, während Logging sie in Log-Buckets speichert, oder eine Abfrage hinzufügen, um nur die Logs zu streamen, die der Abfrage entsprechen.

Wenn Sie Logs auf Basis einer Abfrage streamen möchten, fügen Sie im Bereich Abfrage eine Abfrage hinzu und wählen Sie dann in der Hauptsymbolleiste die Schaltfläche Logs streamen aus. Da Logging die Logdaten in Log-Buckets speichert, werden im Bereich Abfrageergebnisse nur die Logs angezeigt, die mit der Abfrage übereinstimmen. Wird keine Abfrage bereitgestellt, zeigt Logging jeden Logeintrag so an, wie er gespeichert wird.

Wenn Sie das Streaming beenden möchten, klicken Sie auf  Stream beenden oder scrollen Sie manuell, um den Stream zu pausieren.

Bereich Abfrage

Verwenden Sie den Abfragebereich, um eine Abfrage im Log-Explorer zu erstellen. Im Abfragebereich können Sie Abfragen mithilfe der folgenden Funktionen erstellen und optimieren:

  • Alle Felder durchsuchen: Hier können Sie nach Logeinträgen suchen, die mit Ihren Suchbegriffen oder Wortgruppen übereinstimmen. Alle Suchbegriffe, die dem Feld Alle Felder durchsuchen hinzugefügt werden, werden dem Feld des Abfrageeditors hinzugefügt und als Teil des Abfrageausdrucks ausgewertet. Weitere Informationen finden Sie unter In allen Logfeldern nach Text suchen.

  • Filtermenüs: Mit verschiedenen Menüs können Sie Abfragen erstellen, um Ressourcen, Lognamen, Schweregrade und die Korrelation mit anderen Logs auszuwählen. Weitere Informationen finden Sie unter Filtermenüs verwenden.

  • Feld „Abfrageeditor“: Erstellen Sie erweiterte Abfragen mithilfe der Logging-Abfragesprache. Wenn das Feld „Query Editor“ nicht angezeigt wird, aktivieren Sie Abfrage anzeigen. Weitere Informationen finden Sie unter Erweiterte Abfragen mit der Logging-Abfragesprache schreiben.

Nachdem Sie die Abfrage überprüft haben, klicken Sie auf Abfrage ausführen. Logs, die Ihrer Abfrage entsprechen, werden im Bereich Abfrageergebnisse aufgeführt. Die Bereiche Zeitachse und Logfelder werden ebenfalls entsprechend dem Abfrageausdruck angepasst.

Ressourcen auswählen, in denen nach Logeinträgen gesucht werden soll

Wenn Sie die Seite Log-Explorer öffnen, werden die Logeinträge abgerufen, die aus der von Ihnen ausgewählten Ressource stammen und für die Sie Leseberechtigungen haben. Bei Google Cloud-Projekten umfassen die abgerufenen Logeinträge auch solche, die über eine Senke in einem anderen Projekt an das Projekt weitergeleitet werden. Wenn Sie eine Abfrage eingeben, werden im Log-Explorer nur die abgerufenen Logeinträge angezeigt, die auch mit der Abfrage übereinstimmen. Wenn Sie beispielsweise die Abfrage severity>=ERROR hinzufügen, werden nur die Logeinträge mit einem Schweregrad von mindestens ERROR angezeigt.

Sie können für die aktuelle Sitzung über das Menü Bereich eingrenzen konfigurieren, in welchen Ressourcen im Log-Explorer nach Logeinträgen gesucht werden soll. Bei der Fehlerbehebung möchten Sie beispielsweise möglicherweise nur die Logeinträge prüfen, die in einer Logansicht enthalten sind oder aus einem bestimmten Google Cloud-Projekt stammen.

Über das Menü Suche verfeinern können Sie nach dem aktuellen Projekt, nach der Logansicht oder nach dem Logbereich suchen:

  • Wenn Sie nach dem Projekt, dem Ordner oder der Organisation suchen möchten, die mit der Projektauswahl ausgewählt wurde, maximieren Sie das Menü Suchbereich eingrenzen und wählen Sie Aktuelles Projekt aus.

    Die Suchergebnisse enthalten für alle Ressourcen die Logeinträge, die aus der jeweiligen Ressource stammen. Bei Google Cloud-Projekten enthalten die Suchergebnisse auch die Logeinträge, die über einen Abfluss in einem anderen Projekt an das Projekt weitergeleitet werden.

  • Wenn Sie in Logansichten suchen möchten, maximieren Sie das Menü Bereich eingrenzen, wählen Sie Logansicht und dann eine oder mehrere Logansichten aus dem Menü aus.

    Wenn Sie ein Projekt mit der Projektauswahl auswählen, werden im Menü die Logansichten in den Log-Buckets aufgeführt, die vom ausgewählten Projekt gespeichert werden. Wenn jedoch ein Ordner oder eine Organisation ausgewählt ist, werden im Menü alle Logansichten aufgeführt, in denen Logeinträge gespeichert sind, die aus diesen Ressourcen stammen.

    Wenn Sie das Menü „Loganzeige“ so ändern möchten, dass es Logansichten für in einem Projekt gespeicherte Log-Buckets enthält, klicken Sie auf  Projekt importieren und wählen Sie das Projekt aus.

  • Wenn Sie nach den Ressourcen suchen möchten, die in einem Logbereich enthalten sind, der Projekte und Logansichten enthalten kann, maximieren Sie das Menü Bereich verfeinern, wählen Sie Logbereich und dann einen Logbereich aus.

    Wenn Sie die Logbereiche konfigurieren möchten, klicken Sie auf Bereiche verwalten. Weitere Informationen finden Sie unter Log-Scopes erstellen und verwalten.

    Log scopes befinden sich in der öffentlichen Vorschau.

Bereich Logfelder

Der Bereich Logfelder bietet eine allgemeine Zusammenfassung der Logdaten und eine effiziente Möglichkeit zur Verfeinerung einer Abfrage. Darin werden die Logeinträge nach verschiedenen Dimensionen aufgeschlüsselt, die den Feldern in diesen Einträgen entsprechen.

Nachdem Sie die Abfrage im Feld des Abfrageeditors ausgeführt haben, wird der Bereich Logfelder anhand der Ergebnisse der Abfrage ausgefüllt. In diesem Bereich sehen Sie die Anzahl der Logeinträge für jede unterstützte Dimension. Sie können für jede Dimension eine Auswahl treffen. Die folgenden Dimensionen sind immer verfügbar:

  • Ressourcentyp

    Wenn Sie lokale Logs und Logs der Hybrid-Cloud mit BindPlane schreiben, wählen Sie den Ressourcentyp Generischer Knoten aus.

  • Schweregrad

    Wenn Sie Ihre Abfrage nach mehreren Schweregraden filtern möchten, verwenden Sie das Menü Schweregrad.

Unter Umständen wird die Dimension Dienst angezeigt:

  • Wenn Sie Logs mit dem Ressourcentyp Kubernetes-Container haben und Ihre Logs nicht nach Ressourcentyp gefiltert haben, ist das Menü Dienst ausgefüllt. Die Einträge in diesem Menü werden dynamisch anhand der Werte des k8s-pod/app-Labels der Ressource bestimmt.

    Wenn beispielsweise ein Logeintrag wie der folgende als Ergebnis Ihrer Abfrage angezeigt wird, enthält das Dienstmenü den Dienst mit dem Namen myservice:

    {
     ...
     labels: {
         compute.googleapis.com/resource_name: "mycluster1"
         k8s-pod/app: "myservice"
         k8s-pod/pod-template-hash: "5ffcd94fdd"
      }
      logName: "projects/my-project/logs/stdout"
      resource: {
         labels: {6}
         type: "k8s_container"
      }
      ...
    }
    
  • Wenn Sie nach dem Ressourcentyp Geprüfte Ressource filtern, wird das Menü Dienst angezeigt. Die Einträge in diesem Menü werden dynamisch anhand der Werte des service-Labels der Ressource bestimmt.

Andere Dimensionen wie Projekt-ID werden basierend auf Ihren Auswahlen aufgeführt. Die Dimension Projekt-ID wird beispielsweise aufgeführt, wenn die Abfrage die Logeinträge auf solche mit dem Ressourcentyp Kubernetes-Container beschränkt oder Sie eine Logansicht ausgewählt haben.

Abfrage optimieren

Wenn Sie die Abfrage verfeinern möchten, wählen Sie einen Wert aus dem Bereich Logfelder aus. Wenn Sie beispielsweise unter Schweregrad die Option Fehler auswählen, wird der Abfragebereich um severity=ERROR aktualisiert.

Wenn Sie eine Auswahl entfernen möchten, klicken Sie auf die Schaltfläche 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. Wenn Sie beispielsweise häufig nach dem Wert des Felds jsonPayload.message filtern, fügen Sie es dem Bereich Logfeld hinzu.

So fügen Sie dem Bereich Logfeld ein Feld hinzu:

  1. Maximieren Sie im Bereich Abfrageergebnisse einen Logeintrag, indem Sie auf Diesen Logeintrag maximieren klicken.

  2. Wählen Sie den Wert eines Felds aus. 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.

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.

Zeitachse

Im Bereich Zeitachse können Sie die Verteilung der Logs im Zeitverlauf visualisieren. Die Zeitachse wird neu erstellt, wenn Sie eine Abfrage ausführen. Dadurch können Sie leichter Trends in den Logdaten erkennen und Probleme beheben.

Wenn Sie den Bereich Zeitachse ein- oder ausblenden möchten, klicken Sie auf keyboard_capslock Zeitachse minimieren.

Zeitachsenfunktionen

  1. Zeitleistenbalken: Jede Zeitleistenleiste 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 Leiste in der Zeitachse 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. Zeitraum: Zeigt den Zeitraum der Logs an, dargestellt durch Histogrammleisten. 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 in der Zeitachse verwenden, um Ihre Logdaten zu untersuchen und zu analysieren.

Zeiteinstellungen anpassen

Die Zeitachse bietet Zeitsteuerelemente, mit denen Sie die im Log-Explorer angezeigten Daten anpassen können:

  • Ziehpunkte der Zeitachse: Ziehen Sie die Ziehpunkte der Zeitachse nach unten, um die Daten einzugrenzen, oder nach außen, um die Daten in der 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.

  • Heranzoomen und herauszoomen: Klicken Sie auf Herauszoomen, um die in der Zeitachse angezeigten Daten zu erweitern. Klicken Sie auf Heranzoomen, um die in der Zeitachse angezeigten Daten einzugrenzen.

  • Zeitachse ausblenden: Klicken Sie auf keyboard_capslock Zeitachse minimieren, um die Zeitachse auszublenden.

Änderungen an der Zeitleiste müssen zwischen dem aktuellen Zeitpunkt ("jetzt") und bis zu 30 Tage in der Vergangenheit liegen.

Zur Zeit scrollen oder zoomen

Zusätzlich zu den oben aufgeführten Zeitsteuerelementen bietet die Zeitachse die Funktionen Zur Zeit scrollen und Auf Zeit zoomen, um Ihnen eine genauere Kontrolle über die Zeitachse und die Daten zu geben, die Sie in anderen Bereichen des Log-Explorers sehen. Möglicherweise interessiert Sie eine bestimmte Leiste in der Zeitachse aufgrund ihrer relativen Größe oder ihres Schweregrades. Sie können diese Leiste auswählen, um die im Log-Explorer angezeigten Logdaten anzupassen.

Mit der Funktion Zur Zeit scrollen können Sie Ihre Logdaten durchsuchen, ohne die Werte in den Bereichen Zeitachse 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 Zeitleistenleiste 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 Zeitleistenleiste entsprechen.

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

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

  1. Bewegen Sie den Mauszeiger auf einen Balken in der 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 Zeitleistenleiste klicken, entspricht dies der Auswahl von Zur Zeit scrollen.

Die Funktion 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 Zeitleistenleiste 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 Zeitleistenleiste aktualisiert und eingegrenzt.
  • Die Konsolen-URL wird aktualisiert und enthält den timestamp des letzten Logs, das gemäß des Zeitraums der ausgewählten Zeitleistenleiste erfasst wurde.
  • Die Zeitleiste ändert sich so, dass nur Logs mit einem timestamp-Wert angezeigt werden, der innerhalb des Zeitraums der ausgewählten Zeitleistenleiste liegt.
  • Die Daten im Bereich Logfelder werden entsprechend dem Zeitraum angepasst, der durch die ausgewählte Zeitachsenleiste erfasst wurde.

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

  1. Bewegen Sie den Mauszeiger auf einen Balken in der 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.

Symbolleiste Abfrageergebnisse

In der Symbolleiste Abfrageergebnisse haben Sie folgende Möglichkeiten:

  • Ergebnisse analysieren: Mit Log Analytics können Sie Abfrageergebnisse zusammenfassen und in Diagrammen darstellen. Diese Schaltfläche ist nur sichtbar, wenn der ausgewählte Bereich einen Log-Bucket enthält, der für die Verwendung von Log Analytics aktualisiert wurde. Weitere Informationen finden Sie im Abschnitt Ergebnisse analysieren dieses Dokuments.
  • Aktionen: Wählen Sie eine der folgenden Optionen aus, um Ihre Protokolldaten weiter zu analysieren:

    • ink_highlighter In Ergebnissen hervorheben: Geben Sie Text ein, der in den Suchergebnissen hervorgehoben werden soll.
    • Senke erstellen: Erstellen Sie eine Logsenke, bei der der Einschlussfilter der Senke automatisch mit dem aktuellen Abfrageausdruck ausgefüllt wird.
    • Protokollbenachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigungsrichtlinie ein.
    • Benachrichtigungen verwalten: Hier können Sie Benachrichtigungsrichtlinien aufrufen und verwalten.
    • Herunterladen: Sie können Ihre Protokolle im CSV- oder JSON-Format herunterladen. Weitere Informationen finden Sie unter Logs herunterladen.

Ergebnisse analysieren

Wenn Ihr Projekt Log-Buckets enthält, die auf Log Analytics umgestellt wurden, können Sie Ihre Logdaten mithilfe von SQL-Abfragen auf der Seite Log Analytics aggregieren, analysieren und in Diagrammen darstellen. Wenn Sie die Log Analytics-Seite vom Log-Explorer aus aufrufen möchten, klicken Sie in der Symbolleiste Ergebnisse auf Ergebnisse analysieren.

Die Schaltfläche Ergebnisse analysieren ist nur dann sichtbar, wenn der ausgewählte Umfang einen Log-Bucket enthält, der für die Verwendung von Log Analytics aktualisiert wurde. Wenn Sie beispielsweise über das Menü Umfang eingrenzen die Option Loganzeige ausgewählt haben, wird die Schaltfläche Ergebnisse analysieren angezeigt, wenn mindestens ein Bucket im Speicherumfang für die Verwendung von Log Analytics aktualisiert wurde. Weitere Informationen finden Sie unter Log-Bucket für Log Analytics aktualisieren.

Wenn Sie auf Ergebnisse analysieren klicken, geschieht Folgendes:

  • Der Zeitraum im Log-Explorer wird möglicherweise automatisch so angepasst, dass auf der Seite Loganalysen aussagekräftige Logdaten vorhanden sind.

  • Die Seite Log Analytics wird in einem neuen Tab geöffnet und die aktuelle Abfrage in der Logging Query Language wird automatisch in eine SQL-Abfrage übersetzt.

  • Die in der Google Cloud-Projektauswahl ausgewählte Ressource und der Wert der Einstellung Scope eingrenzen bestimmen, wie die FROM-Klausel in der SQL-Abfrage aufgebaut wird. Die ausgewählte Ressource kann ein Projekt, ein Ordner oder eine Organisation sein:

    • Wenn im Menü Umfang eingrenzen die Option Projekt angezeigt wird, werden die _Required- und _Default-Buckets der Ressource abgefragt.

    • Wenn im Menü Scope eingrenzen die Option Ansicht angezeigt wird, werden die Logansichten in den Log-Buckets im aktuellen Projekt abgefragt. Protokollansichten in Protokoll-Buckets, die von verschiedenen Ressourcen gespeichert werden, werden ignoriert.

    • Wenn in der Einstellung Bereich eingrenzen der Name eines Logbereichs aufgeführt ist, werden die vorherigen Regeln auf die im ausgewählten Logbereich aufgeführten Ressourcen angewendet. Wenn der Logbereich beispielsweise Logansichten enthält, werden nur diese Logansichten in den von der Ressource gespeicherten Log-Buckets abgefragt. Log scopes befinden sich in der öffentlichen Vorschau.

Auf der Log Analytics-Seite können Sie Ihre Ergebnisse in Tabellenform oder als Diagramm aufrufen. Auf dem Tab Diagramm können Sie die Daten auswählen, die im Diagramm dargestellt werden sollen, die Diagrammkonfiguration anpassen oder ein Diagramm in einem benutzerdefinierten Dashboard speichern. Informationen zum Erstellen von Diagrammen aus Abfrageergebnissen und zum Speichern von Diagrammen in einem benutzerdefinierten Dashboard finden Sie unter Abfrageergebnisse in Log Analytics in Diagrammen darstellen.

Informationen zum Schreiben von Abfragen mit SQL finden Sie unter Logs in Log Analytics abfragen und ansehen.

In den Abfrageergebnissen suchen

Wenn Sie im Inhalt der Abfrageergebnisse suchen möchten, klicken Sie im Bereich Abfrageergebnisse auf In Ergebnissen hervorheben und geben Sie dann den Suchbegriff ein. Mit diesem Filter können Sie Informationen in Ihren Logeinträgen finden, ohne eine neue Abfrage zu erstellen.

Begriffe, die mit den Suchkriterien übereinstimmen, werden in den Logeinträgen im Bereich Abfrageergebnisse hervorgehoben:

Logeinträge mit übereinstimmenden Suchbegriffen sind hervorgehoben.

Logs herunterladen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Logs View Accessor (roles/logging.viewAccessor) für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Herunterladen von Protokollen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese Rolle enthält die Berechtigung logging.logEntries.download. Sie können auch eine Rolle mit der Berechtigung logging.logEntries.list gewähren, mit der ein Hauptkonto Protokolle ansehen und herunterladen kann.

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

So laden Sie Ihre Logs herunter:

  1. Klicken Sie im Bereich Abfrageergebnisse im Menü Aktionen auf Herunterladen.

  2. Wählen Sie im Dialogfeld Logs herunterladen das CSV- oder JSON-Format aus und klicken Sie dann auf Herunterladen.

  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 Sheets öffnen.

Informationen zur Fehlerbehebung finden Sie unter Herunterladen von Protokollen fehlgeschlagen.

Bereich Abfrageergebnisse

Die Ergebnisse Ihrer Abfragen finden Sie im Bereich Abfrageergebnisse. Zur Fehlerbehebung bei Ihren Anwendungen können Sie sich die Details einzelner Logeinträge ansehen und Logeinträge gruppieren und analysieren, um Muster in Ihren Logs zu finden.

Ähnliche Logeinträge ansehen

Sie können sich Logeinträge ansehen, die einem ausgewählten Logeintrag ähneln. So können Sie sich auf die relevanten Protokolle konzentrieren.

So rufen Sie ähnliche Logeinträge auf:

  1. Klicken Sie im Bereich Abfrageergebnisse auf einen Logeintrag und dann auf Maximieren.

  2. Klicken Sie auf Ähnliche Einträge und wählen Sie Ähnliche Einträge anzeigen aus.

    Die Abfrage wird mit einer ähnlichen Abfrage wie der folgenden aktualisiert und die Abfrageergebnisse werden neu geladen:

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

So rufen Sie eine Vorschau der ähnlichen Logeinträge auf:

  1. Klicken Sie im Bereich Abfrageergebnisse auf einen Logeintrag und dann auf Maximieren.

  2. Maximieren Sie das Menü Ähnliche Einträge und wählen Sie Ähnliche Einträge als Vorschau ansehen aus.

    Ein separates Dialogfeld mit den folgenden Informationen wird geöffnet:

    • Das gefundene Muster
    • Der Prozentsatz der Logeinträge, die das Muster enthalten
    • Beispiel für Logeinträge, die das Muster enthalten

    In diesem Dialogfeld können Sie Logeinträge aus- oder einblenden:

    Im Dialogfeld „Vorschau von Logeinträgen“ können Sie ähnliche Logeinträge ausblenden oder anzeigen lassen.

Ähnliche Logeinträge ausblenden

Sie können ähnliche Logeinträge ausblenden, um Logs aus den Abfrageergebnissen zu entfernen.

Es gibt zwei Möglichkeiten, ähnliche Logeinträge auszublenden:

  • Große Mengen automatisch gruppierter Logeinträge ausblenden Wenn Sie eine Abfrage ausführen, werden die Abfrageergebnisse auf Muster analysiert und die Logeinträge werden dann automatisch basierend auf ähnlichen Logfeldinhalten gruppiert.

    Wenn ein signifikantes Muster erkannt wird, wird im Bereich Abfrageergebnisse ein Banner mit dem Prozentsatz der Ergebnisse angezeigt, die ausgeblendet werden können.

    Ähnliche Einträge ausblenden: Mit dieser Schaltfläche wird der Abfrage eine Klausel hinzugefügt und die Abfrageergebnisse werden neu geladen.

    Vorschau: Es wird ein separates Fenster geöffnet, in dem das gefundene Muster beschrieben und Beispiele für die Einträge angezeigt werden.

    Wenn Sie ähnliche Protokolle ausblenden, werden keine Informationen außerhalb der Log-Explorer-Sitzung gespeichert. Für jede Abfrage wird eine neue Analyse erstellt, die nur auf den angezeigten Protokollen basiert. Je nach zurückgegebenen Protokolltypen werden mit verschiedenen Abfragen unterschiedliche Teile der Protokolleinträge analysiert.

  • Logeinträge ausblenden, die einem bestimmten Logeintrag ähneln.

    Wenn Sie Logeinträge ausblenden möchten, die einem Logeintrag ähneln, klicken Sie auf  Maximieren, dann auf das Menü Ähnliche Einträge und wählen Sie Ähnliche Einträge ausblenden aus.

    Die Abfrage wird aktualisiert und der Bereich Abfrageergebnisse wird neu geladen. Logeinträge, die dem ausgewählten Logeintrag ähneln, werden nicht angezeigt.

Logeinträge anzeigen oder ausblenden, die mit einem Feld übereinstimmen

Sie können Logeinträge ein- oder ausblenden, die mit einem Feld in einem Logeintrag übereinstimmen. So können Sie sich auf Einträge konzentrieren, die denselben Feldinhalt enthalten.

So rufen Sie Logeinträge auf, die mit einem bestimmten Feld in einem Logeintrag übereinstimmen, oder blenden Sie sie aus:

  1. Klicken Sie im Bereich Abfrageergebnisse auf den Logeintrag und dann auf Maximieren.

  2. Klicken Sie im Logeintrag auf den Wert eines Felds, z. B. compute.googleapis.com, ein serviceName.

  3. Wählen Sie im Menü die Option Übereinstimmende Einträge anzeigen oder Übereinstimmende Einträge ausblenden aus.

    Die Abfrage wird durch eine Abfrage aktualisiert, die ähnliche Einträge anzeigt oder ausblendet. Die Abfrageergebnisse werden mit neuen Ergebnissen neu geladen.

Logeinträge anpinnen

Nachdem Sie eine Abfrage ausgeführt haben, können Sie einen Logeintrag anpinnen, um ihn hervorzuheben. Der angepinnte Logeintrag bleibt im Bereich Abfrageergebnisse zentriert. Wenn Sie eine neue Abfrage ausführen und der angepinnte Logeintrag nicht enthalten ist, werden Sie aufgefordert, die Markierung des Logeintrags aufzuheben.

So pinnen Sie einen Logeintrag an:

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

Der angepinnte Hintergrund ist ausgegraut und ein Stecknadelsymbol wird angezeigt. Außerdem wird auf dem Bereich Zeitachse ein Stecknadelsymbol angezeigt, das auf dem timestamp des angepinnten Logs basiert.

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

Logs anzeigen, die mit der Ressource eines angepinnten Logeintrags übereinstimmen

Nachdem Sie einen Logeintrag angepinnt haben, können Sie eine neue Abfrage ausführen, in der Logeinträge angezeigt werden, die mit dem Ressourcentyp oder den Ressourcenlabels des angepinnten Logs übereinstimmen.

So pinnen Sie einen Logeintrag an und zeigen Logeinträge an, die mit demselben Ressourcentyp oder denselben Ressourcenlabels übereinstimmen:

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

  2. Wählen Sie im Menü „Anpinnen“ eine Option aus:

    • Wenn Sie die Abfrage mit derselben resource.type wie das angepinnte Log noch einmal ausführen möchten, wählen Sie Gleicher resource.type aus.

      Angenommen, Sie pinnen einen Logeintrag mit der resource.type k8s_node an. Wenn Sie Gleicher resource.type auswählen, wird die Abfrage noch einmal ausgeführt, um alle Logeinträge mit resource.type="k8s_node" anzuzeigen.

    • Wenn Sie die Abfrage mit derselben resource.labels wie das angepinnte Log noch einmal ausführen möchten, wählen Sie Gleiche resource.labels aus.

    • Wenn Sie die Abfrage mit derselben trace wie im angepinnten Protokoll noch einmal ausführen möchten, wählen Sie Gleicher Trace aus.
    • Wenn Sie die Abfrage löschen und alle Logeinträge anzeigen lassen möchten, wählen Sie Alle anzeigen aus.

Angepinnten Logeintrag in der Zeitachse ansehen

In der Zeitleiste können Sie einen angepinnten Logeintrag hervorheben, zu ihm scrollen und weiter untersuchen.

Klicken Sie auf der Zeitachse auf  Anpinnen 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 heranzoomen: Begrenzen Sie den Zeitraum, der im Bereich Zeitachse angezeigt wird, und verfeinern Sie Ihre Abfrage, um die Logs in der Nähe des angepinnten Logs zu isolieren.
  • Loslösen: Logeintrag loslösen.

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 Traces suchen und untersuchen.
  • 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

Bei bestimmten Logs wie GKE- und Compute Engine-Logs können Sie den Ressourcentyp in der Zusammenfassungszeile des Logs auswählen, 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 Kopieren aus. Sie können ein Protokoll im JSON-Format oder einen Link zum Protokoll kopieren. Der Link wird in die Zwischenablage kopiert. Sie können den Link an Nutzer senden, die Zugriff auf das Google 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.

Beispielabfragen

Vorgeschlagene Abfragen nach Google Cloud-Produkt und Anwendungsfall finden Sie unter Beispielabfragen mit dem Log-Explorer. Beispiel: Sie können Kubernetes-bezogene Abfragen ausführen, um Google Kubernetes Engine-Logs zu finden.

Compute Engine-Protokolle ansehen

Bei bestimmten Compute Engine-Ressourcentypen wie gce_instance und gce_network wird der Ressourcenname mit der Ressourcen-ID an mehreren Stellen im Logs Explorer als Untertext angezeigt. Für den Ressourcentyp gce_instance sehen Sie beispielsweise neben der VM-ID den VM-Namen. Anhand der Ressourcennamen können Sie die richtige Ressourcen-ID ermitteln, auf der Sie Abfragen erstellen können.

Sie können Compute Engine-Ressourcennamen an den folgenden Stellen sehen:

  • Filtermenüs im Bereich Abfrage: Für Compute Engine-Ressourcentypen werden Ressourcennamen mit den entsprechenden Ressourcen-IDs als Untertext angezeigt.
  • Logfelder: Bei Compute Engine-Ressourcentypen wird in den Felddimensionen der Ressourcenname anstelle der Ressourcen-ID angezeigt.
  • Abfrageergebnisse: In den Logs von Compute Engine-VM-Instanzen enthält das Feld resource.labels Metadaten mit dem entsprechenden Ressourcennamen.
  • Zusammenfassungsfelder: In Protokollen für Compute Engine-VM-Instanzen wird auf dem Chip der Ressourcenname anstelle der Ressourcen-ID angezeigt.

Fehlerbehebung

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

Wenn beim Aufrufen von Logs in Senkenzielen Probleme auftreten, lesen Sie den Hilfeartikel Fehlerbehebung bei Routing und Senken.

Download der Protokolle schlägt fehl

Sie verwenden den Log-Explorer und klicken auf Herunterladen. Der Befehl wird gestartet, aber nicht abgeschlossen oder es wird ein Fehler gemeldet.

Versuchen Sie Folgendes, um die Ausführungszeit des Befehls zu verkürzen:

  • Reduzieren Sie im Dialogfeld Protokolle herunterladen den Wert für Maximale Anzahl von Logeinträgen.
  • Verkürzen Sie den Zeitraum, für den Protokolle abgefragt werden.
  • Klicken Sie in der Symbolleiste für Abfrageergebnisse auf Ähnliche Einträge ausblenden, bevor Sie mit dem Download beginnen.

Konsolenlogs für eine VM-Instanz können nicht gefunden werden

Logs, die in die Console einer Compute Engine-Instanz geschrieben wurden, sind möglicherweise nicht im Log-Explorer verfügbar. So rufen Sie diese Protokolle auf:

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:

    Zu Seite VM-Instanzen

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Instanz und dann auf der Seite im Abschnitt Protokolle die Option Serieller Port 1 (Konsole) aus.

Sie können Ihre Instanzen so konfigurieren, dass die Ausgabe des seriellen Ports an Cloud Logging gesendet wird. Weitere Informationen finden Sie unter Protokollierung der seriellen Portausgabe aktivieren und deaktivieren.

Google Cloud-Projekt- oder Organisations-ID abrufen

Wenn Sie die ID eines Google Cloud-Projekts oder einer Google Cloud-Organisation von einer beliebigen Stelle in der Google Cloud Console abrufen möchten, maximieren Sie die Liste der Google Cloud-Projekte in der Google Cloud-Projekt- und Organisationsauswahl und suchen Sie die Google Cloud-Projekt-ID in der Spalte ID.

Logeinträge werden nicht angezeigt

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

  • Prüfen Sie, ob das richtige Google Cloud-Projekt ausgewählt ist.

  • Prüfen Sie, ob Ihr Google Cloud-Projekt Ressourcen verwendet, die Protokolle generieren, und ob es Aktivitäten auf diesen Ressourcen gibt. Auch bei einem neuen Google Cloud-Projekt sollten Audit-Logs vorhanden sein, die dessen Erstellung dokumentieren. Informationen dazu, wie Sie prüfen, ob Sie eine Ressource verwenden, die Logs generiert, finden Sie unter Dienste Ressourcentypen zuordnen.

  • Der Zeitraum darf nicht zu kurz sein.

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

  • Sie benötigen die Berechtigung zum Ansehen der Logeinträge in den Projekten und Logansichten, auf die Sie über das Menü Bereich eingrenzen verweisen. Informationen zum Eingrenzen des Suchbereichs finden Sie unter Bereich eingrenzen.

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

  • Logeinträge, die die Aufbewahrungsdauer von Logging vom Alter her überschritten haben, werden nicht angezeigt. Die für Logs geltende Aufbewahrungsdauer entnehmen Sie dem Abschnitt Aufbewahrungsdauer von Logs.

  • Bei hoher Auslastung kann es beim Senden der Logs an Logging sowie bei deren Empfang oder Anzeige zu Verzögerungen kommen.

  • Im Log-Explorer sehen Sie keine Logeinträge, die Zeitstempel in der Zukunft haben, bis die aktuelle Zeit mit dem Vorkommen versehen ist. Ursache ist meist eine Zeitverzerrung in der Anwendung, aus der die Logs stammen.

  • Der Abfragebereich war zu groß und konnte nicht innerhalb eines angemessenen Zeitraums abgearbeitet werden. Möglicherweise wird dies als "Frist abgelaufen, bevor der Vorgang beendet werden konnte" angezeigt. Versuchen Sie, die Abfrage spezifischer zu machen oder den Zeitraum zu kürzen.

Abfrage gibt einen Fehler zurück

Wenn Sie eine Abfrage für eine Ressource ausführen, ohne einen Bucket anzugeben, verwendet Cloud Logging den Verlauf der Senken im Google Cloud-Projekt, um zu 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 Abfrage nicht geändert.

Wenn Sie eine Abfrage mit einem Zeitstempel haben, ist die Zeitraumauswahl deaktiviert. Die Abfrage verwendet den Zeitstempelausdruck als Zeitraumbeschränkung. Wenn eine Abfrage keinen Zeitstempelausdruck hat, verwendet die Abfrage die Zeitraumauswahl als Zeitraumbeschränkung.

Support kontaktieren

Informationen zum Anfordern von Support finden Sie auf der Supportseite für Google Cloud Observability.