Logs mit dem Log-Explorer aufrufen

In diesem Dokument erhalten Sie eine Übersicht über den Log-Explorer in der Google Cloud Console, mit dem Sie Logdaten abrufen, ansehen und analysieren können. Mit dem Log-Explorer können Sie Logs suchen und ansehen, um Probleme zu beheben. Sie können Logs auch mit der Logging API und der Google Cloud CLI lesen.

Jedes Element des Histogramms zeigt die ungefähre Anzahl der Logeinträge an, die in dem mit dem Element verknüpften Zeitintervall empfangen wurden. Um die genaue Anzahl der in einem Zeitintervall empfangenen Logeinträge abzurufen, verwenden Sie Log Analytics oder kopieren Sie Logs in einen Cloud Storage-Bucket.

Wenn Sie für Ihre Logeinträge Aggregationsvorgänge durchführen möchten, z. B. die Anzahl der Logeinträge mit einem bestimmten Muster, führen Sie ein Upgrade des Log-Buckets auf die Verwendung von Log Analytics durch. Führen Sie dann Abfragen über die Seite Log Analytics aus. Sie können den Log-Explorer weiterhin verwenden, um Logs in Log-Buckets aufzurufen, die für die Verwendung von Log Analytics aktualisiert wurden. Weitere Informationen finden Sie unter Loganalyse – Übersicht.

Mehr erfahren

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Ansehen von Logs im Log-Explorer benötigen:

• Sehen Sie sich alle Logs im Bucket _Required und in der Ansicht _Default für den Bucket _Default an: Loganzeige (roles/logging.viewer) für Ihr Projekt.
• Sehen Sie sich alle Logs in den Buckets _Required und _Default an, einschließlich Datenzugriffslogs: Betrachter privater Logs (roles/logging.privateLogViewer) für Ihr Projekt.
• Sehen Sie sich Logs an, die in einer Logansicht in einem benutzerdefinierten Log-Bucket gespeichert sind: Zugriffsfunktion für Logansicht (roles/logging.viewAccessor) für das Projekt, das den benutzerdefinierten Bucket enthält. Wenn Sie die Rolle „Zugriffsfunktion für Loganzeige“ ohne entsprechende Bedingungen haben, können Sie Logs aufrufen, die in einer beliebigen Logansicht in benutzerdefinierten Log-Buckets gespeichert sind. Ein Beispiel finden Sie unter Logs aus einem Bucket lesen.
• Eingeschränkte LogEntry-Felder in einem Bucket ansehen: Zugriffsfunktion für Logfelder (roles/logging.fieldAccessor) in Ihrem Projekt. Weitere Informationen finden Sie unter Zugriff auf Feldebene konfigurieren.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

So beginnen Sie mit der Verwendung des Log-Explorers:

1. Wählen Sie in der Google Cloud Console Logging und anschließend Log-Explorer aus oder klicken Sie auf die folgende Schaltfläche:

   Zu „Log-Explorer“

2. Wählen Sie das entsprechende Google Cloud-Projekt aus.

   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.

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.

Der Log-Explorer enthält die folgenden Abschnitte, die auf dieser Seite beschrieben werden:

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

Aktionssymbol

Mit der Symbolleiste Aktion können Sie Folgendes tun:

• Bereich eingrenzen: Sie können die Suche nur nach Logs im aktuellen Google Cloud-Projekt oder nach einer oder mehreren Speicheransichten beschränken. Weitere Informationen zum Festlegen des Umfangs finden Sie unter Bereich eingrenzen.
• Lernen: Hier finden Sie Links zu relevanter Dokumentation und Themen.
• Link teilen: Erstellen Sie eine gekürzte URL der aktuellen Abfrage und kopieren Sie sie in die Zwischenablage, um das Teilen einer Abfrage zu vereinfachen. Die kopierte URL enthält den entsprechenden absoluten Zeitraum, der durch den aktuellen Zeitraum Ihrer Abfrage dargestellt wird, z. B. 7:49:37 PM - 8:49:37 PM.

Hinweis: Wenn Ihre Daten über eine Assured Workloads-Umgebung verwaltet werden, kann dieses Feature beeinträchtigt oder eingeschränkt werden. Weitere Informationen finden Sie unter Einschränkungen und Einschränkungen in Assured Workloads.

Bereich eingrenzen

