Benachrichtigungsrichtlinien verwalten

In diesem Dokument wird beschrieben, wie Sie Benachrichtigungsrichtlinien mit der Google Cloud Console bearbeiten, auflisten und abrufen. Es wird beispielsweise beschrieben, wie Sie eine Richtlinie so bearbeiten, dass sie mit einer App Hub-Anwendung verknüpft wird. Auf dieser Seite erfahren Sie auch, wie Sie die JSON-Darstellung einer Richtlinie aufrufen und einem benutzerdefinierten Dashboard Benachrichtigungsrichtlinien hinzufügen. So können Sie Ihre Richtlinien im selben Kontext wie Ihre Messwertdaten aufrufen.

In diesem Dokument wird nicht beschrieben, wie Sie Benachrichtigungsrichtlinien mit der Cloud Monitoring API bearbeiten, auflisten und abrufen. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien über API verwalten.

Diese Funktion wird nur für Google Cloud-Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.

Hinweise

Führen Sie in dem Google Cloud-Projekt, in dem Ihre Benachrichtigungsrichtlinien gespeichert sind, die folgenden Schritte aus:

  1. Um die Berechtigungen zu erhalten, die Sie zum Erstellen und Ändern von Benachrichtigungsrichtlinien mit der Google Cloud Console benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zuzuweisen. 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.

    Weitere Informationen zu Cloud Monitoring-Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.

  2. Machen Sie sich mit den allgemeinen Konzepten von Benachrichtigungsrichtlinien vertraut. Weitere Informationen finden Sie unter Benachrichtigungen.

Benachrichtigungsrichtlinien bearbeiten, auflisten oder löschen

  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.

    Die Seite Benachrichtigungen zeigt Bereiche an, in denen zusammenfassende Informationen, Vorfälle und Benachrichtigungsrichtlinien aufgelistet sind.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud-Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.

  3. Klicken Sie im Bereich Richtlinien auf Alle Richtlinien ansehen.

    Auf der Seite Richtlinien werden alle Richtlinien aufgelistet. Außerdem gibt es eine Filterleiste und für jede Richtlinie Optionen zum Bearbeiten, Kopieren oder Löschen:

    • Führen Sie einen der folgenden Schritte aus, um die Liste der Benachrichtigungsrichtlinien zu filtern:

      • Geben Sie einen Namen in die Filterleiste ein. Wenn Sie beispielsweise nur Richtlinien anzeigen lassen möchten, deren Name Example enthält, geben Sie Example ein. Bei einem Vergleich, bei dem die Groß- und Kleinschreibung berücksichtigt wird, wird geprüft, ob eine Richtlinie aufgeführt ist.
      • Klicken Sie auf Filterrichtlinien, wählen Sie die Filtereigenschaft aus und geben Sie dann entweder einen Wert für den Filter ein oder wählen Sie einen Wert aus dem Menü aus.

      Wenn Sie mehrere Filter hinzufügen, werden diese durch ein logisches AND verknüpft.

  4. Optional: Klicken Sie auf den Namen einer Richtlinie, um die Details anzuzeigen. Informationen zur Seite Richtliniendetails finden Sie unter Benachrichtigungsrichtlinie aufrufen.

  5. Optional: Wenn Sie eine Richtlinie bearbeiten oder kopieren möchten, klicken Sie auf Mehr Optionen und wählen Sie die entsprechende Option aus. Beim Bearbeiten und Kopieren einer Richtlinie gehen Sie ähnlich wie beim Erstellen einer messwertbasierten Benachrichtigungsrichtlinie vor. Nicht alle Felder können jedoch geändert werden. Klicken Sie abschließend auf Richtlinie speichern.

  6. Optional: Wenn Sie eine Richtlinie löschen möchten, klicken Sie auf Mehr Optionen und wählen Sie Löschen aus. Wählen Sie im Bestätigungsdialogfeld noch einmal Löschen aus.

    Wenn ein Dashboard ein Diagramm mit Daten für eine Benachrichtigungsrichtlinie enthält, werden in diesem Diagramm keine Daten mehr angezeigt, wenn die Benachrichtigungsrichtlinie gelöscht wird. Weitere Informationen finden Sie unter Im Benachrichtigungsrichtlinien-Widget werden keine Daten angezeigt.

Benachrichtigungsrichtlinie ansehen

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud-Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.

  3. Wenn Sie alle Richtlinien auflisten möchten, klicken Sie im Bereich Richtlinien auf Alle Richtlinien ansehen.

  4. Suchen Sie die Richtlinie, die Sie aufrufen möchten, und wählen Sie sie aus.

    Die Detailseite für die Benachrichtigungsrichtlinie wird geöffnet. Dort können Sie Ihre Richtlinie überwachen oder bearbeiten und zugehörige Daten wie Vorfälle und Benachrichtigungen aufrufen. Außerdem haben Sie folgende Möglichkeiten:

    • Ändern Sie den Zeitraum für die im Diagramm angezeigten Daten. Diagramme haben eine begrenzte Auflösung und für einige Zeiträume werden möglicherweise nicht alle Messwerte angezeigt.

    • Bearbeiten Sie die Benachrichtigung, um benutzerdefinierte Labels hinzuzufügen, die in Ihren Vorfällen und Benachrichtigungen enthalten sein sollen. Weitere Informationen finden Sie unter Vorfälle mit Labels versehen.

    • Ändern Sie den aktivierten Status der Richtlinie. Wenn eine Richtlinie deaktiviert ist, erhalten Sie keine Benachrichtigungen.

JSON-Darstellung einer Benachrichtigungsrichtlinie ansehen

