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, z. B. eine Bereitstellung oder ein Absturz, die sich auf den Betrieb eines Systems. Wenn Sie Ereignishinweise einblenden, können Sie leichter Daten aus verschiedenen Quellen abrufen können, wenn Sie ein Problem beheben.

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 wie die für die Compute Engine und die Google Kubernetes Engine so konfigurieren, dass Ereignisse angezeigt werden. Um die Ereignistypen zu konfigurieren, werden in einem Dashboard oder auf dem Tab Beobachtbarkeit angezeigt. können Sie die Google Cloud Console verwenden. 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, wird Ihre Auswahl gespeichert, wenn Sie sie anpinnen.

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

Empfohlene Ereignistypen

Die folgenden Ereignistypen können auf einem Dashboard oder Beobachtbarkeit, obwohl Sie keine Ereignistypen ausgewählt haben:

• Benachrichtigung geöffnet
• Personalized Service Health-Vorfall wenn die Service Health API aktiviert ist.
• Für jeden Ressourcentyp mit Daten, die auf der Seite Dashboard, ein Ereignistyp.

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. Um festzustellen, welche Ereignistypen gespeichert werden sollen, erweitern Sie das Menü Ereignistypen auswählen und sehen Sie sich den Bereich Angepinnt an.

So werden Ereignisse identifiziert

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

• Warnungsereignisse werden identifiziert durch Monitoring 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 die Analyse der Logeinträge identifiziert, die die Cloud Logging-Senken in Ihrem Google Cloud-Projekt durchlaufen. Diese Logeinträge enthalten die von Ihrem Projekt generierten Einträge und solche, die an Ihr Projekt weitergeleitet werden. Wenn Sie benachrichtigt werden möchten, wenn eines dieser Ereignisse eintritt, können Sie eine logbasierte Benachrichtigungsrichtlinie. Verwenden Sie in der Benachrichtigungsrichtlinie die Abfragen, die auf der Seite Ereignistypen bereitgestellt werden.

Darstellung von Ereignissen

Hinweis: Aus Leistungsgründen begrenzen Dashboards die Anzahl der Ereignisse, die sie anzeigen. Wenn diese Limits erreicht sind, werden die Dashboards werden nur die neuesten Ereignisse angezeigt. Wenn Sie ältere Termine sehen möchten, verwenden Sie einen kürzeren Zeitraum oder fügen Sie Filter hinzu.

Wenn diese Ereignisse eintreten, werden die Diagramme auf Ihrem Dashboard gekennzeichnet sind. Ereignisse, die durch die Analyse von Logeinträgen ermittelt wurden, werden mit einer einzigen Zeitreferenz 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 außerdem ein Herzsymbol angezeigt.

Der folgende Screenshot zeigt ein Diagramm mit mehreren Ereignisse, die durch die Analyse von Logeinträgen identifiziert wurden, und Service Health-Ereignis:

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

• Ereignisname.
• Datum und Startzeit der Veranstaltung.
• Chips mit der Nummer für Service Health-Ereignisse von betroffenen Produkten und Standorten. Wenn Sie die betroffenen Produkte oder Standorte auflisten möchten, platzieren Sie den Mauszeiger auf dem entsprechenden Chip.
• Eine Schaltfläche Anzeigen. Wenn diese ausgewählt ist, wird eine Seite mit weiteren Informationen über das Ereignis. 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, die die von einem Dashboard angezeigten Daten einschränken, in der Regel sowohl Zeitreihendaten als auch Ereignisse filtern.

Hinweise

• Um die Berechtigungen zu erhalten, die Sie zum Anzeigen und Anzeigen von Ereignissen auf Dashboards benötigen, Erstellen von Benachrichtigungsrichtlinien, bitten Sie Ihren Administrator, Ihnen folgende IAM-Rollen für Ihr Projekt:

  • 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).
  • Sehen Sie sich Ereignisse an, die aus Logeinträgen in Ihrem Google Cloud-Projekt stammen, und zeigen Sie sie an: Betrachter privater Logs (roles/logging.privateLogViewer)
  • Service Health-Ereignisse aufrufen: 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 auf Ihrem Dashboard und aktivieren Sie dann 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 zum Anzeigen von Ereignissen konfigurieren

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 gewünschte Dashboard aus.

3. In der Symbolleiste des Dashboards muss der Schalter Ereignisse aktiviert sein.

   Wenn die Ein/Aus-Schaltfläche Ereignisse nicht angezeigt wird, gilt Folgendes: kann Dashboard keine Ereignisse anzeigen.

