Benutzeroberfläche der Loganzeige (Vorschau)

Vorbereitung

Sie benötigen für Logging keinen Arbeitsbereich, es sei denn, Sie senden Logs von Amazon Web Services (AWS) an Logging.

Wenn Sie einen Arbeitsbereich nutzen, werden die Logs der überwachten Google Cloud-Projekte beim Logging nicht kombiniert. Sie müssen dann ein bestimmtes Cloud-Projekt auswählen, um die zugehörigen Logs abzurufen.

Wenn Sie einen Arbeitsbereich und AWS verwenden, wählen Sie das AWS-Verbindungsprojekt aus, um die AWS-Logs abzurufen.

Erste Schritte

So rufen Sie die Loganzeige (Vorschau) auf:

  1. Rufen Sie das Google Cloud-Navigationsmenü auf und wählen Sie Logging > Loganzeige aus.
    Zur Loganzeige
  2. Wählen Sie ein Google Cloud-Projekt aus.
  3. Ändern Sie im Menü zur Versionsauswahl die Version der Loganzeige von Klassisch in Vorschau der neuen Loganzeige ansehen.

Sie befinden sich jetzt in der Loganzeige (Vorschau).

Benutzeroberfläche der Loganzeige

Über die Benutzeroberfläche der Loganzeige können Sie Logs abrufen, Logdaten parsen sowie analysieren und Ihre Abfrageparameter verfeinern.

Benutzeroberfläche der Loganzeige

  1. Seite "Loganzeige": Ermöglicht das Erstellen, Analysieren und Verfeinern von Abfragen.
  2. Organisation und Projektauswahl: Ermöglicht das Aufrufen von Logs auf Organisations- oder Projektebene.
  3. Query Builder: Ermöglicht das Erstellen von Abfragen entweder über die Drop-down-Menüs oder über die Query Builder-Sprache. Außerdem ist ein Tab zum Anzeigen Ihrer gespeicherten Abfragen verfügbar.
  4. Logfeld-Explorer (Beta): Ermöglicht die Anzeige aggregierter Ergebnisse für resource.type, resource.labels, logName sowie severity und bietet eine effizientere Möglichkeit, um eine Abfrage zu verfeinern.
  5. Histogramm: Ermöglicht die Visualisierung der Häufigkeit Ihrer Logdaten.
  6. Abfrageergebnisse: Ermöglicht die Anzeige der mit Ihrer Abfrage abgerufenen Logs.
  7. Logeinträge: Ermöglicht die Anzeige von Logeinträgen im strukturierten JSON-Format.
  8. Zeitzone: Ermöglicht das Ändern der Zeitzone, in der die Logs angezeigt werden.
  9. Seitenlayout: Ermöglicht das Aktivieren und Deaktivieren der Bereiche Histogramm und Logfeld-Explorer.
  10. Zeitraumauswahl: Ermöglicht das Einschränken der Ergebnisse nach Zeitraum. Standardmäßig beträgt der Zeitraum eine Stunde.
  11. Abfrage ausführen: Ermöglicht das Ausführen Ihrer Abfragen, nachdem Sie sie im Query Builder-Fenster erstellt haben.
  12. Zu jetzt springen: Ermöglicht das Ausführen einer erzwungenen Aktualisierung, um die aktuelle Uhrzeit einzubinden. Wenn für die Zeitraumauswahl ein benutzerdefinierter Bereich verwendet wird und eine Endzeit festgelegt ist, wird die Abfrage mit dem Standardzeitraum von einer Stunde ausgeführt. Andernfalls wird die Abfrage mit dem aktuellen Startdatum oder mit der aktuellen Dauer aktualisiert und ausgeführt.
  13. Aktionen: Ermöglicht das Ausführen bestimmter Aktionen für Ihre Logs, z. B. das Erstellen eines logbasierten Messwerts oder eines Senkenziels.
  14. Konfigurieren: Ermöglicht das Hinzufügen des Werts eines Logfelds zur Zusammenfassungszeile am Anfang oder Ende des Logeintrags. Außerdem können Sie festlegen, dass die neuesten oder die neuesten Logs angezeigt werden.
  15. Logzusammenfassung verbergen: Ermöglicht das Ausblenden der Zeile mit der Logzusammenfassung aus den Abfrageergebnissen.
  16. Verschachtelte Logfelder maximieren oder minimieren: Ermöglicht das Maximieren oder Minimieren verschachtelter Felder.
  17. In Zwischenablage kopieren: Ermöglicht das Kopieren des Logeintrags im JSON-Format.
  18. Speichern: Ermöglicht die Speicherung von Abfragen, die auf dem Tab Gespeichert angezeigt und ausgeführt werden können.
  19. App Engine-Trace-Daten: Hiermit können Sie Trace-Details anzeigen und Ihre Abfrage anhand des Trace verfeinern.
  20. Abfrageergebnisse maximieren und minimieren: Hiermit können Sie den Bereich mit den Abfrageergebnissen erweitern, um weitere Log-Einträge anzuzeigen.
  21. Zeitraum anpassen: Hiermit können Sie den Zeitraum für Abfragen ändern, indem Sie die Ziehpunkte anpassen. Klicken Sie nach dem Anpassen der Ziehpunkte auf Ausführen, um den in der Abfrage verwendeten Zeitraum zu aktualisieren.

