Protokolle und Fehler in einem benutzerdefinierten Dashboard anzeigen

In diesem Dokument werden die Widgets beschrieben, die Sie Ihren benutzerdefinierten Dashboards hinzufügen können, damit Sie Ihre Protokoll- und Fehlerdaten im selben Kontext wie Ihre Messwertdaten sehen können. Im Logbereich-Widget werden Logeinträge angezeigt. Im Steuerfeld für die Fehlerberichte werden die neuesten Fehlergruppen angezeigt. Beide Widgets enthalten Informationen, die bei der Fehlerbehebung hilfreich sein können. Mit dem Log Analytics-Diagramm-Widget, in dem die Ergebnisse einer SQL-Abfrage angezeigt werden, können Sie Trends in Ihren Protokolldaten erkennen.

Log-Explorer und Logs-Bereich-Widget

Der Log-Explorer ist die Standardmethode zum Prüfen von Logs. Wenn Sie einem Dashboard ein Widget für den Logbereich hinzufügen, ändert sich nichts an der Verwendung des Log-Explorers. Da Widgets für den Logbereich benutzerdefinierten Dashboards hinzugefügt werden können, können Sie Ihre Logeinträge im selben Kontext wie Ihre Messwerte aufrufen.

Der Log-Explorer und das Logbereich-Widget unterstützen dieselbe Abfragesprache und zeigen nur die Logeinträge an, für die Sie die Berechtigung zum Ansehen haben. Ob Sie die gespeicherten Logeinträge aufrufen können, hängt von Ihren IAM-Rollen (Identity and Access Management) für die Ressourcen ab, in denen die Logeinträge gespeichert sind.

Sowohl der Log-Explorer als auch das Logbereich-Widget sind vorkonfiguriert, um in den im standardmäßigen Logbereich aufgeführten Ressourcen nach Logeinträgen zu suchen. Wenn dieser Bereich nicht zugänglich ist, wird nach den Logeinträgen gesucht, die aus dem ausgewählten Projekt stammen. Wenn ein Projekt ausgewählt ist, enthalten die Suchergebnisse die Logeinträge, die von einer Senke in einem anderen Projekt an das Projekt weitergeleitet und dann in einem Log-Bucket gespeichert werden. Sie können konfigurieren, in welchen Ressourcen nach Logeinträgen gesucht wird. Sie können beispielsweise nach Logansicht nach Logeinträgen suchen.

In den Widgets im Bereich „Protokolle“ wird ein Logeintrag pro Zeile mit Spalten für den Schweregrad, den Zeitstempel und eine Zusammenfassung des Logeintrags angezeigt. Wenn Sie die JSON-Darstellung eines Logeintrags aufrufen möchten, klicken Sie auf die Schaltfläche Logdetails ansehen. Die Struktur der einzelnen Eintragszusammenfassungen variiert je nach Protokolltyp. Die folgende Abbildung zeigt beispielsweise zwei Logeinträge:

Ein Bild von zwei Logeinträgen im Log-Feld-Widget.

Auf dem vorherigen Bild enthält der erste Logeintrag Informationen zu einer Dienstanfrage. Die Zusammenfassung enthält Informationen zum Dienst, eine E-Mail-Adresse und eine als String formatierte Version der JSON-Struktur für den Eintrag. Der zweite Eintrag enthält die Ergebnisse einer Anfrage und nur einen Satz, in dem die ausgeführte Aktion zusammengefasst wird.

Allgemeine Informationen zu Cloud Logging finden Sie in den folgenden Ressourcen:

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie benötigen, um einem benutzerdefinierten Dashboard über die Google Cloud Console ein Widget für den Logbereich hinzuzufügen und es so zu konfigurieren, dass Protokolleinträge in Projekten oder in Protokollansichten angezeigt werden:

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.

Logeinträge in einem Dashboard anzeigen

In diesem Abschnitt wird beschrieben, wie Sie mit der Google Cloud Console ein Widget für den Bereich „Protokolle“ hinzufügen und konfigurieren. Informationen zur Verwendung der Cloud Monitoring API finden Sie unter Dashboard mit einem LogsPanel-Widget.

Ein Dashboard kann maximal 40 Widgets enthalten.