Wenn Ihre Logs in Log-Buckets gespeichert sind, können Sie diese Logs im Log-Explorer ansehen. Je nach ausgewähltem Projekt müssen Sie möglicherweise den Umfang des Log-Explorers anpassen, um Logs aufzurufen, die in bestimmten Log-Buckets gespeichert sind.

Standardmäßig zeigt der Log-Explorer alle Logs an, die von Ressourcen im aktuellen Projekt generiert oder direkt an das aktuelle Projekt weitergeleitet und dann in einem beliebigen Log-Bucket gespeichert werden. Im Log-Explorer werden standardmäßig keine Logs angezeigt, die von Ressourcen in einem anderen Projekt generiert und dann an einen Log-Bucket im aktuellen Projekt weitergeleitet werden.

Mit der Schaltfläche Bereich eingrenzen in der Symbolleiste Aktion können Sie festlegen, welche Logs im Log-Explorer angezeigt werden sollen:

• Zum Aufrufen aller Logs, die im aktuellen Projekt generiert oder direkt an das aktuelle Projekt weitergeleitet werden, wählen Sie Bereich nach aktuellem Projekt aus.

  Eine Logsenke kann Logs an einen Log-Bucket im aktuellen Projekt, an einen Log-Bucket in einem anderen Projekt oder an ein anderes Projekt weiterleiten. Weitere Informationen finden Sie unter Logs an unterstützte Ziele weiterleiten.

• Wenn Sie bestimmte Logs aufrufen möchten, die in Log-Buckets im aktuellen Projekt gespeichert sind, wählen Sie Bereich nach Speicher und dann eine oder mehrere Logansichten aus. Verwenden Sie diese Option, wenn Sie genauer steuern möchten, wer Zugriff auf welche Logs in den Log-Buckets im aktuellen Projekt hat.

  Weitere Informationen zum Erstellen und Verwalten von Logansichten finden Sie unter Zugriff auf Bucket-Ebene konfigurieren.

• Zum Aufrufen bestimmter Logs, die in Log-Buckets gespeichert sind, die sich in verschiedenen Projekten befinden, wählen Sie Umfang nach Speicher aus. Klicken Sie dann in der Auswahl für die Projekt- und Logansicht auf Projekt importieren und wählen Sie eine oder mehrere Logansichten aus. Verwenden Sie diese Option, wenn Ihre Organisation mehrere Projekte hat, die jeweils eigene Logs generieren, und Sie diese Logs zusammen im Log-Explorer ansehen möchten.

  Wenn Sie beispielsweise alle in einem Log-Bucket gespeicherten Logs ansehen möchten, wählen Sie die Ansicht _AllLogs aus:

  

Hinweis: Wenn Sie Logs an andere Ziele wie Pub/Sub weiterleiten, sind Ihre Logs im Log-Explorer nicht sichtbar.

Bereich Abfrage

Mit den Funktionen im Bereich Abfrage können Sie Folgendes tun:

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

  • Zeitraumauswahl: Geben Sie einen Zeitraum für die Logs an, die Sie ansehen möchten. Weitere Informationen finden Sie unter Zeitraumauswahl verwenden.

  • Suchfeld: Hiermit können Sie nach Logeinträgen suchen, die Ihren Suchbegriffen oder Wortgruppen entsprechen. Weitere Informationen finden Sie unter In Logfeldern nach Text suchen.

    Hinweis: Das Verhalten von Textsuchen hat sich geändert. Wenn Sie die Suchbegriffe nicht in doppelte Anführungszeichen setzen, wird die Funktion SEARCH automatisch aufgerufen.

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

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

• Tab Recent (Zuletzt ausgeführt): Sehen Sie sich Abfragen an, die Sie kürzlich ausgeführt haben. Weitere Informationen finden Sie unter Letzte Abfragen verwenden.

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

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

• Tab Bibliothek: Hier können Sie sich von Google bereitgestellte Abfragen basierend auf Ihren Anwendungsfällen ansehen und ausführen. Weitere Informationen finden Sie unter Abfragen aus der Bibliothek auswählen.

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

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

• Logs streamen: Sehen Sie sich Logeinträge an, da sie von Logging in Log-Buckets gespeichert 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 im Abfrageeditor nicht angezeigt wird, aktivieren Sie Abfrage anzeigen. Wenn Sie Suchbegriffe in das Suchtextfeld eingeben, werden diese Begriffe auch im Feld des Abfrageeditors 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. Die Bereiche Histogramm und Logfelder passen sich ebenfalls entsprechend dem Abfrageausdruck an.

