Logs 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. Widget für den Logbereich zeigt Logeinträge an. Das Widget für den Bereich für Fehlerberichte zeigt die neuesten Fehlergruppen an. 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 das LogsPanel-Widget

Der Log-Explorer ist die Standardmethode zur Untersuchung 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 Widget für das Logfeld unterstützen die dieselbe Abfragesprache haben und in beiden werden nur die Logeinträge, für die Sie die Berechtigung zum Anzeigen haben. Ihr IAM-Rollen (Identity and Access Management) für die Ressourcen, auf denen die Logeinträge gespeichert werden Bestimmen Sie, ob Sie die gespeicherten Logeinträge ansehen können.

Der Log-Explorer und das Widget für das Log-Steuerfeld sind so vorkonfiguriert, Ressourcen suchen, die im standardmäßigen Logbereich aufgeführt sind für Logeinträge. 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 wird, enthalten die Suchergebnisse die Logeinträge, die über eine Senke an das Projekt weitergeleitet werden in einem anderen Projekt und wird dann in einem Log-Bucket gespeichert. Sie können konfigurieren, nach welchen Ressourcen nach Logeinträgen gesucht wird. Beispiel: Sie können in der Logansicht nach Logeinträgen suchen.

Widgets für das Logfeld zeigen einen Logeintrag pro Zeile, mit Spalten für Schweregrad, Zeitstempel und Zusammenfassung des Logeintrags. So rufen Sie die Darstellung eines Logs im JSON-Format auf: auf die Schaltfläche Logdetails anzeigen. Die Struktur der einzelnen Eintragszusammenfassungen variiert je nach Logtyp. Beispiel: Die folgende Abbildung zeigt zwei Logeinträge:

Ein Bild von zwei Logeinträgen im Logbereich-Widget.

In der vorherigen Abbildung wird der erste Logeintrag Informationen über eine Dienstleistungsanfrage. Die Zusammenfassung enthält Informationen zu den Service, eine E-Mail-Adresse und eine als Zeichenfolge formatierte Version der JSON-Struktur für den Eintrag. Der zweite Eintrag zeigt die Ergebnisse einer Anfrage an und zeigt nur einen Satz, der die aufgetretene Handlung zusammenfasst.

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

Hinweise

Um die Berechtigungen zu erhalten, die Sie zum Hinzufügen eines Logfeld-Widgets zu einem benutzerdefinierten Dashboard mithilfe von und die Anzeige von Logeinträgen in Projekten zu konfigurieren, oder in Log-Ansichten bitten Sie Ihren Administrator, Ihnen folgenden IAM-Rollen:

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 zum Verwenden 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 Konsole 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, nach welchen Ressourcen nach Logeinträgen gesucht wird:

    • Wenn Sie nach Projekt suchen möchten, setzen Sie den Eintrag Scope by (Bereich nach) auf Project (Projekt). Maximieren Sie dann den Eintrag Projekte und füllen Sie das Dialogfeld aus.

      Im Menü Projekte werden alle Google Cloud-Projekte in der aktuellen des Messwertbereichs. Wenn ein Menüeintrag den Text "Sie haben keine Berechtigung auf Projektebene zum Ansehen von Logs in diesem Projekt", haben Sie nicht die erforderlichen Berechtigungen, Logeinträge, die in diesem Google Cloud-Projekt verfügbar sind.

      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.

    • So suchen Sie anhand von Logansichten nach Logeinträgen für Log-Buckets: Setzen Sie den Eintrag Bereich nach auf Speicher und wählen Sie Maximieren Sie den Eintrag Speicheransichten und füllen Sie das Dialogfeld aus.

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

      So wählen Sie Logansichten für Log-Buckets aus in anderen Google Cloud-Projekten Klicken Sie auf Projekt importieren. Wählen Sie ein Projekt und dann eine oder mehrere Logansichten aus. Du kannst nur Projekte importieren die im aktuellen Messwertbereich enthalten 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.

      Logbereiche befinden sich in der öffentlichen Vorschau.

  7. Optional: So legen Sie fest, welche Protokolle im Log-Steuerfeld-Widget angezeigt werden: in das Feld Abfrageeditor eine Abfrage ein. Wenn Sie und klicken Sie auf Abfrage ausführen. Eine kurze Einführung in Abfragen finden Sie unter Abfragebeispiele

  8. Optional: Wenden Sie Vorlagenvariablen auf das Widget des Logbereichs an. Weitere Informationen finden Sie unter Permanenten Filter auf ein Widget anwenden.

  9. Klicken Sie in der Symbolleiste auf Klicken Sie auf Übernehmen. 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 Filtern Sie die Logeinträge.