Im Bereich der Abfrageergebnisse können Sie auf die Werte eines Felds klicken und folgende Aktionen ausführen:

  1. Übereinstimmende Einträge anzeigen: Ermöglicht die Suche nach übereinstimmenden Logeinträgen.
  2. Übereinstimmende Einträge ausblenden: Ermöglicht das Abfragen von Logeinträgen, die nicht mit dem ausgewählten Ausdruck übereinstimmen.
  3. Feld in Zusammenfassungszeile einfügen: Ermöglicht das Hinzufügen des Felds als Zusammenfassungszeile zu Logeinträgen.

Optionen nach Auswahl des Feldwerts

Zusammenfassungsfelder hinzufügen

Zusammenfassungsfelder bieten die Möglichkeit, Muster in Ihren Logs schneller zu ermitteln. Die folgende Abbildung enthält beispielsweise den Wert für das Zusammenfassungsfeld resource.labels.pod_name, das vor den Logs mit diesem Wert eingefügt wurde.

Logs in der Loganzeige mit vorangestelltem grünem Text für Pod-Namen

Zusammenfassungsfeld aus einem Logeintrag hinzufügen

Mit den folgenden Schritten können Sie einem Logeintrag ein Zusammenfassungsfeld hinzufügen:

  1. Klicken Sie zur Maximierung des Logeintrags auf die Maximierungsschaltfläche .

  2. Klicken Sie auf den Wert eines Felds und wählen Sie Feld in Zusammenfassungszeile einfügen aus.

    Das Zusammenfassungsfeld wird nun vor den Logeinträgen angezeigt, die dieses Feld enthalten.

Zusammenfassungsfeld mithilfe der Schaltfläche Konfigurieren hinzufügen

Mit den folgenden Schritten fügen Sie mithilfe der Schaltfläche Konfigurieren ein Zusammenfassungsfeld hinzu:

  1. Klicken Sie auf Konfigurieren und wählen Sie Zusammenfassungsfelder verwalten aus.

    Auswahl von

  2. Fügen Sie Felder hinzu.

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

    • Automatische Vervollständigung anhand der aktuell angezeigten Logs
    • Feldkorrektur für zulässige Zeichen in Anführungszeichen

      Wenn Sie beispielsweise jsonPayload.id-field eingeben, wird der Wert in jsonPayload."id-field" geändert.

  3. Klicken Sie auf Zusammenfassungsfelder kürzen, um die Anzeige der Werte des Zusammenfassungsfelds zu kürzen. Wählen Sie dann aus, wie viele Zeichen angezeigt werden sollen, wenn das Feld gekürzt wird, und ob der Anfang oder das Ende des Felds angezeigt werden soll.

  4. Klicken Sie auf Anwenden.

    Das Zusammenfassungsfeld wird nun vor den Logeinträgen angezeigt, die dieses Feld enthalten.

Bereich "Logfeld-Explorer"

Der Bereich Logfeld-Explorer bietet eine allgemeine Zusammenfassung der Logdaten sowie eine effizientere Möglichkeit, um eine Abfrage zu verfeinern. Darin wird die Anzahl der Logeinträge für das angegebene Logfeld abnehmend sortiert angezeigt. Die Anzahl der Logfelder entspricht dem Zeitraum, der im Feld Histogramm festgelegt ist.

Der Logfeld-Explorer wird anhand der ausgeführten Abfrage gefüllt und aktualisiert. Bei einer leeren Abfrage wird im Bereich Logfeld-Explorer die Anzahl der Logeinträge nach den Feldern "Ressourcentyp" und "Logschweregrad" angezeigt.

Bereich "Logfeld-Explorer" verwenden

Sie können Felder aus dem Bereich Logfeld-Explorer zu Query Builder hinzufügen, um eine Abfrage einzugrenzen und zu verfeinern. Klicken Sie dazu im Feld Logfeld-Explorer auf einen Feldwert. Dadurch wird das Logfeld in Query Builder eingefügt und die Abfrage automatisch ausgeführt. Dazu wird das Logfeld der ursprünglichen Abfrage mit dem Operator AND als Ausdruck hinzugefügt.

Beim Ausführen einer Abfrage wird die Anzahl der Logfelder inkrementell geladen, da die Logeinträge schrittweise gescannt werden. Wenn die Abfrage abgeschlossen ist – erkennbar am Ausblenden der blauen Fortschrittsanzeige –, sehen Sie die Gesamtzahl für alle Logfelder.

Feld "Histogramm"

Im Feld "Histogramm" können Sie die Verteilung der Logs im Zeitverlauf visualisieren. Damit lassen sich Trends in Ihren Logdaten leichter erkennen und Probleme beheben.

Feld "Histogramm" aktivieren

Um das Feld "Histogramm" zu aktivieren, wählen Sie Seitenlayout aus und klicken auf das Kästchen Histogramm. Das Feld Histogramm wird dann angezeigt.

Das Seitenlayout ist geöffnet und

Um das Feld "Histogramm" zu deaktivieren, entfernen Sie das Häkchen aus dem Kästchen Histogramm.

Feld "Histogramm" verwenden

Wenn Sie eine Abfrage ausführen, wird ein Histogramm generiert. Es zeigt die Häufigkeit übereinstimmender Logeinträge für den ausgewählten Zeitraum an.

Logs analysieren

Um Ihre Logdaten zu analysieren, bewegen Sie den Mauszeiger auf einen Balken im Feld Histogramm und wählen Sie Zu Zeitpunkt springen aus, um einen kleineren Zeitraum auszuwählen. Dadurch wird eine neue Abfrage mit dieser Zeitraumbeschränkung ausgeführt.

Loghistogramme mit Pop-up-Dialogfeld

App Engine-Trace-Daten

Wenn ein App Engine-Logeintrag einen Trace enthält, wird der Latenzchip mit einem Trace-Symbol angezeigt.

Logeintrag mit Trace-Daten

Wenn Sie auf den Trace-Latenzchip klicken, haben Sie folgende Möglichkeiten, Ihre Abfrage weiter zu verfeinern und die Details des Trace anzuzeigen:

  • Trace-Details anzeigen: Zeigt die übergeordneten Span- und untergeordneten Traces sowie Details zum Trace in einem Steuerfeld an. Weitere Details zum Trace finden Sie unter In Trace ansehen. Weitere Informationen zum Inhalt im Fließfeld finden Sie unter Trace-Details anzeigen.

  • Alle Logs für diesen Trace anzeigen: Verfeinert und führt die Abfrage aus, indem das Feld trace zur Kennung des mit dem Logeintrag verknüpften Traces hinzugefügt wird.

  • Nur verfolgte Anfragen anzeigen: Vereinfacht und führt die Abfrage aus, indem das Feld traceSampled auf True gesetzt wird. Weitere Informationen zur Stichprobenerfassung finden Sie unter Abtastrate.

Fehlerbehebung

In diesem Abschnitt finden Sie eine Anleitung zur Behebung häufiger Probleme bei der Verwendung der Loganzeige (Vorschau).

Cloud-Projekt oder Organisation auswählen

Zum Auswählen eines Cloud-Projekts an einer beliebigen Stelle in der Google Cloud Console, einschließlich der Loganzeige (Vorschau), verwenden Sie die Projekt- und Organisationsauswahl:

Auswahl eines Projekts aus dem Dropdown-Menü

Cloud-Projekt- oder Organisations-ID abrufen

Zum Abrufen einer Cloud-Projekt- oder Organisations-ID an einer beliebigen Stelle in der Google Cloud Console erweitern Sie die Liste der Projekte in der Projekt- und Organisationsauswahl und suchen Sie die Projekt-ID in der Spalte ID:

ID für das Projekt wird angezeigt

Logeinträge werden nicht angezeigt

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

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

  • Nutzt Ihr Projekt Ressourcen, die Logs generieren, und sind diese Ressourcen aktiv? Auch bei einem neuen Projekt sollten Audit-Logs vorhanden sein, die dessen Erstellung dokumentieren. Prüfen Sie, ob Sie eine Ressource verwenden, die Logs generiert. Informationen dazu finden Sie auf der Seite "Liste überwachter Ressourcen" im Abschnitt Dienste Ressourcentypen zuordnen auf.

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

  • Sehen Sie sich Ihre aktuellen Ausschlussabfragen an, um sicherzustellen, dass die gesuchten Logs nicht versehentlich ausgeschlossen werden.

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

  • Logeinträge, die älter als die Aufbewahrungsdauer von Logging sind, 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.

  • In der Loganzeige werden Logeinträge mit in der Zukunft liegenden Zeitstempeln erst bei Erreichen des angegebenen Zeitpunkts aufgelistet. Ursache ist meist ein Zeitversatz in der Anwendung, aus der die Logs stammen.

Support

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