So fügen Sie dem Dashboard ein Widget für den Logbereich über die Console hinzu:

  1. Rufen Sie in der Google Cloud Console die Seite Dashboards auf.

    Dashboards aufrufen

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

  2. Wählen Sie ein Dashboard aus oder klicken Sie auf Dashboard erstellen.
  3. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.
  4. Wählen Sie im Dialogfeld Widget hinzufügen die Option  Protokolle aus.
  5. Optional: Wenn Sie den Titel aktualisieren möchten, geben Sie den neuen Titel in das Feld Widget-Titel ein.

  6. Konfigurieren Sie, in welchen Ressourcen nach Logeinträgen gesucht werden soll:

    • Wenn Sie nach Projekt suchen möchten, legen Sie den Eintrag Bereich nach auf Projekt fest, maximieren Sie den Eintrag Projekte und schließen Sie das Dialogfeld ab.

      Im Menü Projekte sind alle Google Cloud-Projekte im aktuellen Messwertbereich aufgeführt. Wenn ein Eintrag im Menü den Text „Sie haben keine Berechtigung auf Projektebene zum Ansehen von Logs in diesem Projekt“ enthält, haben Sie nicht die erforderlichen Berechtigungen, um die in diesem Google Cloud-Projekt verfügbaren Logeinträge aufzurufen.

      Zu den angezeigten Logeinträgen gehören solche, die in Ihrem Google Cloud-Projekt stammen, und solche, die über eine Senke in einem anderen Projekt an Ihr Google Cloud-Projekt weitergeleitet werden.

    • Wenn Sie nach Logeinträgen nach Logansichten in Log-Buckets suchen möchten, legen Sie den Eintrag Begrenzung nach auf Speicher fest. Maximieren Sie dann den Eintrag Speicheransichten und schließen Sie das Dialogfeld ab.

      Im Menü Speicheransichten sind Logansichten für Log-Buckets in Ihrem ausgewählten Google Cloud-Projekt aufgeführt.

      Wenn Sie Logansichten für Log-Buckets in anderen Google Cloud-Projekten auswählen möchten, klicken Sie im Menü auf Projekt importieren, wählen Sie ein Projekt und dann eine oder mehrere Logansichten aus. Sie können nur Projekte importieren, die in den aktuellen Messwertumfang eingeschlossen sind.

    • Wenn Sie nach den Ressourcen suchen möchten, die in einem Logbereich enthalten sind, der Projekte und Logansichten enthalten kann, legen Sie den Eintrag Bereich nach auf Logbereich fest. Maximieren Sie dann den Eintrag Logbereiche und wählen Sie einen Logbereich aus.

      Log scopes befinden sich in der öffentlichen Vorschau.

  7. Optional: Wenn Sie einschränken möchten, welche Protokolle im Widget „Logbereich“ angezeigt werden, geben Sie eine Abfrage in das Feld Abfrageeditor ein. Wenn Sie das automatische Ausführen von Abfragen deaktiviert haben, klicken Sie auf Abfrage ausführen. Eine kurze Einführung in Abfragen finden Sie unter Beispiele für Abfragen.

  8. Optional: Wenden Sie Variablen auf das Widget „Logbereich“ an. Variablen sind Filter auf Dashboardebene, die nur auf bestimmte Widgets angewendet werden. Weitere Informationen finden Sie unter Variable auf ein Widget anwenden.

  9. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

  10. Klicken Sie in der Symbolleiste auf Speichern, um das geänderte Dashboard zu speichern.

    Im Widget „Logbereich“ wird eine Tabelle mit Logeinträgen angezeigt. Über die Filterleiste des Widgets können Sie die im Widget angezeigten Logeinträge vorübergehend ändern. Weitere Informationen finden Sie im Abschnitt Logeinträge filtern.

Beispielabfragen

Sie können das Feld Query Editor (Abfrageeditor) entweder durch Eingabe von Text oder durch Auswahl von Optionen aus Menüs ausfüllen. Für das Feld Abfrageeditor wird dieselbe Abfragesprache wie für den Log-Explorer verwendet. Informationen zur Fehlerbehebung finden Sie unter Syntaxprobleme.

In den Menüs Schweregrad und Logname können Sie mehrere Optionen auswählen. Im folgenden Beispiel wird eine Abfrageanweisung verwendet, die mit mehreren Schweregraden übereinstimmt:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

Im Menü Ressource können Sie nach Ressource filtern. Sie können einen Ressourcentyp auswählen, z. B. Geprüfte Ressource, oder durch die Fenster wechseln, um eine bestimmte Methode auszuwählen.

So fügen Sie beispielsweise eine Abfrage für Geprüfte Ressource hinzu:

  1. Maximieren Sie das Menü Ressource.
  2. Suchen Sie nach Geprüfte Ressource und wählen Sie die Option aus.

  3. Klicken Sie auf Anwenden.

    Dadurch wird dem Feld Abfrageeditor die folgende Klausel hinzugefügt:

    resource.type="audited_resource"