Wenn Sie eine Benachrichtigungsrichtlinie mit der Cloud Monitoring API erstellen oder ändern, geben Sie der API-Methode eine JSON-Darstellung dieser Richtlinie an. Sie können die JSON-Datei selbst erstellen. Orientieren Sie sich dabei an der API-Dokumentation. Alternativ können Sie eine Richtlinie mit der Google Cloud Console erstellen und dann auf Ihr lokales System herunterladen. Die heruntergeladene JSON-Datei kann bearbeitet und als Vorlage für andere Richtlinien verwendet werden. Beispiele für in JSON beschriebene Richtlinien finden Sie unter Beispielrichtlinien.

So laden Sie die JSON-Darstellung einer Benachrichtigungsrichtlinie herunter:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud-Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.
  3. Suchen Sie die gewünschte Richtlinie und klicken Sie auf den Namen, um die Seite Richtliniendetails zu öffnen.
  4. Klicken Sie auf JSON.

Wenn Sie die JSON-Darstellung einer Benachrichtigungsrichtlinie während der Bearbeitung aufrufen möchten, klicken Sie auf  Code anzeigen.

Dashboard eine Benachrichtigungsrichtlinie hinzufügen

Wenn Sie Ihre Benachrichtigungsrichtlinien im selben Kontext wie Ihre Messwertdaten aufrufen möchten, fügen Sie diese Richtlinien einem benutzerdefinierten Dashboard hinzu. In diesem Dashboard wird für jede hinzugefügte Benachrichtigungsrichtlinie ein Diagramm angezeigt. In diesen Diagrammen werden der überwachte Messwert, der Grenzwert und die Anzahl der offenen Vorfälle für die Richtlinie angezeigt. Diese Diagramme enthalten auch Links, über die Sie die Richtlinie aufrufen oder bearbeiten können.

Sie können benutzerdefinierten Dashboards Richtlinien mit einer Bedingung hinzufügen. Richtlinien mit mehreren Bedingungen können nur im Benachrichtigungskontext angezeigt werden.

So rufen Sie eine Zusammenfassung einer Benachrichtigungsrichtlinie in einem benutzerdefinierten 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 in der Symbolleiste der Google Cloud Console Ihr Google Cloud-Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.
  3. Wählen Sie ein Dashboard aus oder klicken Sie auf Dashboard erstellen.
  4. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.
  5. Wählen Sie im Dialogfeld Widget hinzufügen die Option Benachrichtigungsrichtlinie aus.
  6. Klicken Sie auf Benachrichtigungsrichtlinie und wählen Sie dann eine Benachrichtigungsrichtlinie aus. Im Menü Benachrichtigungsrichtlinie können nur Benachrichtigungsrichtlinien mit einer einzelnen Bedingung ausgewählt werden.
  7. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

Der folgende Screenshot zeigt ein Diagramm für eine Benachrichtigungsrichtlinie:

Beispiel für ein Diagramm für eine Benachrichtigungsrichtlinie

In diesem Beispiel überwacht die Benachrichtigungsrichtlinie die CPU-Nutzung von zwei verschiedenen virtuellen Maschinen. Die gestrichelte Linie zeigt den Bedingungsgrenzwert an, der auf 50 % festgelegt ist. Der grüne Chip mit dem Label No incidents gibt an, dass es keine offenen Vorfälle für die Benachrichtigungsrichtlinie gibt. Wenn Sie den Zeiger auf dem Chip platzieren, der die Anzahl der offenen Vorfälle zeigt, wird ein mit der zugrunde liegenden Benachrichtigungsrichtlinie verknüpftes Dialogfeld geöffnet.

Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien und Vorfälle in einem Dashboard anzeigen.

Benachrichtigungsrichtlinie mit einer App Hub-Anwendung verknüpfen

Wenn Sie einer Benachrichtigungsrichtlinie benutzerdefinierte Labels hinzufügen, können Sie sie mit einem Dienst oder einer Arbeitslast verknüpfen, die Teil einer App Hub-Anwendung ist. Diese Labels sind in Vorfällen und Benachrichtigungen enthalten. Die Benachrichtigungsrichtlinie wird auch in den Dashboards für die Anwendungsüberwachung aufgeführt. Weitere Informationen zu Labels finden Sie unter Vorfälle mit Labels versehen.

So verknüpfen Sie mithilfe der Google Cloud Console eine Benachrichtigungsrichtlinie mit einer Arbeitslast oder einem Dienst:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud-Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des Ordners für Anwendungen aus.
  3. Suchen Sie die Benachrichtigungsrichtlinie, klicken Sie auf  Mehr anzeigen, wählen Sie Bearbeiten aus und gehen Sie dann zum Bereich Benachrichtigungen und Name.
  4. Wählen Sie im Bereich Anwendungslabels Ihre Anwendung und dann Ihre Arbeitslast oder Ihren Dienst aus.
  5. Klicken Sie auf Richtlinie speichern.

Nachdem Sie diese Schritte ausgeführt haben, werden Labels mit den folgenden Schlüsseln an Ihre Benachrichtigungsrichtlinie angehängt. Mit diesen Labels werden Ihre Anwendung und Ihr Dienst oder Ihre Arbeitslast identifiziert:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id oder apphub_workload_id

Sie können einer Benachrichtigungsrichtlinie auch Nutzerlabels hinzufügen. Verwenden Sie dazu die Google Cloud CLI, Terraform oder die Cloud Monitoring API. Sie müssen jedoch die im vorherigen Beispiel gezeigten Labelschlüssel verwenden. Hier finden Sie weitere Informationen: