Logs und Fehler in einem benutzerdefinierten Dashboard anzeigen

In diesem Dokument werden die Widgets beschrieben, die Sie Ihren benutzerdefinierten Dashboards hinzufügen können So können Sie Ihre Protokoll- und Fehlerdaten im selben Kontext wie Ihre metrischen Daten. Widget für den Logbereich zeigt Logeinträge an. Das Widget für den Bereich für Fehlerberichte zeigt die neuesten Fehlergruppen an. Beides enthalten Informationen, die bei der Fehlerbehebung hilfreich sein können. Loganalysen-Diagramm-Widget die die Ergebnisse einer SQL-Abfrage anzeigt, können Sie Trends in Ihren Protokolldaten erkennen.

Log-Explorer und das Widget für das Logfeld

Der Log-Explorer ist die Standardmethode zur Untersuchung von Logs. Das Hinzufügen eines Widgets für den Logbereich zu einem Dashboard wirkt sich nicht auf die Verwendung aus Log-Explorer. Da Widgets für das Logfeld benutzerdefinierte Dashboards Logeinträge im selben Kontext wie Messwerte ansehen.

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 abgerufen werden, wird ermittelt, ob Sie diese Logeinträge einsehen können.

Der Log-Explorer und das Widget für das Log-Steuerfeld sind so vorkonfiguriert, Aus Log-Buckets die Log-Einträge aus den aktuellen Google Cloud-Projekt oder die an Ihr aktuelles Projekt weitergeleitet werden. Sie können konfigurieren, welche Logeinträge abgerufen werden sollen. So können Sie zum Beispiel Sie legen fest, dass Logeinträge aus einer Logansicht abgerufen werden.

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:

Abbildung von zwei Logeinträgen im Widget für das Logfeld

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 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 in der Google Cloud Console. Informationen zum Verwenden der Cloud Monitoring API finden Sie unter Dashboard mit einem LogsPanel-Widget.

Ein Widget für das Logfeld ist vorkonfiguriert, um Logeinträge abzurufen, die aus Ihrem Google Cloud-Projekt stammen, und in denjenigen, die an Ihre Google Cloud-Projekt Sie können jedoch festlegen, Das Logbereich-Widget ruft Daten aus Log-Buckets ab. Zum Beispiel könnten Sie Widget so konfigurieren, dass nur Logeinträge angezeigt werden die auf eine Art von Fehlerbedingung oder nur auf diese Logeinträge in eine Logansicht.

Ein Dashboard kann maximal 40 Widgets enthalten.

So fügen Sie dem Dashboard über die Console ein Logfeld-Widget hinzu: Gehen Sie 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. Wählen Sie im Dialogfeld Widget hinzufügen die Option  Protokolle aus.
  5. Optional: Um den Titel zu aktualisieren, geben Sie den neuen Titel in das Feld Widget-Titel:

  6. Optional: So legen Sie fest, welche Logeinträge abgerufen werden: Führen Sie einen der folgenden Schritte aus:

    • So rufen Sie Logeinträge aus einem anderen Projekt oder aus mehreren im Eintrag Project (Projekt) Maximieren Sie Aktuelles Projekt und schließen Sie den Dialogfeld. Im Menü werden alle Google Cloud-Projekte aufgelistet im aktuellen Messwertbereich.

      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 für das Google Cloud-Projekt.

    • So rufen Sie Logeinträge aus Logansichten ab: Gehen Sie für Log-Buckets so vor:

      1. Maximieren Sie im Eintrag Scope by (Bereich nach) Project (Projekt). und wählen Sie dann Speicher aus.
      2. Maximieren Sie im Eintrag Storage-Ansichten die Ansicht. Aktuelles Projekt und füllen Sie das Dialogfeld aus. Das Menü listet Logansichten zu Log-Buckets in Ihr Google Cloud-Projekt. 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.

  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 Dauerhafte Filter zu einem benutzerdefinierten Dashboard hinzufügen

  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.

    Das Widget für das Logfeld zeigt eine Tabelle des abgerufenen Protokolls an. die auch Ihrer Suchanfrage entsprechen. Sie können auch den Filter des Widgets um die vom Widget angezeigten Logeinträge vorübergehend zu ä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 mit 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 Cloud Functions-Audit-Logs hinzuzufügen, müssen Sie 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 Feldes wird beibehalten nur für die aktuelle Sitzung.

  • 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 für das Logfeld.

  • 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 wird auf die Abfrage des Widgets für das Logfeld 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 weiteren Verlauf dieses Abschnitts erhalten Sie weitere Informationen dazu, wie Sie Ihre Logeinträge filtern.

Beispiel: Logeinträge nach Datum filtern

Verwenden Sie die Zeitfelder, um die neuesten Logs in einem Widget des Logbereichs anzuzeigen 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 der Konfigurationsbereich auf und wählen Sie Filter anwenden aus.

Wenn Sie ein Zeitintervall angeben, wird das Widget für das Logfeld 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 beim Navigieren verworfen. vom Dashboard entfernt.

  • 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 haben jedoch kann explizit einen OR-Operator 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 für das Logfeld zeigen wichtige Felder von Logeinträgen, nicht die einen vollständigen Logeintrag. So prüfen Sie alle Felder eines Logeintrags:

  1. Wählen Sie im Widget für das Log-Steuerfeld die Option Im Log-Explorer ansehen aus.

  2. Wählen Sie im Dialogfeld das Google Cloud-Projekt aus, in dem Sie es öffnen möchten Log-Explorer.

    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 indem Sie mit SQL eine Abfrage erstellen. 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 ist. 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. Beispielsweise gibt count-distinct 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 bearbeitet werden, nachdem sie in einem Dashboard gespeichert wurden. Weitere Informationen finden Sie unter Konfiguration eines Widgets ändern

Fehler in einem Dashboard anzeigen

In diesem Abschnitt wird beschrieben, wie Sie mithilfe von in der Google Cloud Console. Weitere Informationen zum Hinzufügen Fehlerberichtsbereich mit der Cloud Monitoring API zu einem Dashboard hinzufügen, 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 schränken Sie die Ressourcen ein, für die Fehler angezeigt werden: Gehen Sie so vor:

    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 Klicken Sie auf Übernehmen. 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