Ereignisse in einem Dashboard anzeigen

In diesem Dokument wird beschrieben, wie Sie ein Dashboard so konfigurieren, dass Ereignishinweise angezeigt werden. Ein Ereignis ist eine Aktivität wie eine Bereitstellung oder ein Absturz, die sich auf den Betrieb eines Systems auswirkt. Wenn Sie Ereignisannotationen anzeigen, können Sie bei der Fehlerbehebung Daten aus verschiedenen Quellen leichter in Beziehung setzen.

Ereignisannotationen

Sie können Ereignisse in den meisten Dashboards anzeigen, die auf der Seite Dashboards der Google Cloud Console aufgeführt sind. Ebenso können Sie einige dienstspezifische Beobachtbarkeits-Tabs, z. B. für die Compute Engine und die Google Kubernetes Engine, so konfigurieren, dass Ereignisse angezeigt werden. In der Google Cloud Console können Sie die Ereignistypen konfigurieren, die in einem Dashboard oder auf dem Tab Observability angezeigt werden. Für von Ihnen erstellte Dashboards, die als benutzerdefinierte Dashboards klassifiziert sind, können Sie auch die Cloud Monitoring API verwenden.

Sofern Sie nicht die Cloud Monitoring API verwenden oder eine Aktion ausführen, um Ihre Auswahl der Ereignistypen zu speichern, gelten Ihre Auswahlen nur für die aktuelle Sitzung. Wenn Sie die Google Cloud Console verwenden, werden Ihre Auswahlen durch Anpinnen gespeichert.

Eine Liste der Ereignistypen, Referenzen zur Fehlerbehebung und weitere Informationen finden Sie auf der Seite Ereignistypen.

Möglicherweise sehen Sie die folgenden Ereignistypen auf einem Dashboard oder einem Tab Observability aktiviert, obwohl Sie keine Ereignistypen ausgewählt haben:

Wenn ein Ereignistyp automatisch hinzugefügt wird, handelt es sich um einen empfohlenen Ereignistyp. Sie können diese Ereignistypen im empfohlenen Status belassen, sie in der JSON-Datei des Dashboards speichern oder sie ablehnen, wodurch die Empfehlung entfernt wird. Welche Ereignistypen gespeichert werden, sehen Sie, wenn Sie das Menü Hinweise maximieren und dann den Bereich Angepinnt aufrufen.

Identifizierung von Ereignissen

In Dashboards werden verschiedene Datenquellen abgefragt, um die Ereignisse zu ermitteln, die im Dashboard angezeigt werden sollen:

  • Benachrichtigungsereignisse werden von Monitoring erkannt. Benachrichtigungsereignisse enthalten Informationen dazu, wann Vorfälle geöffnet wurden.

  • Personalized Service Health-Ereignisse werden anhand von Abfragen identifiziert, die Monitoring an die Service Health API sendet. Diese Ereignisse geben an, wann es zu einer Störung bei einem Google Cloud-Dienst kommt.

  • Alle anderen Ereignistypen werden durch Analysieren der Logeinträge ermittelt, die die Cloud Logging-Senke in Ihrem Google Cloud-Projekt passieren. Dazu gehören sowohl von Ihrem Projekt generierte als auch an Ihr Projekt weitergeleitete Logeinträge. Wenn Sie benachrichtigt werden möchten, wenn eines dieser Ereignisse eintritt, können Sie eine logbasierte Benachrichtigungsrichtlinie erstellen. Verwenden Sie in der Benachrichtigungsrichtlinie die Abfragen auf der Seite Ereignistypen.

Darstellung von Ereignissen

Sobald Ereignisse auftreten, werden die Diagramme in Ihrem Dashboard entsprechend kommentiert. Ereignisse, die durch die Analyse von Logeinträgen erkannt wurden, werden mit einer einzigen Zeitangabe angezeigt. Ereignisse zur Dienstbereitschaft werden dagegen mit einer Startzeit angezeigt. Der Hintergrund des Diagramms ändert sich dann für die Dauer des Ereignisses. Bei diesen Ereignissen wird auch ein Herzsymbol angezeigt.

Der folgende Screenshot zeigt ein Diagramm mit mehreren Ereignissen, die durch die Analyse von Protokolleinträgen ermittelt wurden, und einem Ereignis zur Dienstgesundheit:

Diagramm mit Anmerkungen zu Warn- und Informationsereignissen

Wie im vorherigen Screenshot dargestellt, enthält die Kurzinfo zu einem Ereignis Informationen wie die folgenden:

  • Ereignisname.
  • Datum und Startzeit der Veranstaltung.
  • Für Service Health-Ereignisse: Chips mit der Anzahl der betroffenen Produkte und Standorte. Wenn Sie die betroffenen Produkte oder Standorte auflisten möchten, bewegen Sie den Mauszeiger auf den entsprechenden Chip.
  • Die Schaltfläche Anzeigen, über die eine Seite mit weiteren Informationen zum Ereignis geöffnet wird. So kann beispielsweise der Log-Explorer geöffnet werden, damit Sie sich Logeinträge ansehen können, oder die Seite mit den Details für ein Ereignis zur Dienstbereitschaft.

Dashboard-Filter, mit denen die im Dashboard angezeigten Daten eingeschränkt werden, umfassen in der Regel sowohl Zeitreihendaten als auch Ereignisse.

Hinweise

  • Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen und Darstellen von Ereignissen in Dashboards und zum Erstellen von Benachrichtigungsrichtlinien benötigen:

    • Dashboards und Benachrichtigungsrichtlinien aufrufen und erstellen: Monitoring-Editor (roles/monitoring.editor).
    • Ereignisse ansehen und anzeigen, die aus Logeinträgen stammen, die nicht zum Datenzugriff gehören und in Ihrem Google Cloud-Projekt erstellt wurden: Loganzeige (roles/logging.viewer).
    • Ereignisse ansehen und anzeigen, die aus Logeinträgen in Ihrem Google Cloud-Projekt ermittelt wurden: Private Loganzeige (roles/logging.privateLogViewer).
    • Dienststatusereignisse ansehen: Personalized Service Health-Betrachter (roles/servicehealth.viewer)

    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.

  • Wenn Sie Service Health-Ereignisse in Ihrem Dashboard anzeigen möchten, aktivieren Sie die Service Health API:

    Enable the API

Ereignisse anzeigen

In diesem Abschnitt wird beschrieben, wie Sie ein Dashboard oder einen Tab Observability so konfigurieren, dass Ereignisse angezeigt werden.

Dashboards so konfigurieren, dass Ereignisse angezeigt werden

In diesem Abschnitt wird beschrieben, wie Sie Dashboards, die auf der Seite Dashboards der Google Cloud Console aufgeführt sind, so konfigurieren, dass Ereignisse angezeigt werden.

Eine Liste der Ereignistypen, Referenzen zur Fehlerbehebung und Abfragen, die mit dem Log Explorer oder mit logbasierten Benachrichtigungsrichtlinien verwendet werden können, finden Sie auf der Seite Ereignistypen.

Console

So rufen Sie Ereignisse in einem Dashboard auf:

  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 das Dashboard aus, das Sie sich ansehen möchten.
  3. Klicken Sie in der Symbolleiste des Dashboards auf  Hinweise und wählen Sie die Ereignistypen aus, die im Dashboard angezeigt werden sollen.

  4. Führen Sie einen der folgenden Schritte aus:

    • Wenn Sie Ihre Auswahl speichern möchten, damit Ereignisse angezeigt werden, wenn Sie das Dashboard neu laden, klicken Sie auf Auswahl anpinnen. Wenn Sie die automatische Speicherung in Ihrem Dashboard deaktiviert haben, klicken Sie in der Symbolleiste des Dashboards auf Speichern.

      Wenn Sie Ihre Auswahl anpinnen, ändern Sie die JSON-Definition des Dashboards. Wenn das Dashboard also wieder geöffnet wird, werden Ihre Auswahlen geladen und das Dashboard zeigt Anmerkungen zu den entsprechenden Ereignistypen an.

    • Wenn Sie die Ereignistypen nur für die aktuelle Sitzung anzeigen lassen möchten, klicken Sie auf Übernehmen.

    Nachdem Sie die Liste der anzuzeigenden Ereignistypen aktualisiert haben, werden in Cloud Monitoring Abfragen gestellt, was einige Zeit in Anspruch nimmt. Anschließend werden die Anmerkungen in die Diagramme auf dem Dashboard eingefügt.

  5. Wenn Sie eine Zusammenfassung eines Ereignisses aufrufen oder Links zu zusätzlichen Informationen aufrufen möchten, bewegen Sie den Mauszeiger auf die Kurzinfo.

API

Wenn Sie ein benutzerdefiniertes Dashboard so konfigurieren möchten, dass Ereignisse angezeigt werden, fügen Sie dem Objekt Dashboard ein annotations-Feld hinzu. Das Feld annotations enthält eine Instanz eines DashboardAnnotations-Objekts, das zwei Felder enthält:

  • Im Feld defaultResourceName sind die Standardeinstellungen auf Dashboardebene für die Google Cloud-Projekte aufgeführt, in denen nach Ereignissen gesucht werden soll. Wenn Sie dieses Feld nicht angeben, wird in Ihrem ausgewählten Projekt gesucht.

  • Ein Array von EventAnnotation-Objekten. Jedes Objekt enthält Folgendes:

    • Ein displayName-Feld, mit dem Sie das Label für die veranstaltungsspezifische Ein/Aus-Schaltfläche definieren können. Wenn dieses Feld nicht angegeben ist oder der Wert dieses Felds eine leere Zeichenfolge ist, wird der Standardname für das Ereignis angezeigt.
    • Ein enabled-Feld, das den Wert der Ein/Aus-Schaltfläche des Ereignisses steuert. Bei true ist die Ein/Aus-Schaltfläche in der Position on und Ereignisse werden im Dashboard angezeigt. Wenn false, ist der Schalter in der Position off.
    • Ein eventType-Feld, das einen Wert aus der Aufzählung EventType enthält.
    • Ein filter-Feld, mit dem Sie eine Abfrage angeben können, die an die ereignisspezifische Abfrage angehängt werden soll. Wenn der Wert dieses Felds ein leerer String ist, wird die ereignisspezifische Abfrage verwendet.
    • Ein resourceNames-Feld, mit dem Sie eine Liste von Google Cloud-Projekten definieren können, in denen nach Ereignissen gesucht werden soll. Wenn dieses Feld ein leeres Array ist, wird das ausgewählte Projekt durchsucht.

Im Folgenden sehen Sie ein Beispiel für ein annotations-Objekt für ein Clusteraktualisierungsereignis. Mit dem Feld filter in diesem Beispiel werden die Ereignisse auf einen bestimmten Cluster beschränkt:

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

Ausführliche Informationen zum Erstellen von Dashboards mit der Cloud Monitoring API finden Sie unter Dashboards mithilfe der API erstellen und verwalten und Beispiel: Ereignisse in Dashboards aktivieren.

Tab Beobachtbarkeit so konfigurieren, dass Ereignisse angezeigt werden

In diesem Abschnitt wird beschrieben, wie Sie den Tab Observability (Sichtbarkeit) so konfigurieren, dass Ereignisse angezeigt werden. Einige Dienste wie die Compute Engine und die Google Kubernetes Engine bieten den Tab Observability (Beobachtbarkeit), auf dem Mess- und Protokolldaten angezeigt werden.

Console

So konfigurieren Sie den Tab Beobachtbarkeit, damit Ereignisse angezeigt werden:

  1. Rufen Sie den Tab Beobachtbarkeit für einen Dienst oder ein Produkt auf.

    Sie können beispielsweise die Seite Kubernetes-Cluster aufrufen und dann den Tab Beobachtbarkeit auswählen. Ebenso können Sie die Seite Kubernetes Engine-Cluster oder die Detailseite einer VM-Instanz aufrufen und dann den Tab Beobachtbarkeit auswählen.

  2. Achten Sie darauf, dass im Menü Dashboard die Option Vordefinierte ausgewählt ist. Ereignisse können nicht in benutzerdefinierten Dashboards angezeigt werden.

  3. Klicken Sie in der Symbolleiste auf  Anmerkungen und füllen Sie das Dialogfeld aus.

    Nachdem Sie die Liste der anzuzeigenden Ereignisse aktualisiert haben, werden Abfragen zum Abrufen der Ereignisdaten ausgeführt und das Dashboard wird aktualisiert.

    Wenn das Menü Anmerkungen nicht angezeigt wird, kann der Tab nicht so konfiguriert werden, dass Ereignisse angezeigt werden.

API

Nicht verfügbar.

Termindetails ansehen

Wenn Sie ein Diagramm mit Ereignishinweisen aufrufen, können Sie über die Links in der Kurzinfo auf weitere Informationen zugreifen.

Klicken Sie auf Anzeigen, um Details zu einem bestimmten Ereignis aufzurufen.

Die Seite in der Google Cloud Console, die über die Schaltfläche Anzeigen geöffnet wird, hängt vom Ereignistyp ab. Beispielsweise wird bei einem Ereignis der Verfügbarkeitsdiagnose über diese Schaltfläche das Dashboard für die Verfügbarkeitsdiagnose geöffnet. Bei einem anderen Ereignistyp wird möglicherweise der Log-Explorer geöffnet.

Benachrichtigungsrichtlinien erstellen

Wenn Ereignisse durch die Analyse der Logeinträge identifiziert werden, die die Cloud Logging-Senke in Ihrem Google Cloud-Projekt passieren, können Sie sich benachrichtigen lassen, indem Sie eine logbasierte Benachrichtigung konfigurieren. Bei logbasierten Benachrichtigungsrichtlinien werden Ihre Logeinträge abgefragt, sobald sie empfangen werden. Wenn die Abfrage ein nicht leeres Ergebnis zurückgibt, wird ein Vorfall erstellt und Benachrichtigungen werden gesendet.

Console

So erstellen Sie eine logbasierte Benachrichtigung:

  1. Wenn Sie noch keinen Benachrichtigungskanal konfiguriert haben, gehen Sie so vor:

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

      Zu Benachrichtigungen

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

    2. Klicken Sie auf Benachrichtigungskanal bearbeiten.
    3. Rufen Sie den Benachrichtigungskanaltyp auf, den Sie konfigurieren möchten, klicken Sie auf Neu hinzufügen und schließen Sie das Dialogfeld ab.

  2. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

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

  3. Wählen Sie in der Symbolleiste Benachrichtigung erstellen aus.

  4. Geben Sie einen Namen für die Benachrichtigungsrichtlinie ein und klicken Sie auf Weiter.

  5. Geben Sie im Bereich Logeinträge für die Benachrichtigung definieren eine Abfrage ein oder aktualisieren Sie die Abfrage, die aus dem Bereich Abfrage kopiert wurde, als Sie Benachrichtigung erstellen ausgewählt haben.

    Auf der Seite Ereignistypen ist für jeden Ereignistyp eine Abfrage aufgeführt, die sich für die Verwendung in einer protokollbasierten Benachrichtigungsrichtlinie eignet.

  6. Schließen Sie das Dialogfeld ab und klicken Sie auf Speichern.

API

So erstellen Sie mit der Cloud Monitoring API eine logbasierte Benachrichtigungsrichtlinie:

  1. Geben Sie die Abfrage an, die in die Bedingung der Benachrichtigungsrichtlinie aufgenommen werden soll. Auf der Seite Ereignistypen ist für jeden Ereignistyp eine Abfrage aufgeführt, die sich für die Verwendung in einer protokollbasierten Benachrichtigungsrichtlinie eignet.

  2. Erstellen Sie die JSON-Datei mit der Darstellung der Benachrichtigungsrichtlinie. Weitere Informationen zu diesem Schritt und ein Beispiel finden Sie unter Benachrichtigungsrichtlinie entwerfen.

  3. Rufen Sie die API-Methode alertPolicies.create auf. Sie können beispielsweise den Befehl gcloud alpha monitoring policies create verwenden.

Ereignisse ausblenden

Console

Wenn Sie alle Ereignisse ausblenden möchten, klicken Sie in der Symbolleiste des Dashboards auf Anmerkungen, wählen Sie Löschen und dann Übernehmen aus.

Wenn Sie einen Ereignistyp ausblenden möchten, klicken Sie auf  Anmerkungen, heben Sie die Auswahl für diesen Ereignistyp auf und wählen Sie dann Übernehmen aus.

API

Wenn Sie einen Ereignistyp in einem benutzerdefinierten Dashboard ausblenden möchten, suchen Sie das EventAnnotation-Objekt für den Ereignistyp und legen Sie dann für das Feld enabled den Wert false fest.

Ausführliche Informationen zur Verwendung der Cloud Monitoring API finden Sie unter Dashboards mithilfe der API erstellen und verwalten.

Nächste Schritte