Logs streamen

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

Wenn Sie Logs basierend auf einer Abfrage streamen möchten, fügen Sie im Bereich Abfrage eine Abfrage hinzu und wählen Sie dann Logs streamen aus. Da Logging die Logdaten in Log-Buckets speichert, werden im Bereich Abfrageergebnisse nur die Logs angezeigt, die der Abfrage entsprechen. Wenn keine Abfrage angegeben ist, zeigt Logging jedes Log so an, wie es gespeichert ist.

Klicken Sie zum Beenden des Streamings auf Streaming beenden oder scrollen Sie im Bereich Abfrageergebnisse.

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse können Sie Folgendes tun:

• Bereich Logfeld anzeigen: Sie können diesen Bereich schnell im Seitenlayout Ihres Log-Explorers ein- oder ausblenden.
• Bereich Histogramm anzeigen: Sie können diesen Bereich schnell im Seitenlayout Ihres Log-Explorers ein- oder ausblenden.
• Messwert erstellen: Richten Sie einen logbasierten Messwert auf der Grundlage Ihres aktuellen Abfrageausdrucks ein.
• Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigung basierend auf Ihrem aktuellen Abfrageausdruck ein.
• Zu jetzt springen: Die Abfrageergebnisse werden erzwungen, um die aktuelle Uhrzeit einzuschließen. Wenn für die Zeitraumauswahl ein benutzerdefinierter Bereich verwendet und eine Endzeit festgelegt ist, wird die Abfrage mit einem Standardzeitraum von einer Stunde ausgeführt. Andernfalls wird die Abfrage mit dem aktuellen Startdatum oder der aktuellen Dauer aktualisiert und ausgeführt. Beachten Sie, dass der Abfrageausdruck nicht geändert wird, wenn Sie diese Funktion verwenden.
• Weitere Aktionen: Verwenden Sie diese Optionen, um logbasierte Benachrichtigungen zu verwalten oder eine Senke zu erstellen.

Bereich Logfelder

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

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

• Ressourcentyp

  Wenn Sie BindPlane verwenden, um Logs vor Ort und in der Hybrid-Cloud zu schreiben, wählen Sie den Ressourcentyp Generic Node aus.

• Schweregrad

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

Möglicherweise sehen Sie die Dimension Dienst:

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

  Wenn als Ergebnis Ihrer Abfrage beispielsweise ein Logeintrag wie der folgende angezeigt wird, enthält das Dienstmenü den Dienst 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 ausgefüllt. Die Einträge in diesem Menü werden dynamisch durch die Werte des Labels service der Ressource bestimmt.

Andere Dimensionen wie die Projekt-ID werden basierend auf Ihrer Auswahl aufgelistet. Die Dimension Projekt-ID wird beispielsweise aufgelistet, wenn die Abfrage die Logeinträge auf den Ressourcentyp Kubernetes-Container beschränkt oder wenn Sie Bereich nach Speicher ausgewählt haben.

Abfrage optimieren

Wählen Sie einen Wert im Bereich Logfelder aus, um die Abfrage zu verfeinern. Wenn Sie beispielsweise unter Schweregrad die Option Fehler auswählen, wird der Abfragebereich aktualisiert und enthält dann severity=ERROR.

Der folgende Screenshot zeigt das Abfrageeditor-Feld, nachdem im Bereich Logfelder ein Schweregrad und ein Ressourcentyp ausgewählt wurden:

Wenn Sie eine Auswahl entfernen möchten, klicken Sie auf X 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 Feldes 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. Klicken Sie dazu auf Maximieren.

2. Klicken Sie auf einen Feldwert. 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.

Histogramm

Im Bereich Histogramm können Sie die Verteilung von 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 in der Symbolleiste Ergebnisse auf die Schaltfläche Histogramm.

Histogramm-Funktionen

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, der aktuell im Bereich Abfrageergebnisse angezeigt wird. Die Zeitachse hilft Ihnen, sich an den Logs zu orientieren, die Sie sich derzeit im größeren Zeitraum Ihrer 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 Zeitsteuerelemente des Histogramms anpassen, werden die Logdaten in den Bereichen Abfrageergebnisse und Logfelder entsprechend dem von der Histogrammzeitachse erfassten Zeitraum angepasst. Wenn Sie die Zeitsteuerelemente des Histogramms anpassen, ändert sich der Abfrageausdruck im Bereich Abfrage nicht.

Zeit schnell anpassen

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

• Ziehpunkte: Ziehen Sie die Ziehpunkte der Zeitachse nach innen, um die Daten einzugrenzen, oder nach außen, um die Daten in der Histogrammzeitachse 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 Rückwärtspfeil, um die Zeitachse zu einem früheren Zeitpunkt zu verschieben.

• Heran- und herauszoomen: Klicken Sie auf Herauszoomen, um die angezeigten Daten auf der Zeitachse zu vergrößern. Klicken Sie auf Heranzoomen, um die angezeigten Daten auf der Zeitachse 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.

Möglicherweise interessiert Sie bestimmte Histogrammleisten wegen ihrer relativen Größe oder ihrer Schweregrade. Sie können diese Histogrammleisten auswählen, um die im Log-Explorer angezeigten Logdaten anzupassen.

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

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

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

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

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

1. Bewegen Sie den Mauszeiger auf einen Balken in der Zeitachse des Histogramms. 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 Zeitachse des Histogramms. 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 sich die Ergebnisse Ihrer Abfragen ansehen. Zur Unterstützung bei der Fehlerbehebung in Ihren Anwendungen können Sie die Details einzelner Logeinträge aufrufen sowie Logeinträge gruppieren und analysieren, um Muster in den Logs zu erkennen. Wenn Duet AI in dem Projekt aktiviert ist, in dem Sie sich die Logs ansehen, können Sie mit Duet AI auch einen Logeintrag zusammenfassen.

Spalte Zeit konfigurieren

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

Klicken Sie zum Auswählen der anzuzeigenden Teile des Zeitstempels auf das Menü Zusätzliche Zeitoptionen in der Spalte Zeit und wählen Sie dann eine der folgenden Optionen aus:

• Datum, Uhrzeit und Zeitzone

• Datum und Uhrzeit (Standardeinstellung)

• Nur Uhrzeit

Muster in Logs mithilfe von Zusammenfassungsfeldern ermitteln

Angenommen, Sie sehen sich die Logeinträge in Ihren Abfrageergebnissen an und möchten die Ergebnisse schnell nach einem bestimmten Feld LogEntry überfliegen. Oder vielleicht möchten Sie Ihre Logeinträge nach einem bestimmten Feld/Wert-Paar gruppieren. Sie können Zusammenfassungsfelder zu den Ergebnissen hinzufügen, die als Chips am Anfang jeder Logeintragszeile angezeigt werden. In der folgenden Abbildung sehen Sie beispielsweise Abfrageergebnisse mit dem Zusammenfassungsfeld resource.type, das jeder Logeintragszeile hinzugefügt wurde:

Der Log-Explorer bietet standardmäßige Zusammenfassungsfelder und benutzerdefinierte Zusammenfassungsfelder. Standardzusammenfassungsfelder hängen von den aktuellen Abfrageergebnissen ab. Mit benutzerdefinierten Zusammenfassungsfeldern können Sie ein beliebiges Feld im LogEntry auswählen.

Zum Ausblenden von Zusammenfassungsfeldern in den Abfrageergebnissen verwenden Sie die Ein-/Aus-Schaltfläche Zusammenfassungsfelder. Wenn diese Ein-/Aus-Schaltfläche aktiviert ist, werden die Ergebnisse im Rohtextformat angezeigt. Standardmäßig wird der Inhalt jedes Logeintrags so gekürzt, dass er in eine Zeile passt. Verwenden Sie die Ein-/Aus-Schaltfläche Zeilenumbruch, um bis zu 10 Zeilen pro Logeintrag anzuzeigen. Leerräume werden in jedem Logeintrag beibehalten.

Wenn Sie bestimmte Zusammenfassungsfelder ausblenden möchten, klicken Sie auf das Zusammenfassungsfeld und dann auf Zusammenfassungsfeld ausblenden.

So ändern Sie Zusammenfassungsfelder:

1. Klicken Sie in der Spalte Zusammenfassung auf die Schaltfläche Bearbeiten, um das Bearbeitungsmenü zu öffnen.

   

