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 Log- und Fehlerdaten im selben Kontext wie Ihre Messwertdaten ansehen können. Im Widget „Logfeld“ werden Logeinträge angezeigt. 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 Diagramm-Widget für Loganalysen, in dem die Ergebnisse einer SQL-Abfrage angezeigt werden, können Sie Trends in Ihren Logdaten erkennen.

Log-Explorer und das Widget für das Logfeld

Der Log-Explorer ist die Standardmethode zur Untersuchung von Logs. Wenn Sie einem Dashboard ein Widget für den Logbereich hinzufügen, ändert sich an der Verwendung des Log-Explorers nichts. Da Widgets für das Logfeld benutzerdefinierten Dashboards hinzugefügt werden können, bieten sie eine Möglichkeit, Logeinträge im selben Kontext wie Messwerte anzusehen.

Der Log-Explorer und das Widget für das Log-Steuerfeld unterstützen dieselbe Abfragesprache und zeigen in beiden nur die Logeinträge an, für die Sie die entsprechende Berechtigung haben. Ihre IAM-Rollen (Identity and Access Management) für die Ressourcen, in denen die abgerufenen Logeinträge gespeichert werden, bestimmen, ob Sie diese Logeinträge ansehen können.

Sowohl der Log-Explorer als auch das Widget für das Log-Steuerfeld sind so vorkonfiguriert, dass aus Log-Buckets die Logeinträge aus Ihrem aktuellen Google Cloud-Projekt oder aus Ihrem aktuellen Projekt abgerufen werden. Sie können konfigurieren, welche Logeinträge abgerufen werden sollen. Sie können beispielsweise festlegen, dass Logeinträge aus einer Logansicht abgerufen werden.

Widgets für das Logfeld zeigen einen Logeintrag pro Zeile mit Spalten für den Schweregrad, den Zeitstempel und eine Zusammenfassung des Logeintrags an. Klicken Sie auf die Schaltfläche Logdetails anzeigen, um einen Logeintrag im JSON-Format anzuzeigen. Die Struktur der einzelnen Eintragszusammenfassungen variiert je nach Logtyp. Die folgende Abbildung zeigt beispielsweise zwei Logeinträge:

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

In der vorherigen Abbildung 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 zeigt die Ergebnisse einer Anfrage an und enthält nur einen Satz, der die ausgeführte Aktion zusammenfasst.

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

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Hinzufügen eines Logbereichs-Widgets über die Google Cloud Console zu einem benutzerdefinierten Dashboard und zum Konfigurieren von Logeinträgen in Projekten oder Logansichten benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie 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 mithilfe der Google Cloud Console ein Logbereich-Widget hinzufügen und konfigurieren. Informationen zum Verwenden der Cloud Monitoring API finden Sie unter Dashboard mit einem LogsPanel-Widget.

Ein Logbereich-Widget ist vorkonfiguriert, um Logeinträge abzurufen, die aus Ihrem Google Cloud-Projekt stammen und die an Ihr Google Cloud-Projekt weitergeleitet werden. Sie können jedoch festlegen, welche Logeinträge das Widget im Logbereich aus Log-Buckets abrufen soll. Beispielsweise können Sie das Widget so konfigurieren, dass in einer Logansicht nur Logeinträge angezeigt werden, die auf eine Art von Fehlerbedingung hinweisen.

Ein Dashboard kann maximal 40 Widgets enthalten.

