Ereignisse auf einem Dashboard anzeigen

In diesem Dokument wird beschrieben, wie Sie ein Dashboard zur Anzeige von Ereignisannotationen konfigurieren. 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 verwenden, wenn Sie ein Problem beheben.

Ereignishinweise

Sie können Ereignisse auf den meisten Dashboards anzeigen, die in der Seite Dashboards der Google Cloud Console Ebenso können Sie einige dienstspezifische Tabs für die Beobachtbarkeit konfigurieren, wie die für Compute Engine und Google Kubernetes Engine, um Ereignisse anzuzeigen. 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 und als benutzerdefinierte Dashboards klassifizierte Dashboards können Sie auch die Cloud Monitoring API verwenden.

Es sei denn, Sie verwenden die Cloud Monitoring API oder speichern Ihre Daten Ereignistyp auswählen, gilt Ihre Auswahl 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.

Die folgenden Ereignistypen können in einem Dashboard oder Beobachtbarkeit, 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 im Dashboard-JSON-Datei erstellen oder sie verwerfen, wodurch die Empfehlung entfernt wird. Um festzustellen, welche Ereignistypen gespeichert werden, öffnen Sie das Menü Ereignistypen auswählen und sehen Sie sich den Bereich Angepinnt an.

So werden Ereignisse identifiziert

Dashboards fragen verschiedene Datenquellen ab, um Ereignisse zu identifizieren die auf Ihrem Dashboard angezeigt werden sollen:

  • Warnungsereignisse werden identifiziert durch Monitoring Benachrichtigungsereignisse geben Aufschluss darüber, Vorfälle geöffnet.

  • Personalized Service Health-Ereignisse werden identifiziert durch Abfragen, die Monitoring an die Service Health API sendet. Diese Ereignisse weisen auf eine Störung eines Google Cloud-Dienstes hin.

  • 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 verfügbar sind.

So werden Ereignisse angezeigt

Wenn diese Ereignisse eintreten, werden die Diagramme auf Ihrem Dashboard gekennzeichnet sind. Ereignisse, die durch die Analyse von Logeinträgen identifiziert wurden, werden mit einem einzelnen Zeitreferenz. Service Health-Ereignisse werden dagegen mit eine Startzeit und dann ändert sich der Hintergrund des Diagramms für die Dauer der Veranstaltung. 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:

Diagramm mit Hinweisen zu Warn- und Informationsereignissen.

Wie im Screenshot oben gezeigt, enthält die Kurzinfo für ein Ereignis Informationen wie die folgenden:

  • Ereignisname.
  • Datum und Startzeit des Ereignisses.
  • 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 z. B. der Log-Explorer geöffnet werden, um Logeinträge ansehen zu können. Eventuell wird auch die Detailseite für ein Service Health-Ereignis.

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 ansehen und erstellen: Monitoring-Bearbeiter (roles/monitoring.editor).
    • Ereignisse aufrufen und anzeigen, die aus Logeinträgen ohne Datenzugriff stammen, die 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 ansehen: Personalized Service Health-Betrachter (roles/servicehealth.viewer)

    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.

  • Wenn Sie Service Health-Ereignisse auf Ihrem Dashboard und aktivieren Sie dann die Service Health API:

    Aktivieren Sie die API

Ereignisse anzeigen

In diesem Abschnitt wird beschrieben, wie Sie ein Dashboard oder den Tab Beobachtbarkeit konfigurieren um Ereignisse anzuzeigen.

Dashboards zum Anzeigen von Ereignissen konfigurieren

In diesem Abschnitt wird beschrieben, wie Dashboards konfiguriert werden, die in auf der Seite Dashboards der Google Cloud Console, um Ereignisse aufzurufen.

Für eine Liste von 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 auf 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. Achten Sie darauf, dass in der Symbolleiste des Dashboards Die Ein/Aus-Schaltfläche Ereignisse ist aktiviert.

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

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

    • Wenn Sie ein benutzerdefiniertes Dashboard aufrufen 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 Dashboard. 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

