Ereignisse auf einem Dashboard anzeigen

In diesem Dokument wird beschrieben, wie Sie Ereignisse in den Diagrammen auf einem Dashboard anzeigen können. Ein Ereignis ist eine Aktivität, die sich auf den Betrieb eines Systems auswirkt, z. B. eine Bereitstellung oder ein Absturz. Wenn Sie Ereignisse anzeigen lassen, können Sie bei der Fehlerbehebung Daten aus verschiedenen Quellen leichter korrelieren.

Ereignisse können auf den meisten Dashboards angezeigt werden, die in der Google Cloud Console auf der Seite Dashboards aufgeführt sind. Zum Konfigurieren der Ereignistypen, die in einem Dashboard angezeigt werden, können Sie die Google Cloud Console verwenden. Für benutzerdefinierte Dashboards können Sie auch die Cloud Monitoring API verwenden.

So werden Ereignisse identifiziert

Dashboards fragen Ereignisse ab, indem die Logeinträge analysiert werden, die die Cloud Logging-Senken in Ihrem Google Cloud-Projekt durchlaufen. Zu diesen Logeinträgen gehören die von Ihrem Projekt generierten und die an Ihr Projekt weitergeleiteten Einträge.

Wenn Sie bei einem dieser Ereignisse benachrichtigt werden möchten, können Sie eine logbasierte Benachrichtigungsrichtlinie erstellen. Verwenden Sie in der Benachrichtigungsrichtlinie die Abfragen auf der Seite Ereignistypen.

So werden Ereignisse angezeigt

Bei allen Ereignissen werden die Diagramme in Ihrem Dashboard mit Anmerkungen versehen. Ereignisse, die durch die Analyse von Logeinträgen identifiziert wurden, werden in einer einzigen Zeitreferenz angezeigt.

Der folgende Screenshot zeigt ein Diagramm mit einem Ereignis, das durch die Analyse von Logeinträgen identifiziert wurde:

Diagramm mit Ereignisanmerkungen.

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

  • Ereignisname.
  • Der Google Cloud-Dienst oder die Ressource, die das Ereignis verursacht hat.
  • Datum und Startzeit des Ereignisses.
  • Eine Schaltfläche Ansicht, die, wenn sie ausgewählt wird, eine Seite mit weiteren Informationen zum Ereignis öffnet. Beispielsweise kann der Log-Explorer geöffnet werden, um Logeinträge anzusehen.

Dashboard-Filter, die die von einem Dashboard angezeigten Daten begrenzen, filtern normalerweise sowohl nach Zeitreihendaten als auch nach Ereignissen.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Aufrufen und Anzeigen von Ereignissen in Dashboards und zum Erstellen von Benachrichtigungsrichtlinien benötigen:

  • Dashboards und Benachrichtigungsrichtlinien ansehen und erstellen: Monitoring-Bearbeiter (roles/monitoring.editor).
  • Ereignisse aus Logeinträgen ohne Datenzugriff, die in Ihrem Google Cloud-Projekt erstellt wurden, ansehen und anzeigen lassen: Loganzeige (roles/logging.viewer).
  • Ereignisse aus Logeinträgen, die in Ihrem Google Cloud-Projekt erstellt wurden, ansehen und anzeigen lassen: Betrachter privater Logs (roles/logging.privateLogViewer).

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.

Ereignisse anzeigen

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 auf einem Dashboard auf:

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

  3. In der Symbolleiste des Dashboards muss die Ein/Aus-Schaltfläche Ereignisse aktiviert sein.

    Wenn die Ein/Aus-Schaltfläche Ereignisse nicht angezeigt wird, können im Dashboard keine Ereignisse angezeigt werden.

  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 aufrufen und Ihre Ereignistypauswahl speichern möchten, klicken Sie auf Ausgewählte anpinnen. Wenn das automatische Speichern auf Ihrem Dashboard deaktiviert ist, rufen Sie die Symbolleiste des Dashboards auf und klicken Sie auf Speichern.

      Wenn Sie Ihre Auswahl anpinnen, ändern Sie die JSON-Definition des Dashboards. Wenn das Dashboard wieder geöffnet wird, wird Ihre Auswahl geladen und das Dashboard zeigt Annotationen für die entsprechenden Ereignistypen an.

    • Klicken Sie andernfalls auf OK.

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

  5. Aktivieren Sie die Kurzinfo mit dem Mauszeiger, um die Zusammenfassung eines Ereignisses anzusehen oder auf Links zu Logeinträgen zuzugreifen.

API

Wenn Sie ein benutzerdefiniertes Dashboard zum Anzeigen von Ereignissen konfigurieren möchten, schließen Sie das Feld annotations in das Objekt Dashboard ein. 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-Projekte zum Suchen nach Ereignissen aufgelistet. 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 ereignisspezifischen Ein/Aus-Schaltfläche definieren können. Wenn dieses Feld nicht angegeben ist oder der Wert dieses Felds ein leerer String 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 befindet sich der Schalter auf der Position on und die Ereignisse werden auf dem Dashboard angezeigt. Wenn false, befindet sich 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.
    • Das Feld resourceNames, mit dem Sie eine Liste von Google Cloud-Projekten definieren können, die nach Ereignissen gesucht werden sollen. Wenn dieses Feld ein leeres Array ist, wird das ausgewählte Projekt durchsucht.

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

"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 nach API erstellen und verwalten und Beispiel: Ereignisse in Dashboards aktivieren.

Termindetails ansehen

Wenn Sie sich ein Diagramm mit Ereignisanmerkungen ansehen, können Sie über die Links in der Kurzinfo auf zusätzliche Informationen zugreifen.

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 Ansicht geöffnet wird, hängt vom Ereignistyp ab. Bei einem Ereignis einer Verfügbarkeitsdiagnose öffnet diese Schaltfläche beispielsweise das Dashboard für die Verfügbarkeitsdiagnose. 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-Senken in Ihrem Google Cloud-Projekt passieren, können Sie sich benachrichtigen lassen, wenn diese Ereignisse auftreten. Dazu konfigurieren Sie eine logbasierte Benachrichtigung. Logbasierte Benachrichtigungsrichtlinien fragen empfangene Logeinträge ab. Wenn die Abfrage ein nicht leeres Ergebnis zurückgibt, 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. Rufen Sie den Typ des Benachrichtigungskanals auf, den Sie konfigurieren möchten, klicken Sie auf 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. 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.

    Für jeden Ereignistyp wird auf der Seite Ereignistypen eine Abfrage aufgeführt, die für eine logbasierte Benachrichtigungsrichtlinie geeignet ist.

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

API

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

  1. Identifizieren Sie die Abfrage, die in die Bedingung der Benachrichtigungsrichtlinie einbezogen werden soll. Auf der Seite Ereignistypen wird für jeden Ereignistyp eine Abfrage aufgeführt, die für eine logbasierte Benachrichtigungsrichtlinie geeignet ist.

  2. Erstellen Sie die JSON-Datei, die die Darstellung der Benachrichtigungsrichtlinie enthält. 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 ausführen.

Ereignisse ausblenden

Console

Zum Ausblenden aller Ereignisse muss in der Dashboard-Symbolleiste die Ein/Aus-Schaltfläche Events deaktiviert sein.

Wenn Sie einen Ereignistyp ausblenden möchten, stellen Sie die Ein/Aus-Schaltfläche für diesen Ereignistyp auf „Aus“.

API

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

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

Nächste Schritte