Beispielabfragen

Um das Feld Abfrageeditor zu füllen, können Sie Text in das Feld oder eine Auswahl in den Menüs treffen. Den Abfrageeditor verwendet dieselbe Abfragesprache wie Log-Explorer: Informationen zur Fehlerbehebung Siehe Probleme mit der Syntax.

In den Menüs Schweregrad und Logname können Sie mehrere Optionen auswählen. Im Folgenden finden Sie ein Beispiel für eine Abfrageanweisung, die mehreren Schweregrade:

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

Im Menü Ressource können Sie nach Ressource filtern. Zur Auswahl stehen wie z. B. Geprüfte Ressource. Alternativ können Sie um eine bestimmte Methode auszuwählen.

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

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

  3. Klicken Sie auf Anwenden.

    Mit diesen Schritten wird dem Abfrageeditor die folgende Klausel hinzugefügt. ein:

    resource.type="audited_resource"

Um eine Abfrage für Audit-Logs zu Cloud Run-Funktionen hinzuzufügen, Folgendes:

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

  4. Klicken Sie auf Anwenden.

    Mit diesen Schritten wird dem Abfrageeditor die folgende Klausel hinzugefügt. ein:

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

Logeinträge filtern

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

  • Dashboard-Zeitauswahl: Das Widget für das Logfeld ruft nur Daten ab, Logeinträge, die in dem in diesem Feld angegebenen Intervall geschrieben werden.

  • Filter im Widget für das Logfeld: Der angegebene Filter wird angewendet nachdem die Abfrage abgeschlossen ist. Der Wert dieses Feldes wird nur für das Feld aktuellen Sitzung.

  • Menü Schweregrad im Widget des Logbereichs: nach Schweregrad filtern wird nach Abschluss der Abfrage angewendet. Der Wert dieses Felds wird nur für die aktuelle Sitzung beibehalten.

  • Abfrage im Widget für das Logfeld: Das Widget für das Logfeld zeigt nur Logeinträge anzeigen, die mit der Abfrage übereinstimmen. Wenn Sie keine Abfrage angeben, ausgewähltes Zeitintervall angezeigt. Wenn Sie eine Abfrage angeben, Im Log-Steuerfeld-Widget wird Abfrage anzeigen angezeigt. , das die aktuelle Abfrage als Kurzinfo anzeigt.

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

  • Google Cloud-Projekt im Widget für das Logfeld: So ändern Sie diese Einstellung: Widget für das Logfeld bearbeiten

  • Dashboard-Filter: Wenn Dashboard-Filter vorhanden sind, wird die Filtereinstellung auf die Abfrage des Widgets „Logbereich“ angewendet. Wenn Sie beispielsweise das Tag Dashboardfilter cluster_name: mycluster enthält, lautet die Abfrage: aktualisiert, um resource.labels."cluster_name"="mycluster" einzuschließen. Weitere Informationen zu Dashboard-Filtern 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 1H aus. Wenn Sie keinen benutzerdefinierten Zeitraum auswählen, zeigt das Widget immer die neuesten Protokolle an, auch wenn diese die älter als das ausgewählte Zeitfenster sind.

Wenn Sie einen Vorfall untersuchen, sollten Sie Logeinträge zu Einträgen in einem bestimmten Zeitintervall. Bis Log-Einträge in einem festen Zeitintervall anzeigen, Führen Sie einen oder beide der folgenden Schritte aus:

  • Wählen Sie mit der entsprechenden Auswahl einen Zeitraum aus.
  • Geben Sie eine timestamp-Klausel in das Feld Abfrageeditor des Konfigurationsbereich auf und wählen Sie 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. Sie können ein Logfeld-Widget so konfigurieren, dass nur die Logeinträge angezeigt werden, die bestimmte Schweregrade haben, führen Sie einen oder beide der folgenden Schritte aus:

  • Um einen temporären Filter anzuwenden, wählen Sie einen Wert aus dem Menü Schweregrad in das Logfeld-Widget. 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.

  • Um einen dauerhaften Filter anzuwenden, geben Sie eine severity-Klausel in die Query Editor (Abfrageeditor) des Konfigurationsbereichs. und wählen Sie dann Filter anwenden aus.

Beispiel: Logeinträge nach einem String oder einer Wortgruppe filtern

Wenn Sie Logeinträge nach einem bestimmten String oder einer bestimmten Wortgruppe filtern, können Sie Logeinträge anzeigen, die für Sie uninteressant sind. Wenn Sie z. B. Logeinträge ansehen möchten, die eine bestimmte E-Mail-Adresse enthalten, können Sie danach 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 Logs angezeigt, die mit allen Filtern übereinstimmen da ein implizites AND zwischen benachbarten Filtern 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 die beide Wörter enthalten.

    • Wenn Sie beispielsweise die Filter Get, OR und Compute hinzufügen, wird Folgendes erfasst: Es werden Einträge angezeigt, die Get oder Compute enthalten.

    Der Wert des -Felds Filter ist nicht dauerhaft.

  • Um einen dauerhaften Filter anzuwenden, ändern Sie die Abfrage, die in der Abfrageeditor 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 Filter, die Sie die im Logfeld-Widget ausgewählt sind, werden automatisch angewendet.

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

Aus einer Log Analytics-Abfrage generierte Diagramme anzeigen

In diesem Abschnitt wird beschrieben, wie Sie ein aus einem Log Analytics-Abfrage in einem benutzerdefinierten Dashboard. Mit Loganalysen können Sie Logs durchsuchen und aggregieren, um mithilfe von SQL-Abfragen nützliche Informationen zu gewinnen.

Neben der Verwendung der Seite „Loganalysen“ zum Konfigurieren und Speichern von Diagrammen in Dashboard verwenden, können Sie ein Log-Analytics-Diagramm 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 Abschnitt Daten und Wählen Sie dann Loganalysen aus.
  5. Konfigurieren Sie im Bereich Widget konfigurieren die Daten, die im Diagramm angezeigt werden sollen. Erstellen Sie dazu eine SQL-Abfrage und klicken Sie dann auf Abfrage ausführen.

  6. Optional: Passen Sie auf dem Tab Ergebnisse die Diagrammkonfiguration an, indem Sie über das Display-Steuerfeld.

    Im Steuerfeld Anzeige können Sie den Diagrammtyp ändern und festlegen, Zeilen und Spalten im Diagramm darstellen, indem Sie die Dimension, 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. Wenn in der Abfrage kein Zeitstempel vorhanden ist, erste Stringspalte als Dimension ausgewählt. Sie können auch den Inhalt der Dimension anpassen. im Bereich Diagrammanzeige. Wenn eine Zeitstempelspalte als Dimension ausgewählt ist, wie sich Daten im Laufe der Zeit ändern.

    • Messen: Sie können im Steuerfeld Diagrammanzeige mehrere Messwerte auswählen. Wenn Sie eine Messung auswählen, muss auch die Aggregationsfunktion auswählen, die für ihre gruppierten Werte ausgeführt 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 auf einem Dashboard anzeigen

In diesem Abschnitt wird beschrieben, wie Sie mithilfe von in der Google Cloud Console. Informationen zum Hinzufügen eines Bereichs für Fehlerberichte zu einem Dashboard mit 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 Abschnitt Visualisierung. und wählen Sie Error Reporting-Bereich 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. Alternativ können Sie können Sie die Filterkriterien mithilfe der zusätzlichen Menüs verfeinern:

      • Um Fehler für App Engine-Ressourcen anzuzeigen, wählen Sie GAE-Dienste und klicken Sie dann auf Anwenden.

      • Um Fehler für einen bestimmten App Engine-Dienst anzuzeigen, wählen Sie GAE-Dienste, wählen Sie den Dienst aus und klicken Sie dann auf Anwenden.

  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 Fehlerberichte:

    Beispiel für den Konfigurationsbereich eines Error Reporting-Bereichs

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

Fehlerbehebung

Nächste Schritte