Logs mit dem Log-Explorer aufrufen

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

Um zusammengefasste Vorgänge für Ihre Logeinträge durchzuführen, z. B. das Zählen der Logeinträge, die ein bestimmtes Muster enthalten, den zu verwendenden Log-Bucket aktualisieren Loganalysen und anschließende Abfragen über die Loganalysen Seite der Google Cloud Console. Sie können weiterhin den Log-Explorer zum Ansehen von Logs in Log-Buckets die auf Loganalysen aktualisiert wurden. Weitere Informationen finden Sie unter Loganalysen – Übersicht

Im weiteren Verlauf dieses Dokuments wird die Verwendung des Log-Explorers beschrieben.

Hinweise

So erhalten Sie die Berechtigungen, die Sie zum Aufrufen von Logeinträgen mit dem Log-Explorer benötigen: bitten Sie Ihren Administrator, Ihnen folgenden IAM-Rollen:

• So rufen Sie Logeinträge im Bucket _Required und in der Ansicht _Default für den Bucket _Default auf oder wählen einen Logumfang aus: Loganzeige (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: Auf Logfeld zugreifende Person (roles/logging.fieldAccessor) im Projekt, Ordner oder der 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: Zugriff auf Loganzeige (roles/logging.viewAccessor) für das Projekt, den Ordner oder die Organisation mit dem Log-Bucket. Informationen dazu, wie Sie nur Zugriff auf eine bestimmte Protokollansicht erhalten, finden Sie unter Zugriff auf eine Protokollansicht 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 Monitoring 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 vom Folgendes:

   • Die Ressourcen, die nach Logeinträgen gesucht wurden.
   • Die Zeitraumeinstellung.
   • Ihre IAM-Rollen (Identity and Access Management) für die gesuchten Ressourcen.
   • Die Suchergebnisse werden anhand Ihrer Suchanfrage gefiltert. Das Hinzufügen der Abfrage severity>=ERROR führt beispielsweise zu Es werden nur Logeinträge mit der Wichtigkeitsstufe mindestens ERROR

   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 wird, enthalten die Suchergebnisse die Logeinträge, die von einer Senke in einem anderen Projekt an das Projekt weitergeleitet werden. und dann in einem Log-Bucket gespeichert.

   Nach dem Öffnen der Seite Log-Explorer können Sie die Schaltfläche Bereich eingrenzen um auszuwählen, welche Ressourcen durchsucht werden. Änderungen, die Sie über die Schaltfläche Umfang eingrenzen vornehmen, gelten nur für die aktuelle Sitzung.

Oberfläche des Log-Explorers

Mit der Log-Explorer-Oberfläche können Sie Logeinträge aufrufen, parsen und analysieren und Suchparameter angeben.

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

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

Symbolleiste Aktion

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

• Bereich eingrenzen: Konfigurieren Sie, welche Ressourcen nach Logeinträgen gesucht werden sollen. Durch Ihre Abfrage werden die Suchergebnisse gefiltert. Weitere Informationen finden Sie unter Bereich eingrenzen:
• Lernen: Hier finden Sie Links zu relevanter Dokumentation und Themen.
• Link teilen: Erstellen Sie eine verkürzte URL der Abfrage und kopieren Sie sie in die Zwischenablage. So können Sie Abfragen leichter teilen. Die kopierte URL hat den entsprechenden absoluten Zeitraum, der durch das Zeitraum Ihrer Abfrage, z. B. 7:49:37 PM - 8:49:37 PM.

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

Bereich eingrenzen

Wenn Sie die Seite Log-Explorer öffnen, werden die Logeinträge abgerufen. die aus der ausgewählten Ressource stammen, und die Sie aufrufen dürfen. Bei Google Cloud-Projekten umfassen die abgerufenen Logeinträge auch solche, die von einem Sink in einem anderen Projekt an das Projekt weitergeleitet werden. Wenn Sie eine Abfrage eingeben, zeigt der Log-Explorer nur die abgerufene Logeinträge, die auch mit der Abfrage übereinstimmen. Das Hinzufügen der Abfrage severity>=ERROR führt beispielsweise zu Es werden nur Logeinträge mit der Wichtigkeitsstufe mindestens ERROR

Hinweis: Um zu konfigurieren, welche Ressourcen durchsucht werden, wenn der Wenn die Seite Log-Explorer geöffnet wird, legen Sie den Standard-Logbereich fest. Weitere Informationen finden Sie unter Logbereiche erstellen und verwalten.

Sie können für die aktuelle Sitzung über das Menü Scope eingrenzen konfigurieren, in welchen Ressourcen der Log-Explorer nach Logeinträgen sucht. Bei der Fehlerbehebung möchten Sie möglicherweise nur die Logeinträge überprüfen, die in einem Logansicht erstellen oder die aus einem bestimmten Google Cloud-Projekt stammen.

Über das Menü Bereich eingrenzen können Sie nach dem aktuellen Projekt, nach Logansicht oder nach Logbereich:

• So suchen Sie nach Projekt, Ordner oder Organisation, die mit in der Projektauswahl, maximieren Sie das Menü Bereich eingrenzen und Wählen Sie Aktuelles Projekt aus.

  Für alle Ressourcen enthalten die Suchergebnisse die Logeinträge, die ihren Ursprung in der Ressource. Bei Google Cloud-Projekten enthalten auch die Logeinträge, die an das Projekt von einer Senke in einem anderen Projekt.

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

  Hinweis: Verwenden Sie diese Einstellung, wenn Sie weitergeleitete Logeinträge aufrufen möchten. durch eine aggregierte Senke.

  Wenn ein Projekt mit der Projektauswahl ausgewählt wird, werden im Menü die Logansichten in Log-Buckets, die vom ausgewählten Projekt gespeichert wurden. Wenn Sie jedoch Ordner oder Organisation ausgewählt ist, werden im Menü alle Logansichten, in denen Logeinträge gespeichert werden, die von diesen Ressourcen stammen.

  So ändern Sie das Menü „Logansicht“, um Logansichten für Log-Buckets einzuschließen die in einem Projekt gespeichert sind, Klicken Sie auf  Projekt importieren und wählen Sie für das Projekt.

• Um nach den Ressourcen zu suchen, die in einem Logumfang das Projekt- und Logansichten umfassen kann, maximieren Sie das Menü Bereich eingrenzen und Wählen Sie Logumfang und dann einen Logumfang aus.

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

  Log SCOPES befinden sich in der öffentlichen Vorschau.

Bereich Abfrage

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

• Tab Abfrage: Erstellen und optimieren Sie Abfragen mithilfe der folgenden Funktionen:

  • Auswahl des Zeitraums: Hier können Sie einen Zeitraum für die Logeinträge angeben, die Sie sich ansehen möchten. Weitere Informationen finden Sie unter Auswahl für den Zeitraum verwenden.

  • Suchtextfeld: Suchen Sie nach Logeinträgen, 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.

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

  • Feld „Abfrageeditor“: Ermöglicht das Erstellen erweiterter Abfragen mithilfe der Logging-Abfragesprache. Weitere Informationen finden Sie unter Erweiterte Abfragen schreiben

    Hinweis: Der Log-Explorer fügt implizit den Parameter Konjunktionseinschränkung, AND, zwischen den im Abfragebereich angezeigten Anweisungen. Beispiel: Zeile 1 ist resource.type = "gce_instance" und Zeile 2 ist severity >= "ERROR" lautet die Abfrage resource.type = "gce_instance" AND severity >= "ERROR" Wenn Sie eine im Log-Explorer angezeigte Abfrage in einem anderen Kontext verwenden möchten, z. B. für den Einschluss- oder Ausschlussfilter einer Senke, müssen Sie die Abfrage ändern und die konjunktiven Einschränkungen hinzufügen. Weitere Informationen finden Sie unter Logging-Abfragesprache.

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

• Tab Gespeichert: 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 Abfragen freigeben.

• Tab Vorschläge: Hier finden Sie Vorschläge für Abfragen, die auf den Ressourcen in Ihr Google Cloud-Projekt. Weitere Informationen finden Sie unter Vorgeschlagene Abfragen verwenden

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

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

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

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

• Abfrage ausführen: Führen Sie Ihre Abfragen aus, nachdem Sie sie in der Query (Abfrage).

Wenn das Feld „Query Editor“ nicht angezeigt wird, aktivieren Sie Abfrage anzeigen. Wenn Sie Suchbegriffe in das Suchtextfeld einfügen, werden diese Begriffe auch im Feld „Abfrageeditor“ angezeigt und als Teil des Abfrageausdrucks ausgewertet.

Nachdem Sie die Abfrage überprüft haben, klicken Sie auf Abfrage ausführen. Übereinstimmende Logs Ihre Abfrage wird im Bereich Abfrageergebnisse aufgeführt. Die Bereiche Histogramm und Logfelder werden entsprechend dem Abfrageausdruck angepasst.

Logs streamen

Sie können Logs streamen als Logging speichert sie in Log-Buckets. Alternativ können Sie nur die Logs streamen, die mit der Abfrage übereinstimmen.

Um Logs basierend auf einer Abfrage zu streamen, fügen Sie eine Abfrage im Bereich Abfrage hinzu. Wählen Sie dann Logs streamen aus. Während Logging die Logdaten speichert in Log-Buckets werden nur die Logs angezeigt, die mit der Abfrage übereinstimmen. Abfrageergebnisse: Wenn keine Abfrage angegeben ist, Logging zeigt jeden Logeintrag beim Speichern an.

Wenn Sie das Streaming beenden möchten, klicken Sie auf Streaming beenden oder scrollen Sie im Abfrageergebnisse:

Symbolleiste Ergebnisse

In der Symbolleiste Ergebnisse haben Sie folgende Möglichkeiten:

• Logfeld: Bereich Logfeld ein- oder ausblenden aus dem Seitenlayout des Log-Explorers. Weitere Informationen finden Sie in der Bereich Logfeld in diesem Dokument.
• Histogramm: Blenden Sie den Bereich Histogramm ein oder aus. aus dem Seitenlayout des Log-Explorers. Weitere Informationen finden Sie im Abschnitt Histogramm in diesem Dokument.
• Ergebnisse analysieren: Mit Log Analytics können Sie Abfrageergebnisse zusammenfassen und in Diagrammen darstellen. Dieses Die Schaltfläche wird nur angezeigt, wenn der ausgewählte Bereich einen Log-Bucket enthält, der wurde aktualisiert, damit Loganalysen verwendet werden können. Weitere Informationen finden Sie im Abschnitt Ergebnisse analysieren dieses Dokuments.
• Messwert erstellen: Richten Sie einen logbasierten Messwert ein.
• Benachrichtigung erstellen: Richten Sie eine logbasierte Benachrichtigungsrichtlinie.
• Zu jetzt springen: Hiermit können Sie eine erzwungene Aktualisierung der Abfrageergebnisse ausführen, um einschließlich der aktuellen Uhrzeit. Wenn für die Zeitraumauswahl Zeitraum festlegen und eine Endzeit festgelegt ist, wird die Abfrage mit einer Standardzeit von einer Stunde. Andernfalls wird sie mit dem aktuellen Startdatum oder und führt die Abfrage aus. Der Abfrageausdruck wird nicht geändert wenn Sie diese Funktion verwenden.

• Weitere Aktionen: Mit diesen zusätzlichen Optionen können Sie logbasierte Benachrichtigungsrichtlinien oder Senke erstellen.

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 über den Log-Explorer aufrufen möchten, klicken Sie in der Symbolleiste Ergebnisse auf Ergebnisse analysieren.

Die Schaltfläche Ergebnisse analysieren ist nur sichtbar, wenn Der ausgewählte Bereich enthält einen Log-Bucket, der für die Verwendung aktualisiert wurde Loganalysen. Wenn Sie beispielsweise über die Schaltfläche Umfang eingrenzen die Option Protokollansicht 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 Upgrade eines Log-Buckets für die Verwendung von Loganalysen durchführen

Folgendes passiert, wenn Sie auf Analysieren klicken :

• Der Zeitraum im Log-Explorer wird möglicherweise automatisch angepasst, ob die Seite Loganalysen aussagekräftige Protokolldaten enthält.

• Die Seite Loganalysen wird in einem neuen Tab geöffnet und übersetzt automatisch die aktuelle Abfrage in der Logging-Abfragesprache in eine SQL-Abfrage umwandeln.

• Die von der Google Cloud-Projektauswahl ausgewählte Ressource und der Wert des Mit der Einstellung Bereich eingrenzen wird festgelegt, 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ü Bereich eingrenzen die Option Projekt angezeigt wird, werden die Buckets _Required und _Default 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 von Log-Buckets, die von der Ressource gespeichert sind, werden abgefragt. Logbereiche befinden sich in der öffentlichen Vorschau.
  Hinweis: Loganalysen unterstützen keine projekt- oder regionsübergreifenden Abfragen. Wenn die Einstellung Bereich eingrenzen Logeinträge enthält, die in mehreren Projekten oder Regionen enthält, wird in der Loganalyse möglicherweise andere Logeinträge als auf der Seite Log-Explorer.

Auf der Seite „Loganalysen“ können Sie Ihre Ergebnisse in Tabellenform, oder als Diagramm. 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. Für Informationen zum Erstellen von Diagrammen aus Abfrageergebnissen und zum Speichern von Diagrammen in ein benutzerdefiniertes Dashboard Abfrageergebnisse mit Loganalysen als Diagramm darstellen

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

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 Abfrageeditor-Feld ausgeführt haben, erscheint der Bereich Logfelder. wird basierend auf den Ergebnissen der Abfrage ausgefüllt. In diesem Bereich wird die Anzahl der Logeinträge für jede unterstützte Dimension. Für jede Dimension können Sie eine Auswahl treffen. Die folgenden Dimensionen sind immer verfügbar:

• Ressourcentyp

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

• Schweregrad

  Wenn Sie Ihre Abfrage filtern möchten, nach verschiedenen Schweregraden sortieren, und verwenden Sie dann das Menü Schweregrad.

Möglicherweise wird eine Dimension Dienst angezeigt:

• Bei Logs mit dem Ressourcentyp Kubernetes-Container Wenn Sie Ihre Logs nicht nach Ressourcentyp gefiltert haben, wird das Menü Service ausgefüllt. Die Einträge in diesem Menü sind dynamisch durch die Werte der Ressourcen Label „k8s-pod/app“.

  Wenn als Ergebnis ein Logeintrag wie der Folgende angezeigt wird Ihrer Abfrage 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, wird das Menü Service ausgefüllt. Die Einträge in diesem Menü sind dynamisch durch die Werte des Labels service der Ressource bestimmt.

Andere Dimensionen, wie z. B. Projekt-ID, werden basierend auf Ihrem Auswahl. Die Dimension Projekt-ID wird beispielsweise aufgeführt, wenn Ihre -Abfrage beschränkt die Logeinträge auf Einträge mit dem Ressourcentyp Kubernetes-Container oder wenn Sie Logansicht ausgewählt haben.

Abfrage optimieren

Wählen Sie im Bereich Logfelder einen Wert aus, um die Abfrage zu verfeinern. Beispiel: Wenn Sie unter Schweregrad Fehler auswählen, Abfragebereich wurde aktualisiert und enthält jetzt severity=ERROR.

Der folgende Screenshot zeigt das Feld im Abfrageeditor, 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. Beispiel: wenn Sie häufig nach dem Wert des Felds jsonPayload.message filtern, dann gilt: fügen Sie sie 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  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 zum Beispiel protoPayload.authorizationInfo[0].resource

Histogramm

Hinweis: Jedes Element des Histogramms zeigt die ungefähre Anzahl Logeinträge, die in dem mit dem Element verknüpften Zeitintervall empfangen wurden. Wenn Sie die genaue Anzahl der in einem bestimmten Zeitraum empfangenen Logeinträge ermitteln möchten, verwenden Sie Log Analytics oder kopieren Sie die Logs in einen Cloud Storage-Bucket.

Im Bereich Histogramm können Sie die Verteilung von Logs über . Das Histogramm wird neu erstellt, wenn Sie eine Abfrage ausführen. Dadurch können Sie leichter Trends in den Logdaten erkennen und Probleme beheben.

Um den Bereich Histogramm ein- oder auszublenden, klicken Sie auf Histogramm in Ergebnisse.

Histogrammfunktionen

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 in den Abfrageergebnissen angezeigt werden . Die Zeitachse hilft Ihnen bei der Orientierung an den angezeigten Logs. im größeren Zeitraum der Abfrage.

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 im Die Bereiche Abfrageergebnisse und Protokollfelder werden entsprechend dem Zeitraum angepasst. die in der Zeitachse des Histogramms erfasst wurden. Zeitsteuerelemente des Histogramms anpassen Der Abfrageausdruck im Bereich Query (Abfrage) wird dadurch nicht geändert.

Zeit schnell anpassen

Das Histogramm bietet Zeitsteuerelemente, mit denen Sie die im Log-Explorer angezeigten Daten schnell 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 Histogramm-Zeitachse zu erweitern. Klicken Sie auf Ausführen.

• Zeitachse vor und zurück schieben: Klicken Sie Vorwärtspfeil um die Zeitachse auf einen späteren Zeitpunkt zu verschieben. Klicken Sie auf Rückwä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.

Ä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 Steuerelementen für die Zeit stellt das Histogramm die Scroll- Zeit und Zoomen auf Zeit, um eine genauere Kontrolle und die Daten, 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 Zur Zeit 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 Histogramm-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 Histogrammleiste klicken, 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

Verwenden Sie den Bereich Abfrageergebnisse, um die Ergebnisse Ihrer Abfragen anzusehen. 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.

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 entsteht mehr horizontaler Raum, finden Sie weitere Informationen im Logeintrag.

Um auszuwählen, welche Teile des Zeitstempels angezeigt werden sollen, klicke auf das Das Menü Weitere Zeitoptionen im Menü Zeit und wählen Sie 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 Ihren Abfrageergebnissen an und möchten die Ergebnisse schnell nach einem bestimmten LogEntry-Feld überfliegen. Oder vielleicht Ihre Logeinträge nach einem bestimmten Feld/Wert-Paar gruppieren. Sie können Zusammenfassungsfelder hinzugefügt, die als Chips am Anfang jedes Ergebnisses angezeigt werden. Logeintragszeile. Die folgende Abbildung zeigt beispielsweise Abfrageergebnisse mit dem Parameter Zusammenfassungsfeld resource.type, das jeder Logeintragszeile hinzugefügt wurde:

Der Log-Explorer bietet Standard- und benutzerdefinierte Zusammenfassungsfelder. Standard-Zusammenfassungsfelder hängen von Ihren aktuellen Abfrageergebnissen und der benutzerdefinierten Zusammenfassung ab können Sie jedes Feld im LogEntry auswählen.

Um Zusammenfassungsfelder in Ihren Abfrageergebnissen auszublenden, verwenden Sie die Methode Ein/Aus-Schaltfläche für Zusammenfassungsfelder. Wenn diese Ein/Aus-Schaltfläche aktiviert ist, die im Rohdatenformat angezeigt werden. Standardmäßig ist der Inhalt jedes Logeintrags auf eine Zeile gekürzt. Um bis zu 10 Zeilen für jeden Logeintrag anzuzeigen, verwenden Sie die Ein/Aus-Schaltfläche Zeilenumbruch . Leerzeichen werden in jedem Logeintrag beibehalten.

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

So ändern Sie Zusammenfassungsfelder:

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

   

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

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

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

     • Automatische Vervollständigung anhand der Logs, die in den 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 von ob sie Ihnen von der Funktion zur automatischen 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 Ihrer benutzerdefinierten Zusammenfassungsfelder.

     Um die Anzeige der Zusammenfassungsfeldwerte zu kürzen, verwenden Sie die Methode Ein/Aus-Schaltfläche für 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.

     Tipp :Halten Sie den Mauszeiger gedrückt, um den vollständigen Wert eines Zusammenfassungsfelds anzuzeigen. über ein abgeschnittenes Zusammenfassungsfeld in Ihren Abfrageergebnissen.

   • 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 werden jetzt in den Abfrageergebnissen aktualisiert.

In Abfrageergebnissen suchen

Klicken Sie auf In Ergebnissen suchen, um im Inhalt der Abfrageergebnisse zu suchen. im Bereich Abfrageergebnisse und geben Sie Ihren Suchbegriff ein. Dieser 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 den Logeinträgen in der Bereich Abfrageergebnisse:

Ähnliche Logeinträge ansehen

Sie können Logeinträge aufrufen, die einem ausgewählten Logeintrag ähneln. konzentrieren Sie sich auf relevante Protokolle.

So rufen Sie ähnliche Logeinträge auf:

1. Führen Sie bei einem Logeintrag im Bereich Abfrageergebnisse folgende Schritte aus: Klicken Sie 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:

   --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 Ä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 ein- oder ausblenden:

   

Ähnliche Logeinträge ausblenden

Sie können ähnliche Logeinträge ausblenden, um Logs aus der Abfrage zu entfernen Ergebnisse.

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 Muster und Logeinträge werden dann automatisch basierend auf ähnlichen Protokollen gruppiert, Feldinhalt.

  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 Daten werden neu geladen. der Abfrageergebnisse.

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

  Wenn Sie ähnliche Protokolle ausblenden, werden keine Informationen außerhalb des Log-Explorer-Sitzung. Für jede Abfrage wird eine neue Analyse erstellt, die nur auf den angezeigten Protokollen basiert. Bei verschiedenen Abfragen werden verschiedene Teile des Logeinträge abhängig von den zurückgegebenen Protokolltypen.

• Logeinträge ausblenden, die einem bestimmten Logeintrag ähneln. So blenden Sie Logeinträge aus Gehen Sie ähnlich wie bei einem Logeintrag so vor:

  1. Klicken Sie im Logeintrag auf Maximieren. auf das Menü Ähnliche Einträge und wählen Sie Ähnliche Einträge ausblenden:

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

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

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

So können Sie Logeinträge, die mit einem bestimmten Feld in einem Logeintrag übereinstimmen, ein- oder ausblenden: Folgendes:

1. Führen Sie im Bereich Abfrageergebnisse für den Logeintrag folgende Schritte aus: Klicken Sie auf Maximieren.

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

   Das folgende Menü wird angezeigt:

   

3. Wählen Sie Ü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 hervorheben, 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, die Markierung des Logeintrags aufzuheben.

So pinnen Sie einen Logeintrag an:

1. Halten 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 abgedunkelt und Anpinnen-Symbol wird angezeigt. Ein Stecknadelsymbol wird basierend auf den Werten des angepinnten Logeintrags auch im Bereich Histogramm angezeigt. timestamp:

Wenn Sie einen Logeintrag loslösen möchten, klicken Sie noch einmal auf das Symbol „Anpinnen“.

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

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

Um Log-Einträge anzupinnen und Log-Einträge anzuzeigen, die dem gleichen Ressourcentyp oder Gehen Sie so vor:

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

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

   • Um die Abfrage erneut auszuführen, resource.type als Angepinntes Log wählen Sie Gleicher Ressourcentyp aus.

     Angenommen, Sie pinnen einen Logeintrag mit einer resource.type von k8s_node. 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.

   • Um die Abfrage erneut auszuführen, trace als angepinnt Protokoll, wählen Sie Gleicher Trace aus.
   • Um die Abfrage zu löschen und alle Logeinträge anzusehen, 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: Logeintrag in den aktuellen Abfrageergebnisse und sehen Sie sich den angepinnten Logeintrag in der nahegelegene Protokolle angezeigt werden.
• Zum Logeintrag heranzoomen: Begrenzen Sie den Zeitraum, der im Bereich Histogramm angezeigt wird, und verfeinern Sie Ihre 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.

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 zur finden Sie im Detailbereich unter Traces suchen und untersuchen

Hinweis: Die Schaltfläche Trace-Details anzeigen 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.

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

Hinweis: Der Bulk-Download von Logeinträgen wird von dieser Funktion nicht unterstützt. Sie können bis zu 10.000 Protokolleinträge herunterladen, sofern ausreichend Zeit für die Abfrage der Logs bleibt ausführen, kann der Download innerhalb des Zeitlimits für den Befehl abgeschlossen werden. Sie können mehrere Logs gleichzeitig in einen Ordner kopieren: Cloud Storage-Bucket.

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 in der Symbolleiste für den Bereich Abfrageergebnisse auf  Herunterladen.

2. Wählen Sie im Dialogfeld Logs herunterladen das CSV- oder JSON-Format aus und Klicken Sie 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 Tabellen.

Informationen zur Fehlerbehebung finden Sie unter Das Herunterladen der Logs schlägt fehl.

Beispielabfragen

Vorgeschlagene Abfragen, sortiert nach Google Cloud-Produkt und Anwendungsfällen, finden Sie unter Beispielabfragen mit dem Log-Explorer Sie können beispielsweise Kubernetes-bezogene Abfragen, um die Google Kubernetes Engine-Logs

Compute Engine-Logs ansehen

Für bestimmte Compute Engine-Ressourcentypen wie gce_instance und gce_network, sehen Sie den Ressourcennamen mit der Ressourcen-ID als Untertext in an mehreren Stellen im Log-Explorer. Beispiel: Für das Feld gce_instance Ressourcentyp, wird neben der VM-ID der VM-Name angezeigt. Hilfe zu Ressourcennamen ermitteln Sie die richtige Ressourcen-ID, auf der Sie Abfragen erstellen können.

Compute Engine-Ressourcennamen können an den folgenden Stellen angezeigt werden:

• Filtermenüs im Bereich Abfrage: Für Compute Engine-Ressourcentypen werden Ressourcennamen mit den entsprechenden Ressourcen-IDs als Untertext angezeigt.
• Logfelder: Compute Engine-Ressourcentypen statt der Ressourcen-ID, wird der Name der Ressource in den Felddimensionen angezeigt.
• Abfrageergebnisse: Für Compute Engine-VM-Instanzlogs enthält der Das Feld resource.labels zeigt Metadaten mit dem entsprechenden Ressourcennamen an.
• Zusammenfassungsfelder: Für Compute Engine-VM-Instanz Logs enthält, 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, Siehe Fehlerbehebung bei Routing und Senken.

Log-Download schlägt fehl

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

Reduzieren Sie die Zeit, die für die Ausführung des Befehls benötigt wird, um dieses Problem zu beheben indem Sie Folgendes versuchen:

• 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 der Abfrageergebnisse auf Ähnliche Einträge ausblenden, bevor Sie um den Download zu starten.

• Ändern Sie die Abfrage so, dass indexierte Felder verwendet werden.

Hinweis: Die Downloadfunktion ist nicht für den Bulk-Download von Protokollen vorgesehen. Ich können Logs in einen Cloud Storage-Bucket kopieren.

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. 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 im Menü Serieller Port 1 (Konsole) die Option aus. Logs der Seite hinzu.

Sie können Ihre Instanzen so konfigurieren, dass die Ausgabe des seriellen Ports so ist: an Cloud Logging gesendet. Weitere Informationen finden Sie unter Logging für die Ausgabe des seriellen Ports aktivieren und deaktivieren

Google Cloud-Projekt- oder Organisations-ID abrufen

Um ein Google Cloud-Projekt oder eine Organisations-ID von überall im Maximieren Sie die Liste der Google Cloud-Projekte in der Google Cloud Console über die Google Cloud-Projekt- und Organisationsauswahl und suchen Sie nach Google Cloud-Projekt-ID in die Spalte ID ein.

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.

• Achten Sie darauf, dass der Zeitraum nicht zu eng ist.

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

• Achten Sie darauf, dass Sie die Berechtigung zum Ansehen der Logeinträge in den Projekten und Logansichten, auf die über die Einstellung im Menü Bereich eingrenzen verwiesen wird Informationen zum Anpassen des Umfangs Ihrer Suche 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 identifiziert mehr als 200 Buckets mit Einträgen geschrieben wurden, schlägt die Abfrage mit der Meldung Error: Invalid query

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 die Zeitsteuerung des Histogramms oder die Zeitraumauswahl. Durch das Anpassen der Zeitsteuerelemente ändert sich nichts Den Abfrageausdruck im Bereich Abfrage.

Bei Abfragen mit Zeitstempel ist die Zeitraumauswahl deaktiviert. In der Abfrage wird der Zeitstempelausdruck als Zeitraumeinschränkung verwendet. 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.