4. Klicken Sie auf Ereignistypen auswählen, wählen Sie die Ereignistypen aus, die im Dashboard angezeigt werden sollen, und führen Sie dann einen der folgenden Schritte aus:

   • Wenn Sie ein benutzerdefiniertes Dashboard ansehen und den Ereignistyp speichern möchten Auswahl aus und klicken Sie dann auf Ausgewählte anpinnen. Wenn das automatische Speichern deaktiviert ist auf Ihrem Dashboard, gehen Sie dann zur Symbolleiste Klicken Sie auf Speichern.

     Wenn Sie Ihre Auswahl anpinnen, ändern Sie die JSON-Definition des Dashboards. Beim erneuten Öffnen des Dashboards geladen und im Dashboard werden Anmerkungen für die Ereignistypen.

   • Klicken Sie andernfalls auf OK.

   Nachdem Sie die Liste der anzuzeigenden Ereignistypen aktualisiert haben, Cloud Monitoring gibt Abfragen aus, die einen Moment dauern. und fügt die Anmerkungen dann den Diagrammen im Dashboard hinzu.

5. So rufen Sie eine Zusammenfassung eines Termins oder Links zu zusätzlichen Informationen auf: Verwenden Sie den Zeiger, um die Kurzinfo zu aktivieren.

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. mit zwei Feldern:

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

  • Das Feld displayName, mit dem Sie das Label der Ereignisspezifische Ein/Aus-Schaltfläche Wenn dieses Feld nicht angegeben ist oder der Wert ein leerer String ist, wird der Standardname des Ereignisses angezeigt.
  • Ein enabled-Feld, das den Wert der Ein/Aus-Schaltfläche des Ereignisses steuert. Wenn true angezeigt wird, befindet sich die Ein/Aus-Schaltfläche in der Position on und Ereignisse werden im Dashboard angezeigt. Wenn false, befindet sich der Schalter in der Position off.
  • Ein eventType-Feld, das einen Wert aus EventType enthält Aufzählung.
  • 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 Compute Engine und Google Kubernetes Engine bieten den Tab Observability (Beobachtbarkeit), auf dem Mess- und Protokolldaten angezeigt werden.

Hinweis :Nicht alle Tabs für Beobachtbarkeit können für die Anzeige von Ereignissen konfiguriert 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 wählen Sie den Tab Beobachtbarkeit aus. 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  Ereignisse auswählen und füllen Sie das Dialogfeld aus.

   Nachdem Sie die Liste der anzuzeigenden Ereignisse aktualisiert haben, werden Abfragen an ruft die Ereignisdaten ab, dann wird das Dashboard aktualisiert.

   Wenn die Schaltfläche Ereignisse auswählen nicht angezeigt wird, kann auf dem Tab keine 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.

Welche Seite der Google Cloud Console über die Schaltfläche Ansehen geöffnet wird, hängt davon ab, den Ereignistyp. Bei einem Ereignis der Verfügbarkeitsdiagnose gilt beispielsweise: um das Dashboard für die Verfügbarkeitsdiagnose zu öffnen. 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 wird ein Vorfall erstellt und Benachrichtigungen gesendet.

Console

Hinweis: So erstellen Sie eine Benachrichtigungsrichtlinie für ein Ereignis, das Sie sich gerade ansehen: Aktivieren Sie die Kurzinfo für das Ereignis, klicken Sie auf Protokolle ansehen und fahren Sie fort über den Schritt „Benachrichtigung erstellen“ im folgenden Verfahren.

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 Monitoring ist.

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

4. Geben Sie einen Namen für die Benachrichtigungsrichtlinie ein und klicken Sie dann 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. Für jeden Ereignistyp Auf der Seite Ereignistypen finden Sie Abfrage, die in einer logbasierten Benachrichtigungsrichtlinie verwendet werden kann.

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. Beispielsweise könnten Sie den gcloud alpha monitoring policies create .

Ereignisse ausblenden

Console

Um alle Ereignisse auszublenden, klicken Sie in der Dashboard-Symbolleiste Stellen Sie sicher, dass die Ein/Aus-Schaltfläche Ereignisse deaktiviert ist.

Wenn Sie einen Ereignistyp ausblenden möchten, stellen Sie den Schalter für diesen Ereignistyp auf „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

• Benutzerdefiniertes Dashboard freigeben
• Im Diagramm aufgeführte Daten untersuchen
• Auf ressourcenspezifische Dashboards zugreifen
• Temporäre Filter zu benutzerdefinierten Dashboards hinzufügen
• Benutzerdefinierten Dashboards dauerhafte Filter hinzufügen