So fügen Sie eine Abfrage für Audit-Logs von Cloud Run-Funktionen hinzu:

  1. Maximieren Sie das Menü Ressource.
  2. Suchen Sie nach Geprüfte Ressource und wählen Sie die Option aus.
  3. Wählen Sie im Menü „Dienste“ die Option Cloud Functions aus.

  4. Klicken Sie auf Anwenden.

    Dadurch wird dem Feld Abfrageeditor die folgende Klausel hinzugefügt:

    resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"

Logeinträge filtern

Sie können festlegen, welche Logeinträge in einem Logbereich-Widget angezeigt werden, indem Sie die Werte der folgenden Felder oder Menüs ändern:

  • Zeitauswahl im Dashboard: Im Widget „Protokollbereich“ werden nur Logeinträge abgerufen, die im durch dieses Feld angegebenen Intervall geschrieben wurden.

  • Feld Filter im Widget „Logbereich“: Der von Ihnen angegebene Filter wird nach Abschluss der Abfrage angewendet. Der Wert dieses Felds wird nur für die aktuelle Sitzung beibehalten.

  • Menü Schweregrad im Widget „Logbereich“: Der Filter nach Schweregrad wird nach Abschluss der Abfrage angewendet. Der Wert dieses Felds wird nur für die aktuelle Sitzung beibehalten.

  • Abfrage im Widget „Logbereich“: Im Widget „Logbereich“ werden nur die Logeinträge angezeigt, die mit der Abfrage übereinstimmen. Wenn Sie keine Abfrage angeben, werden alle Protokolle im ausgewählten Zeitraum angezeigt. Wenn Sie eine Abfrage angeben, wird im Widget „Logbereich“ das Symbol Abfrage anzeigen angezeigt. Daraufhin wird die aktuelle Abfrage als Kurzinfo angezeigt.

    Wenn Sie die Abfrage ändern möchten, bearbeiten Sie das Widget „Logbereich“.

  • Google Cloud-Projekt im Widget „Logbereich“: Wenn Sie diese Einstellung ändern möchten, bearbeiten Sie das Widget „Logbereich“.

  • Dashboard-Filter: Wenn Dashboard-Filter vorhanden sind, wird die Filtereinstellung auf die Abfrage des Widgets „Logbereich“ angewendet. Wenn Sie beispielsweise den Dashboard-Filter cluster_name: mycluster hinzufügen, wird die Abfrage um resource.labels."cluster_name"="mycluster" aktualisiert. Weitere Informationen zu Dashboardfiltern finden Sie unter Temporäre Filter hinzufügen und Dauerhafte Filter hinzufügen.

Im Rest dieses Abschnitts finden Sie weitere Informationen zum Filtern von Logeinträgen.

Beispiel: Logeinträge nach Datum filtern

Wenn Sie die neuesten Protokolle in einem Widget für den Protokollbereich anzeigen lassen möchten, verwenden Sie die Zeitfelder in der Dashboard-Symbolleiste. Wählen Sie beispielsweise 1 Stunde aus. Wenn Sie keinen benutzerdefinierten Zeitraum auswählen, werden im Widget immer die neuesten Protokolle angezeigt, auch wenn sie älter als der ausgewählte Zeitraum sind.

Wenn Sie einen Vorfall untersuchen, können Sie die Protokolleinträge auf die Einträge in einem bestimmten Zeitraum beschränken. Führen Sie einen oder beide der folgenden Schritte aus, um die Logeinträge so zu konfigurieren, dass nur Logs in einem festen Zeitintervall angezeigt werden:

  • Wählen Sie mit der Zeitraumauswahl einen Zeitraum aus.
  • Geben Sie im Bereich „Konfiguration“ im Feld Abfrageeditor eine timestamp-Klausel ein und wählen Sie dann Filter anwenden aus.

Wenn Sie ein Zeitintervall angeben, wird das Widget im Logbereich nicht automatisch aktualisiert.

Beispiel: Logeinträge nach Schweregrad filtern

Wenn Sie das Debugging einer Fehlersituation überwachen, möchten Sie möglicherweise nur Fehlermeldungen anzeigen und alle anderen Log-Einträge ausblenden. Führen Sie einen oder beide der folgenden Schritte aus, um ein Logbereich-Widget so zu konfigurieren, dass nur Logeinträge angezeigt werden, die bestimmte Schweregrade erfüllen:

  • Wählen Sie im Logbereich einen Wert für das Menü Schweregrad aus, um einen temporären Filter anzuwenden. In diesem Menü ist ein Schweregrad angegeben. Ein Wert von „Warnung“ führt beispielsweise dazu, dass Logeinträge mit dem Schweregrad „Fehler“ abgerufen werden, aber Logeinträge mit dem Schweregrad „Hinweis“ werden nicht abgerufen. Standardmäßig ist der Wert für dieses Feld auf Default gesetzt, was alle Logeinträge umfasst.

    Die Einstellung für das Menü Schweregrad wird verworfen, wenn Sie das Dashboard verlassen.

  • Wenn Sie einen dauerhaften Filter anwenden möchten, geben Sie im Feld Abfrageeditor im Konfigurationsbereich eine severity-Klausel ein und wählen Sie dann Filter anwenden aus.

Beispiel: Protokolleinträge nach String oder Wortgruppe filtern

Wenn Sie Logeinträge nach einem bestimmten String oder einer bestimmten Wortgruppe filtern, können Sie Logeinträge ausblenden, die nicht relevant sind. Wenn Sie beispielsweise Logeinträge mit einer bestimmten E-Mail-Adresse aufrufen möchten, können Sie nach dieser Adresse filtern.

  • Wenn Sie einen temporären Filter anwenden möchten, damit Sie nur die Logeinträge sehen, die ein bestimmtes Wort oder eine bestimmte Wortgruppe enthalten, verwenden Sie das Feld Filter. Bei „contains-test“ wird die Groß-/Kleinschreibung nicht berücksichtigt.

    Wenn Sie mehrere Filter hinzufügen, werden nur Protokolle angezeigt, die allen Filtern entsprechen, da zwischen benachbarten Filtern ein impliziter AND eingefügt wird. Sie können jedoch einen OR-Operator explizit einfügen:

    • Wenn Sie beispielsweise die Filter Get und Compute hinzufügen, werden Logeinträge angezeigt, die beide Wörter enthalten.

    • Wenn Sie beispielsweise die Filter Get, OR und Compute hinzufügen, werden Logeinträge angezeigt, die Get oder Compute enthalten.

    Der Wert des Felds Filter wird nicht beibehalten.

  • Wenn Sie einen dauerhaften Filter anwenden möchten, ändern Sie die im Feld Abfrageeditor gespeicherte Abfrage und wählen Sie dann Filter anwenden aus. Informationen zur Abfragesyntax finden Sie unter Logging-Abfragesprache.

    Wenn Sie beispielsweise nur die Logeinträge mit einem MESSAGE-Feld anzeigen möchten, dessen Wert den String „lamp“ enthält, fügen Sie die Klausel jsonPayload.MESSAGE:"lamp" in das Feld Abfrageeditor ein.

Logeinträge im Log-Explorer abfragen

Widgets im Bereich „Protokolle“ zeigen Schlüsselfelder von Logeinträgen an, aber nicht den vollständigen Logeintrag. So prüfen Sie alle Felder eines Logeintrags:

  1. Wählen Sie im Logbereich-Widget die Option Im Log-Explorer aufrufen aus.

  2. Wählen Sie im Dialogfeld das Google Cloud-Projekt aus, in dem der Logs Explorer geöffnet werden soll.

    Der Log-Explorer wird in einem neuen Browsertab geöffnet und die im Widget für den Logbereich ausgewählten Filter werden automatisch angewendet.

  3. Wählen Sie den Logeintrag aus, den Sie sich ansehen möchten.

Diagramme anzeigen, die aus einer Log Analytics-Abfrage generiert wurden

In diesem Abschnitt wird beschrieben, wie Sie ein Diagramm konfigurieren und in einem benutzerdefinierten Dashboard speichern, das aus einer Log Analytics-Abfrage generiert wurde. Mit Log Analytics können Sie Logs mithilfe von SQL-Abfragen durchsuchen und aggregieren, um nützliche Informationen zu generieren.