2. Im Dialogfeld Zusammenfassungsfelder verwalten können Sie Folgendes tun:

   • Fügen Sie den benutzerdefinierten Zusammenfassungsfeldern beliebige benutzerdefinierte Feldnamen hinzu.

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

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

     Sie können auch ein beliebiges LogEntry-Feld auswählen, unabhängig davon, ob es Ihnen über die Funktion für die automatische Vervollständigung vorgeschlagen wird.

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

   • Aktivieren und deaktivieren Sie die Kürzung für Ihre benutzerdefinierten Zusammenfassungsfelder.

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

     Tipp: Wenn Sie den vollständigen Wert eines Zusammenfassungsfelds aufrufen möchten, bewegen Sie den Mauszeiger in den Abfrageergebnissen auf ein abgeschnittenes Zusammenfassungsfeld.

   • Standard-Zusammenfassungsfelder ein- oder ausblenden:

     Wenn Sie anpassen möchten, welche Standardzusammenfassungsfelder in Ihren Abfrageergebnissen angezeigt werden, erweitern Sie das Menü Standardzusammenfassungsfelder ein- oder ausblenden.

3. Klicken Sie auf Anwenden.

   Die Zusammenfassungsfelder werden jetzt in den Abfrageergebnissen aktualisiert.

In Abfrageergebnissen suchen

Klicken Sie im Bereich Abfrageergebnisse auf In Ergebnissen suchen und geben Sie den Suchbegriff ein, um im Inhalt von Abfrageergebnissen zu suchen. Mit diesem Filter können Sie Informationen in Ihren Logeinträgen finden, ohne eine neue Abfrage erstellen zu müssen.

Begriffe, die den Suchkriterien entsprechen, werden in Logeinträgen im Bereich Abfrageergebnisse hervorgehoben:

Ähnliche Logeinträge ansehen

Sie können Logeinträge aufrufen, die einem ausgewählten Logeintrag ähneln, sodass Sie sich auf die relevanten Logs konzentrieren können.

So rufen Sie ähnliche Logeinträge auf:

1. Klicken Sie im Bereich Abfrageergebnisse bei einem Logeintrag auf Maximieren.

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

   Die Abfrage wird mit einer Abfrage ähnlich der folgenden aktualisiert und die Abfrageergebnisse neu geladen:

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

So rufen Sie eine Vorschau ähnlicher Logeinträge auf:

1. Klicken Sie im Bereich Abfrageergebnisse bei einem Logeintrag auf Maximieren.

2. Maximieren Sie das Menü Ähnliche Einträge und wählen Sie dann Ähnliche Einträge in der Vorschau anzeigen 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 ein- oder ausblenden:

   

Ä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 Logeinträge automatisch anhand ähnlicher Logfeldinhalte 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 neu geladen.

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

  Wenn Sie ähnliche Logs ausblenden, werden keine Informationen außerhalb der Log-Explorer-Sitzung gespeichert. Jede Abfrage generiert eine neue Analyse, die nur auf den angezeigten Logs basiert. Mit verschiedenen Abfragen werden unterschiedliche Teile der Logeinträge analysiert, je nachdem, welche Arten von Logs zurückgegeben werden.

• Blenden Sie Logeinträge aus, die einem bestimmten Logeintrag ähneln. So blenden Sie Logeinträge ähnlich wie Logeinträge aus:

  1. Klicken Sie im Logeintrag 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 ansehen 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 können Sie Logeinträge ein- oder ausblenden, die mit einem bestimmten Feld in einem Logeintrag übereinstimmen:

1. Klicken Sie im Bereich Abfrageergebnisse beim Logeintrag auf Maximieren.

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

   Das folgende Menü wird angezeigt:

   

3. Wählen Sie Übereinstimmende Einträge anzeigen oder Übereinstimmende Einträge ausblenden aus.

   Die Abfrage wird mit einer Abfrage aktualisiert, die ähnliche Einträge ein- oder ausblendet, und die Abfrageergebnisse werden mit neuen Ergebnissen aktualisiert.

Logeinträge anpinnen

Nachdem Sie eine Abfrage ausgeführt haben, können Sie einen Logeintrag markieren, indem Sie ihn anpinnen. 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, ihn loszulösen.

So pinnen Sie einen Logeintrag an:

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

