Benachrichtigungsrichtlinien verwalten

Eine Benachrichtigungsrichtlinie beschreibt eine Reihe von Bedingungen, die Sie beobachten möchten. Diese Bedingungen können sich beispielsweise auf den Zustand eines fehlerhaften Systems oder den Ressourcenverbrauch beziehen. Beispielsweise könnten Sie eine Richtlinie erstellen, die eine Verfügbarkeitsdiagnose oder die Verwendung der Cloud Monitoring API überwacht. Neben Bedingungen können Sie in einer Benachrichtigungsrichtlinie angeben, wie Sie benachrichtigt werden möchten und welche Dokumentation in der Benachrichtigung enthalten sein soll.

Auf dieser Seite wird erläutert, wie Sie mit dem Monitoring in der Google Cloud Console eine Benachrichtigungsrichtlinie erstellen und verwalten. Sie können diese Aufgaben auch mit der Cloud Monitoring API ausführen. Weitere Informationen zu diesem Ansatz finden Sie unter Benachrichtigungsrichtlinien nach API verwalten. Eine JSON-Darstellung von Richtlinien finden Sie unter Beispielrichtlinien.

Vorbereitung

Machen Sie sich vor dem Erstellen von Benachrichtigungsrichtlinien mit den allgemeinen Konzepten und der Terminologie von Benachrichtigungsrichtlinien vertraut. Sie sollten beispielsweise die Komponenten einer Richtlinie, das Konzept eines Vorfalls sowie die Preise und Limits kennen. Weitere Informationen finden Sie unter Einführung in Benachrichtigungen.

Benachrichtigungskanäle

Über Benachrichtigungskanäle können Sie angeben, wie Sie benachrichtigt werden möchten. Ist ein Benachrichtigungskanaltyp einmal konfiguriert, steht er zur Wahl, wenn Sie Benachrichtigungen für die Benachrichtigungsrichtlinie einrichten.

Eine Liste der Benachrichtigungskanaltypen und Kanalkonfigurationsinformationen finden Sie unter Benachrichtigungsoptionen.

Benachrichtigungsrichtlinien für Verfügbarkeitsdiagnosen

Erstellen Sie die Benachrichtigungsrichtlinie für eine Verfügbarkeitsdiagnose aus dem Fenster Uptime checks (Verfügbarkeitsdiagnosen). Wenn Sie dieser Richtlinie folgen, sind die meisten Felder in der Benachrichtigungsrichtlinie vorkonfiguriert:

Benachrichtigungsrichtlinie erstellen

  1. Wählen Sie in der Cloud Console Monitoring aus:

    Zu Monitoring

    Wenn Sie Monitoring noch nie verwendet haben, wird automatisch ein Arbeitsbereich erstellt und Ihr Projekt mit ihm verknüpft. Wenn Ihr Projekt nicht mit einem Arbeitsbereich verknüpft ist, wird ein Dialogfeld angezeigt, in dem Sie entweder einen neuen Arbeitsbereich erstellen oder dieses Projekt zu einem vorhandenen hinzufügen können. Klicken Sie nach der Auswahl auf Add (Hinzufügen). Nachdem der Arbeitsbereich erstellt wurde, werden Sie automatisch auf Alerting (Benachrichtigungen) umgestellt.

  2. Wählen Sie Benachrichtigungen aus.

  3. Klicken Sie auf Create Policy (Richtlinie erstellen).

    Es wird ein Dialogfeld für Benachrichtigungsrichtlinien angezeigt.

  4. Nachdem Sie den Namen, die Bedingungen, die Benachrichtigungskanäle und die Dokumentation angegeben haben, klicken Sie auf Save (Speichern).

Benennung

Geben Sie im Fenster Create New Alerting Policy (Neue Benachrichtigungsrichtlinie erstellen) einen Richtliniennamen ein. Er ist in Benachrichtigungen enthalten und wird im Fenster Policies (Richtlinien) angezeigt.

Bedingungen

Jede Bedingung in einer Benachrichtigungsrichtlinie beschreibt eine Ressource, die überwacht wird und wenn diese Ressource gegen das erwartete Verhalten verstößt. Wenn eine Benachrichtigungsrichtlinie über eine Bedingung verfügt, möchten Sie eine Benachrichtigung erhalten, wenn diese Bedingung verletzt wird. Weitere Informationen zur Kombination mehrerer Bedingungen finden Sie unter Mehrere Bedingungen.

Wenn Sie eine Richtlinie um eine Benachrichtigungsbedingung ergänzen möchten, klicken Sie im Fenster Create New Alerting Policy (Neue Benachrichtigungsrichtlinie erstellen) auf Add Condition (Bedingung hinzufügen). Informationen zum Definieren von Bedingungen finden Sie unter Bedingungen angeben.

Mehrere Bedingungen

Eine Benachrichtigungsrichtlinie kann bis zu sechs Bedingungen enthalten.

Wenn Sie die Cloud Monitoring API verwenden oder Ihre Benachrichtigungsrichtlinie mehrere Bedingungen hat, müssen Sie angeben, wann Verstöße gegen die einzelnen Bedingungen zur Generierung einer Benachrichtigung führen:

  • Wenn Sie die Google Cloud Console verwenden, verwenden Sie das Feld Richtlinien-Trigger.
  • Wenn Sie die Cloud Monitoring API verwenden, verwenden Sie das Feld combiner.

In dieser Tabelle werden die Einstellungen in der Cloud Console, der entsprechende Wert in der Cloud Monitoring API und eine Beschreibung der einzelnen Einstellungen aufgeführt:

Cloud Console
Wert für Richtlinientrigger
Cloud Monitoring API
Kombinationswert
Bedeutung
Eine Bedingung ist erfüllt
(Standardwert)
OR Wenn eine Ressource gegen eine der Bedingungen verstößt, wird eine Benachrichtigung generiert.
Alle Bedingungen werden erfüllt. AND Eine Benachrichtigung wird generiert, wenn gegen jede Bedingung von mindestens einer Ressource verstoßen wird, auch wenn eine andere Ressource gegen jede Bedingung verstößt.
Alle Bedingungen werden
bei passenden Ressourcen erfüllt.
AND_WITH_MATCHING_RESOURCE Eine Benachrichtigung wird generiert, wenn jede Bedingung von der gleichen Ressource verletzt wird. Diese Einstellung ist die strengste Kombinationsoption.

Mitteilungen

Über Benachrichtigungskanäle können Sie angeben, wie Sie benachrichtigt werden möchten. Sie werden bei einem Vorfall nur benachrichtigt, wenn Sie zuvor mindestens einen Kanal hinzugefügt haben. Sie können mehrere Benachrichtigungskanäle hinzufügen. Einzelheiten zu den auswählbaren Benachrichtigungskanälen finden Sie unter Benachrichtigungsoptionen.

So fügen Sie einen Benachrichtigungskanal hinzu:

  1. Klicken Sie auf Add notification channel (Benachrichtigungskanal hinzufügen).
  2. Wählen Sie Notification Channel Type (Benachrichtigungskanaltyp) aus.
  3. Unter Umständen müssen Sie weitere Felder ausfüllen. Bei Auswahl von Email werden Sie beispielsweise aufgefordert, Ihre E-Mail-Adresse anzugeben.
  4. Klicken Sie auf Hinzufügen.

Wiederholen Sie die vorherigen Schritte, um der Richtlinie einen weiteren Benachrichtigungskanal hinzuzufügen. Durch die Konfiguration von mindestens zwei Benachrichtigungskanaltypen wird die Zuverlässigkeit erhöht.

Dokumentation

In den Benachrichtigungen finden Sie Anleitungen zur Behebung des Fehlerzustands. Sie können die Dokumentation mithilfe von Markdown formatieren oder nur Text verwenden.

Neben Markdown können Sie Variablen verwenden, um Informationen aus der Richtlinie an sich abzurufen und den Inhalt der Dokumentation anzupassen. Weitere Informationen finden Sie unter Variablen verwenden.

Die Dokumentation kann beispielsweise einen Titel wie Addressing High CPU Usage und Details zur Identifizierung des Projekts enthalten:

## Addressing High CPU Usage

    This note contains information about high CPU Usage.

    You can include variables in the documentation. For example:

    This alert originated from the project ${project}, using
    the variable $${project}.
    

Die Variablen werden nur in Benachrichtigungen durch ihre Werte ersetzt. Der Bereich Preview Markdown (Markdown-Vorschau) und die anderen Stellen in der Cloud Console, in denen die Dokumentation angezeigt wird, spiegeln nur die Markdown-Formatierung wider:

Beispiel für das Schreiben einer Dokumentation mit Markdown.

Sie können Benachrichtigungen auch durch kanalspezifisches Tagging steuern. Weitere Informationen finden Sie unter Kanalsteuerelemente verwenden.

Richtlinien verwalten

Gehen Sie wie folgt vor, um alle Benachrichtigungsrichtlinien aufzulisten:

  1. Wählen Sie in der Cloud Console Monitoring aus:

    Zu Monitoring

  2. Wählen Sie Benachrichtigungen aus.

  3. Im Bereich Policies (Richtlinien) wird eine unvollständige Liste mit Richtlinien angezeigt. Klicken Sie auf See all policies (Alle Richtlinien ansehen), um alle Richtlinien anzuzeigen und die Filterfunktion zu aktivieren.

Klicken Sie auf den Namen der Benachrichtigungsrichtlinie, um die Details anzuzeigen.

Fügen Sie Filter hinzu, um die aufgeführten Benachrichtigungsrichtlinien einzuschränken. Jeder Filter besteht aus einem Namen und einem Wert. Sie können den Wert so einstellen, dass er genau einem Richtliniennamen oder einer Teilübereinstimmung entspricht. Bei Übereinstimmungen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie mehrere Filter haben, werden sie automatisch durch den logischen Wert AND verbunden, sofern Sie nicht den Filter OR einfügen. Im folgenden Screenshot sind alle Benachrichtigungsrichtlinien aufgelistet, die mit test oder My Uptime Check Alert Policy übereinstimmen:

Übersicht über Beispielbenachrichtigungen mit Filtern.

Im Fenster Policies (Richtlinien) können Sie eine Benachrichtigungsrichtlinie bearbeiten, löschen, kopieren, aktivieren oder deaktivieren:

  • Klicken Sie zum Bearbeiten oder Kopieren einer Richtlinie auf Mehr Optionen und wählen Sie die entsprechende Option aus. Beim Bearbeiten und Kopieren einer Richtlinie gehen Sie ähnlich wie beim Erstellen einer Benachrichtigungsrichtlinie vor. Sie können die Werte in den Feldern ändern und in einigen Fällen löschen. Wenn Sie fertig sind, klicken Sie auf Save (Speichern).

  • Klicken Sie zum Löschen einer Richtlinie auf Mehr Optionen und wählen Sie Löschen aus. Wählen Sie im Bestätigungsfenster noch einmal Delete (Löschen) aus.

  • Wenn Sie den aktivierten Status der Benachrichtigungsrichtlinie ändern möchten, klicken Sie auf die Ein-/Aus-Schaltfläche unter der Überschrift Enabled (Aktiviert).

Wenn Sie eine Benachrichtigungsrichtlinie auswählen, werden die Policy details (Richtliniendetails) angezeigt. Der folgende Screenshot zeigt beispielsweise die Details für die Benachrichtigungsrichtlinie My Uptime Check Alert Policy:

Beispielseite mit Details zur Benachrichtigungsrichtlinie.

Sie können Benachrichtigungsrichtlinien im Fenster Policy details (Richtliniendetails) bearbeiten, löschen, kopieren, aktivieren oder deaktivieren. Wenn Sie beispielsweise eine Benachrichtigungsrichtlinie deaktivieren möchten, die derzeit aktiviert ist, klicken Sie auf Enabled (Aktiviert) und wählen Sie Turn off (Deaktivieren) aus. Zum Aktivieren einer Richtlinie, die derzeit deaktiviert ist, klicken Sie auf Disabled (Deaktiviert).