So fügen Sie dem Dashboard über die Console ein Logfeld-Widget hinzu:

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

    Zu Dashboards

    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: Geben Sie den neuen Titel in das Feld Widget-Titel ein, um den Titel zu aktualisieren.

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

    • Wenn Sie Logeinträge aus einem anderen Projekt oder aus mehreren Projekten abrufen möchten, maximieren Sie im Eintrag Projekt die Option Aktuelles Projekt und schließen Sie das Dialogfeld ab. Im Menü werden alle Google Cloud-Projekte im aktuellen Messwertbereich aufgelistet.

      Wenn ein Menüeintrag den Text „Sie haben keine Berechtigung auf Projektebene zum Ansehen von Logs in diesem Projekt“ enthält, sind Sie nicht berechtigt, Logeinträge für das Google Cloud-Projekt anzusehen.

    • So rufen Sie Logeinträge ab, die in Logansichten von Log-Buckets enthalten sind:

      1. Maximieren Sie im Eintrag Bereich nach die Option Projekt und wählen Sie dann Speicher aus.
      2. Maximieren Sie im Eintrag Speicheransichten Aktuelles Projekt und füllen Sie das Dialogfeld aus. Im Menü werden die Logansichten von Log-Buckets in Ihrem Google Cloud-Projekt aufgelistet. Klicken Sie zum Auswählen von Logansichten für Log-Buckets in anderen Google Cloud-Projekten im Menü auf Projekt importieren, wählen Sie ein Projekt und dann eine oder mehrere Logansichten aus. Sie können nur Projekte importieren, die im aktuellen Messwertbereich enthalten sind.

  7. Optional: Wenn Sie einschränken möchten, welche Logs im Widget „Logs“ angezeigt werden, geben Sie in das Feld Abfrageeditor eine Abfrage ein. Wenn Sie die automatische Ausführung von Abfragen deaktiviert haben, 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 Übernehmen, um die Änderungen für das Dashboard zu ü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 der abgerufenen Logeinträge an, die auch Ihrer Abfrage entsprechen. Sie können auch die Filterleiste des Widgets verwenden, um vorübergehend die Logeinträge zu ändern, die vom Widget angezeigt werden. Weitere Informationen finden Sie im Abschnitt Logeinträge filtern.

Beispielabfragen

Zum Füllen des Felds Query Editor (Abfrageeditor) können Sie Text in das Feld eingeben oder eine Auswahl über Menüs treffen. Im Feld Abfrageeditor wird dieselbe Abfragesprache wie im Log-Explorer verwendet. Informationen zur Fehlerbehebung finden Sie unter Syntaxprobleme.

In den Menüs Schweregrad und Logname können Sie mehrere Optionen auswählen. Das folgende Beispiel zeigt eine Abfrageanweisung, die mehreren Schweregraden entspricht:

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

Im Menü Ressource können Sie nach Ressource filtern. Sie können einen Ressourcentyp wie Geprüfte Ressource auswählen oder durch die Fenster eine bestimmte Methode auswä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 Feld Abfrageeditor die folgende Klausel hinzugefügt:

    resource.type="audited_resource"

So fügen Sie eine Abfrage für Cloud Functions-Audit-Logs hinzu:

  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 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 Widget im Logbereich angezeigt werden. Dazu ändern Sie die Werte der folgenden Felder oder Menüs:

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

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

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

  • Abfrage im Widget für das Logfeld: Im Widget für das Logfeld werden nur die Logeinträge angezeigt, die mit der Abfrage übereinstimmen. Wenn Sie keine Abfrage angeben, werden alle Logs im ausgewählten Zeitintervall angezeigt. Wenn Sie eine Abfrage angeben, zeigt das Widget im Logbereich das Symbol Abfrage anzeigen an, 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: Wenn Sie diese Einstellung ändern möchten, bearbeiten Sie das Widget für das Logfeld.

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

Der Rest dieses Abschnitts enthält zusätzliche Informationen zum Filtern Ihrer Logeinträge.

Beispiel: Logeinträge nach Datum filtern

Verwenden Sie die Zeitfelder in der Dashboard-Symbolleiste, um die neuesten Logs in einem Widget des Logbereichs anzuzeigen. Wählen Sie beispielsweise 1H aus. Sofern Sie keinen benutzerdefinierten Zeitraum auswählen, zeigt das Widget immer die neuesten Logs an, auch wenn sie älter als das ausgewählte Zeitfenster sind.

Wenn Sie einen Vorfall untersuchen, möchten Sie die Logeinträge möglicherweise auf Einträge in einem bestimmten Zeitintervall beschränken. Führen Sie einen oder beide der folgenden Schritte aus, damit die Logeinträge angezeigt werden, die sich in einem festen Zeitintervall befinden:

  • Wählen Sie mit der entsprechenden Auswahl einen Zeitraum aus.
  • Geben Sie im Konfigurationsbereich im Feld Abfrageeditor eine timestamp-Klausel ein und wählen Sie dann Filter anwenden aus.

Wenn Sie ein Zeitintervall angeben, wird das Widget für den 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 Logfeld-Widget so zu konfigurieren, dass nur Logeinträge angezeigt werden, die bestimmten Schweregraden entsprechen:

  • Wählen Sie im Widget für das Logfeld im Menü Schweregrad einen Wert 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 Konfigurationsbereich im Feld Abfrageeditor eine severity-Klausel ein und wählen 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 uninteressante Logeinträge aus der Ansicht ausschließen. Wenn Sie beispielsweise Logeinträge aufrufen möchten, die eine bestimmte E-Mail-Adresse enthalten, 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 Logs angezeigt, die mit allen Filtern übereinstimmen, da zwischen benachbarten Filtern ein implizites AND eingefügt wird. Sie können jedoch explizit einen OR-Operator 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 ist nicht dauerhaft.

  • 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 Logbereich enthalten nur die wichtigsten Felder von Logeinträgen, aber nicht den 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 der Log-Explorer geöffnet werden soll.

    Der Log-Explorer wird in einem neuen Browsertab geöffnet und die Filter, die Sie im Widget für das Log-Steuerfeld ausgewählt haben, 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 einer Loganalyse-Abfrage generiertes Diagramm konfigurieren und in einem benutzerdefinierten Dashboard speichern. Mit Log Analytics können Sie Logs durchsuchen und aggregieren, um mithilfe von SQL-Abfragen nützliche Informationen zu gewinnen.

Sie können die Seite „Loganalysen“ nicht nur zum Konfigurieren und Speichern von Diagrammen in einem Dashboard verwenden, sondern auch direkt in Monitoring. Gehen Sie dazu so vor:

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

    Zu Dashboards

    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. Wechseln Sie im Dialogfeld Widget hinzufügen zum Abschnitt Daten und wählen Sie Loganalysen aus.
  5. Konfigurieren Sie im Bereich Widget konfigurieren die Daten, die im Diagramm angezeigt werden sollen. Erstellen Sie dazu eine Abfrage mit SQL und klicken Sie dann auf Abfrage ausführen.

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

    Im Steuerfeld Anzeige können Sie den Diagrammtyp ändern und festlegen, welche Zeilen und Spalten im Diagramm dargestellt werden. Ändern Sie dazu 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 die Abfrage keinen Zeitstempel enthält, wird die erste Stringspalte als Dimension ausgewählt. Sie können die Dimension auch im Bereich Diagrammanzeige anpassen. Wenn eine Zeitstempelspalte als Dimension ausgewählt ist, zeigt das Diagramm, wie sich die Daten im Laufe der Zeit ändern.

    • Messung: Sie können im Steuerfeld Diagrammanzeige mehrere Messwerte auswählen. Wenn Sie eine Messung auswählen, müssen Sie auch die Aggregationsfunktion auswählen, die für die 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: Um eine einzelne Datenreihe anhand einer anderen Spalte in mehrere Datenreihen aufzuteilen, 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 der Google Cloud Console einen Bereich für Fehlerberichte hinzufügen und konfigurieren. Informationen zum Hinzufügen eines Fehlerberichtsbereichs 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.

    Zu Dashboards

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

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

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

      • Wenn Fehler für App Engine-Ressourcen angezeigt werden sollen, wählen Sie GAE-Dienste aus und klicken Sie dann auf Anwenden.

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

  8. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen für das Dashboard zu ü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