Sie können Log Analytics-Diagramme nicht nur auf der Log Analytics-Seite konfigurieren und in einem Dashboard speichern, sondern auch direkt in Monitoring. Gehen Sie dazu so vor:

  1. Rufen Sie in der Google Cloud Console die Seite Dashboards auf.

    Dashboards aufrufen

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

  2. Wählen Sie ein Dashboard aus oder klicken Sie auf Dashboard erstellen.
  3. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.
  4. Gehen Sie im Dialogfeld Widget hinzufügen zum Bereich Daten und wählen Sie Log Analytics aus.

  5. Konfigurieren Sie im Bereich Widget konfigurieren die anzuzeigenden Daten und klicken Sie dann auf Abfrage ausführen.

    Sie können eine SQL-Abfrage erstellen oder eine gespeicherte oder letzte Abfrage auswählen, um die anzuzeigenden Daten auszuwählen.

  6. Optional: Passen Sie auf dem Tab Ergebnisse die Diagrammkonfiguration im Bereich Darstellung an.

    Im Bereich Darstellung können Sie den Diagrammtyp ändern und festlegen, welche Zeilen und Spalten dargestellt werden sollen. Dazu ändern Sie die Dimension, den Messwert und die Aufschlüsselung:

    • Dimension: Die Dimension muss eine Zeitstempel-, numerische oder String-Spalte sein. Standardmäßig ist die Dimension auf die erste zeitstempelbasierte Spalte im Schema festgelegt. Wenn in der Abfrage kein Zeitstempel vorhanden ist, wird die erste Stringspalte als Dimension ausgewählt. Sie können die Dimension auch im Bereich Diagrammdarstellung anpassen. Wenn eine Zeitstempelspalte als Dimension ausgewählt ist, zeigt das Diagramm, wie sich die Daten im Zeitverlauf ändern.

    • Messwert: Im Bereich Diagrammansicht können Sie mehrere Messwerte auswählen. Wenn Sie einen Messwert auswählen, müssen Sie auch die Aggregationsfunktion auswählen, die auf die gruppierten Werte angewendet werden soll, z. B. count, sum, average und percentile-99. count-distinct gibt beispielsweise die Anzahl der eindeutigen Werte in einer bestimmten Spalte zurück.

    • Aufschlüsselung: Wenn Sie eine einzelne Datenreihe anhand einer anderen Spalte in mehrere Datenreihen aufteilen möchten, fügen Sie eine Aufschlüsselung hinzu.

    Weitere Informationen zum Anpassen der Diagrammkonfiguration finden Sie unter Diagrammkonfiguration anpassen.

  7. Klicken Sie in der Symbolleiste auf Speichern, um das geänderte Dashboard zu speichern.

Log Analytics-Diagramme können auch nach dem Speichern in einem Dashboard bearbeitet werden. Weitere Informationen finden Sie unter Konfiguration eines Widgets ändern.

Fehler in einem Dashboard anzeigen

In diesem Abschnitt wird beschrieben, wie Sie mit der Google Cloud Console einen Bereich für Fehlerberichte hinzufügen und konfigurieren. Informationen zum Hinzufügen eines Bereichs für Fehlerberichte zu einem Dashboard mithilfe der Cloud Monitoring API finden Sie unter Dashboard mit einem ErrorReportingPanel-Widget.

So fügen Sie dem Dashboard über die Console einen Bereich für Fehlerberichte hinzu:

  1. Rufen Sie in der Google Cloud Console die Seite Dashboards auf.

    Dashboards aufrufen

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

  2. Wählen Sie ein Dashboard aus oder klicken Sie auf Dashboard erstellen.
  3. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.
  4. Gehen Sie im Dialogfeld Widget hinzufügen zum Bereich Visualisierung und wählen Sie dann Bereich „Fehlerberichte“ aus.
  5. Wählen Sie das Projekt aus, dessen Fehlergruppen angezeigt werden sollen, maximieren Sie Projekte und treffen Sie eine Auswahl.
  6. Optional: Aktualisieren Sie den Titel.

  7. Optional: So beschränken Sie die Ressourcen, für die Fehler angezeigt werden:

    1. Maximieren Sie Alle Ressourcen und wählen Sie eine Ressource aus.

    2. Nachdem Sie eine Ressource ausgewählt haben, können Sie Übernehmen auswählen oder die Filterkriterien mithilfe der zusätzlichen Menüs eingrenzen:

      • Wenn Sie Fehler für App Engine-Ressourcen sehen möchten, wählen Sie GAE-Dienste aus und klicken Sie dann auf Übernehmen.

      • Wenn Sie Fehler für einen bestimmten App Engine-Dienst anzeigen möchten, wählen Sie GAE-Dienste aus, wählen Sie den Dienst aus und klicken Sie dann auf Übernehmen.

  8. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

    Das folgende Beispiel zeigt einen Bereich für die Fehlermeldung:

    Beispiel für den Konfigurationsbereich eines Bereichs für Fehlerberichte.

  9. Klicken Sie in der Symbolleiste auf Speichern, um das geänderte Dashboard zu speichern.

Fehlerbehebung

Nächste Schritte