Nachdem Sie einen Logeintrag angepinnt haben, wird der Hintergrund dunkler und das Symbol Anpinnen wird angezeigt. Im Bereich Histogramm wird außerdem basierend auf dem timestamp des angepinnten Logeintrags ein Stecknadelsymbol angezeigt:

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, die Logeinträge anzeigt, die dem Ressourcentyp oder den Ressourcenlabels des angepinnten Logs entsprechen.

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

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

2. Treffen Sie im Menü „Anpinnen“ eine Auswahl:

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

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

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

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

   • Wenn Sie die Abfrage löschen und alle Logeinträge ansehen möchten, wählen Sie Alle anzeigen 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 Anpinnen und wählen Sie dann eine der folgenden Menüoptionen aus:

• Zum Logeintrag scrollen: Rufen Sie den Logeintrag in den aktuellen Bereich Abfrageergebnisse auf und sehen Sie sich den angepinnten Logeintrag im Kontext von Logs in der Nähe an.
• Zum Logeintrag zoomen: Sie können den im Bereich Histogramm angezeigten Zeitraum eingrenzen und Ihre Abfrage eingrenzen, 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.

Wenn ein Logeintrag nur das Feld trace enthält, wird nur das 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.

Hinweis: Trace-Details ansehen ist nur verfügbar, wenn traceSampled wahr ist.

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

Link in einen Logeintrag kopieren

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

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.

Hinweis: 10.000 ist die maximale Anzahl von Logs, die Sie herunterladen können.

Beispielabfragen

Vorgeschlagene 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

Bei bestimmten Compute Engine-Ressourcentypen wie gce_instance und gce_network wird der Ressourcenname mit der Ressourcen-ID als Untertext an verschiedenen Stellen im Log-Explorer angezeigt. Für den Ressourcentyp gce_instance wird beispielsweise der VM-Name zusammen mit der VM-ID angezeigt. Anhand der Ressourcennamen können Sie die richtige Ressourcen-ID ermitteln, für die Sie Abfragen erstellen können.

Compute Engine-Ressourcennamen werden an den folgenden Stellen angezeigt:

• Filtermenüs im Abfragebereich: Compute Engine-Ressourcentypen zeigen Ressourcennamen mit den entsprechenden Ressourcen-IDs als Untertext an.
• Logfelder: Bei Compute Engine-Ressourcentypen wird der Ressourcenname und nicht die Ressourcen-ID in den Felddimensionen angezeigt.
• 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 den Ressourcennamen anstelle der Ressourcen-ID an.

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 die Informationen unter Fehlerbehebung beim Routing und von Senken.

Keine Konsolenlogs für eine VM-Instanz gefunden

In die Console einer Compute Engine-Instanz geschriebene Logs sind im Log-Explorer möglicherweise nicht verfügbar. So rufen Sie diese Logs auf:

1. Wählen Sie in der Google Cloud Console Compute Engine und dann VM-Instanzen aus oder klicken Sie auf die folgende Schaltfläche:

   Zur Seite „VM-Instanzen“

2. Wählen Sie die Instanz und dann im Abschnitt Logs der Seite 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 Logging für die Ausgabe des seriellen Ports aktivieren und deaktivieren.

Google Cloud-Projekt- oder Organisations-ID abrufen

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

Logeinträge werden nicht angezeigt

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

• Wurde das richtige Google Cloud-Projekt ausgewählt? Ist dies nicht der Fall, wählen Sie in der Projekt- und Organisationsauswahl das richtige Google Cloud-Projekt aus.

• Verwendet Ihr Google Cloud-Projekt Ressourcen, die Logs generieren, und gibt es Aktivitäten für diese Ressourcen? Auch wenn das Google Cloud-Projekt neu ist, sollte es Audit-Logs haben, die die Tatsache dokumentieren, dass es erstellt wurde. 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 Anzeigen von Logs verwendet? Eine Anleitung zum Anpassen 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 festzustellen, wo Einträge für diese Ressource geschrieben wurden. Wenn Cloud Logging mehr als 200 Buckets ermittelt, in die möglicherweise 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 können die Zeitachse des Histogramms mithilfe der Zeitsteuerelemente des Histogramms oder der Zeitraumauswahl anpassen. Wenn Sie diese Zeitsteuerelemente anpassen, ändert sich der Abfrageausdruck im Bereich Abfrage nicht.

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.