So konfigurieren Sie ein benutzerdefiniertes Dashboard zum Anzeigen von Ereignissen: Das Feld annotations muss im Objekt Dashboard enthalten sein. Das Feld annotations enthält eine Instanz eines DashboardAnnotations-Objekts. mit zwei Feldern:

  • Im Feld defaultResourceName werden die Standardeinstellungen auf Dashboard-Ebene für die Google Cloud-Projekten, um nach Ereignissen zu suchen. Wenn Sie dieses Feld nicht angeben, wird das ausgewählte Projekt durchsucht.

  • 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, steht der Schalter auf der Position on und die Ereignisse werden angezeigt auf dem Dashboard. Wenn false, befindet sich der Schalter in der Position off.
    • Ein eventType-Feld, das einen Wert aus EventType enthält Aufzählung.
    • Das Feld filter, mit dem Sie eine Abfrage angeben können, die an die ereignisspezifische Abfrage angegeben werden. Wenn der Wert dieses Feldes ein leerer String ist, wird die ereignisspezifische Abfrage verwendet.
    • Das Feld resourceNames, mit dem Sie eine Liste von Google Cloud-Projekten, um nach Ereignissen zu suchen. Wenn dieses Feld ist ein leeres Array, wird das ausgewählte Projekt durchsucht.

Das folgende Beispiel zeigt ein annotations-Objekt für ein Clusterupdate . Das Feld filter in diesem Beispiel beschränkt die Ereignisse auf bestimmter Cluster:

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

Ausführliche Informationen zur Verwendung der Cloud Monitoring API zum Erstellen Dashboards, siehe Dashboards nach API erstellen und verwalten und Beispiel: Ereignisse in Dashboards aktivieren.

Konfigurieren Sie den Tab Beobachtbarkeit, um Ereignisse aufzurufen

In diesem Abschnitt wird beschrieben, wie Sie die Beobachtbarkeit konfigurieren. um Ereignisse anzuzeigen. Einige Dienste wie Compute Engine und Stellen Sie in Google Kubernetes Engine den Tab Beobachtbarkeit bereit, auf dem Messwert- und Logdaten.

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. In ähnlicher Weise können Sie Kubernetes-Arbeitslasten oder zur Detailseite eines VM-Instanz und wählen Sie den Tab Beobachtbarkeit aus.

  2. Achten Sie darauf, dass im Menü Dashboard die Option Vordefiniert 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 Ereignisanmerkungen können Sie über die Links in der Kurzinfo weitere Informationen.

Wenn Sie die Details zu einem bestimmten Termin aufrufen möchten, klicken Sie auf Ansehen.

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. Für eine andere Ereignistyp enthält, wird möglicherweise der Log-Explorer geöffnet.

Benachrichtigungsrichtlinien erstellen

Wenn Ereignisse durch die Analyse der Logeinträge identifiziert werden, die die Cloud Logging-Senken in Ihrem Google Cloud-Projekt passieren, kann benachrichtigt werden, wenn diese Ereignisse eintreten, indem Logbasierte Benachrichtigung konfigurieren Abfrage logbasierter Benachrichtigungsrichtlinien Ihre Logeinträge, sobald sie empfangen wurden. Wenn die Abfrage ein nicht leeres wird ein Vorfall erstellt und Benachrichtigungen 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. Gehen Sie zum Typ des Benachrichtigungskanals, den Sie konfigurieren möchten, klicken Sie auf Add new (Neu hinzufügen) und füllen Sie das Dialogfeld aus.

  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. Gehen Sie im Bereich Logeinträge für die Benachrichtigung definieren wie folgt vor: Geben Sie eine Abfrage ein oder aktualisieren Sie die Abfrage, die aus dem Bereich Abfrage kopiert wurde. wenn Sie Benachrichtigung erstellen ausgewählt haben.

    Für jeden Ereignistyp wird auf der Seite Ereignistypen eine Abfrage, die in einer logbasierten Benachrichtigungsrichtlinie verwendet werden kann.

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

API

So erstellen Sie mithilfe der Cloud Monitoring API eine logbasierte Benachrichtigungsrichtlinie: Gehen Sie so vor:

  1. Identifizieren Sie die Abfrage, die in die Bedingung des Benachrichtigungsrichtlinie 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, die die Darstellung der Benachrichtigungen enthält. . Weitere Informationen zu diesem Schritt und ein Beispiel finden Sie unter Entwerfen Sie die Benachrichtigungsrichtlinie.

  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 eine Ereignisart ausblenden möchten, stellen Sie die Ein/Aus-Schaltfläche für diesen Ereignistyp auf „Aus“. .

API

Um einen Ereignistyp auf einem benutzerdefinierten Dashboard auszublenden, suchen Sie EventAnnotation-Objekt für den Ereignistyp Legen Sie dann das Feld enabled auf false fest.

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

Nächste Schritte