Mit Benachrichtigungsrichtlinien arbeiten

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 9.x unterstützen.

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 10

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8

Benachrichtigungsrichtlinien bestimmen, wie Warnmeldungen an Kontaktstellen weitergeleitet werden. Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere untergeordnete Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Stammrichtlinie, kann auch bestimmten Warnmeldungsbezeichnungen entsprechen. Jede Warnung wird anhand der Stammrichtlinie und anschließend anhand jeder untergeordneten Richtlinie bewertet. Wenn Sie die Continue matching subsequent sibling nodes Option für eine bestimmte Richtlinie aktivieren, wird die Auswertung auch nach einer oder mehreren Übereinstimmungen fortgesetzt. Die Konfigurationseinstellungen und Kontaktpunktinformationen einer übergeordneten Richtlinie regeln das Verhalten einer Warnung, die keiner der untergeordneten Richtlinien entspricht. Eine Stammrichtlinie regelt jede Warnung, die keiner bestimmten Richtlinie entspricht.

Anmerkung

Sie können Benachrichtigungsrichtlinien für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Benachrichtigungsrichtlinien für Alertmanager-Benachrichtigungen sind schreibgeschützt.

Benachrichtigungen gruppieren

Durch die Gruppierung werden Warnmeldungen ähnlicher Art in einem einzigen Trichter kategorisiert. Auf diese Weise können Sie die Warnmeldungen bei größeren Ausfällen steuern, wenn viele Teile eines Systems gleichzeitig ausfallen und dadurch eine große Anzahl von Alarmen gleichzeitig ausgelöst wird.

Beispiel für eine Gruppierung

Angenommen, Sie haben 100 Dienste in verschiedenen Umgebungen mit einer Datenbank verbunden. Diese Dienste unterscheiden sich anhand der Bezeichnungenv=environmentname. Es gibt eine Warnregel, mit der überwacht wird, ob Ihre Dienste die Datenbank erreichen können. Die Warnungsregel erstellt Warnungen mit dem Namenalertname=DatabaseUnreachable.

Wenn eine Netzwerkpartition auftritt, bei der die Hälfte Ihrer Dienste die Datenbank nicht mehr erreichen kann, werden 50 verschiedene Warnungen ausgelöst. In diesem Fall möchten Sie eine einseitige Benachrichtigung (statt 50) mit einer Liste der betroffenen Umgebungen erhalten.

Sie können die Gruppierung so konfigurieren group_by: [alertname] (ohne die env Bezeichnung zu verwenden, die für jeden Dienst unterschiedlich ist). Wenn diese Konfiguration eingerichtet ist, sendet Grafana eine einzige kompakte Benachrichtigung, die alle betroffenen Umgebungen für diese Warnregel enthält.

Spezielle Gruppen

Grafana hat zwei spezielle Gruppen. Die Standardgruppe group_by: null gruppiert alle Alarme in einer einzigen Gruppe. Sie können auch eine spezielle Bezeichnung verwenden, um Benachrichtigungen ... nach allen Bezeichnungen zu gruppieren, wodurch die Gruppierung effektiv deaktiviert wird und jede Warnung in eine eigene Gruppe gesendet wird.

Working with notifications

Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten.

Um die Root-Benachrichtigungsrichtlinie zu bearbeiten

1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das Alerting (Glockensymbol), um die Alerting-Seite zu öffnen.

2. Wählen Sie Benachrichtigungsrichtlinien aus.

3. Wählen Sie im Drop-down-Menü Alertmanager den Alertmanager aus, den Sie bearbeiten möchten.

4. Wählen Sie im Bereich Root-Richtlinie das Symbol Bearbeiten (Stift) aus.

5. Aktualisieren Sie unter Standardkontaktpunkt die Kontaktstelle, an die Benachrichtigungen für Regeln gesendet werden sollen, wenn die Warnungsregeln keiner bestimmten Richtlinie entsprechen.

6. Wählen Sie unter Gruppieren nach die Labels (oder speziellen Gruppen) aus, nach denen Benachrichtigungen gruppiert werden sollen.

7. Wählen Sie unter Zeitoptionen eine der folgenden Optionen aus.

   • Wartezeit für Gruppen — Wartezeit bis zum Zwischenspeichern von Warnmeldungen derselben Gruppe, bevor eine erste Benachrichtigung gesendet wird. Standardmäßig ist ein Zeitraum von 30 Sekunden festgelegt.

   • Gruppenintervall — Minimales Zeitintervall zwischen zwei Benachrichtigungen für eine Gruppe. Der Standardwert ist 5 Minuten.

   • Wiederholungsintervall — Minimales Zeitintervall vor dem erneuten Senden einer Benachrichtigung, wenn der Gruppe keine neuen Benachrichtigungen hinzugefügt wurden. Die Standardeinstellung ist 4 Stunden.

8. Wählen Sie Speichern, um Ihre Änderungen zu speichern.

Um eine neue, spezifische Richtlinie auf oberster Ebene hinzuzufügen

1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das Alerting (Glockensymbol), um die Alerting-Seite zu öffnen.

2. Wählen Sie Benachrichtigungsrichtlinien aus.

3. Wählen Sie im Drop-down-Menü Alertmanager den Alertmanager aus, den Sie bearbeiten möchten.

4. Wählen Sie im Abschnitt Spezifisches Routing die Option Neue spezifische Richtlinie aus.

5. Fügen Sie im Abschnitt Passende Labels ein oder mehrere passende Warnungslabels hinzu. Weitere Informationen zum Abgleich von Bezeichnungen finden Sie weiter unten in diesem Thema.

6. Fügen Sie unter Kontaktpunkt die Kontaktstelle hinzu, an die Benachrichtigungen gesendet werden sollen, wenn die Warnung dieser speziellen Richtlinie entspricht. Verschachtelte Richtlinien haben Vorrang vor dieser Kontaktstelle.

7. Aktivieren Sie optional die Option Mit dem Abgleich aufeinanderfolgender gleichgeordneter Knoten fortfahren, um den Abgleich von Richtlinien für gleichgeordnete Knoten auch dann fortzusetzen, wenn die Warnung mit der aktuellen Richtlinie übereinstimmt. Wenn diese Richtlinie aktiviert ist, können Sie mehr als eine Benachrichtigung für dieselbe Warnung erhalten.

8. Wählen Sie optional Gruppierung überschreiben, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet.

9. Wählen Sie optional Allgemeine Zeitangaben außer Kraft setzen, um die Zeitoptionen in der Gruppenbenachrichtigungsrichtlinie außer Kraft zu setzen.

10. Wählen Sie Richtlinie speichern aus, um Ihre Änderungen zu speichern.

Um eine verschachtelte Richtlinie hinzuzufügen

1. Erweitern Sie die spezifische Richtlinie, unter der Sie eine verschachtelte Richtlinie erstellen möchten.

2. Wählen Sie Verschachtelte Richtlinie hinzufügen und fügen Sie dann die Details hinzu (wie beim Hinzufügen einer spezifischen Richtlinie der obersten Ebene).

3. Wählen Sie Richtlinie speichern aus, um Ihre Änderungen zu speichern.

Um eine bestimmte Richtlinie zu bearbeiten

1. Wählen Sie auf der Seite „Benachrichtigungen“ die Option Benachrichtigungsrichtlinien aus, um die Seite mit den vorhandenen Richtlinien zu öffnen.

2. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und klicken Sie dann auf das Symbol Bearbeiten (Stift).

3. Nehmen Sie alle Änderungen vor (z. B. beim Hinzufügen einer spezifischen Richtlinie auf oberster Ebene).

4. Wählen Sie Richtlinie speichern.

Auf der Suche nach Richtlinien

Sie können im Richtlinienbaum nach Label-Matchern oder Kontaktstellen suchen.

• Um nach Kontaktstelle zu suchen, geben Sie einen vollständigen oder vollständigen Namen einer Kontaktstelle in das Feld Nach Kontaktstelle suchen ein.

• Um nach Label zu suchen, geben Sie einen gültigen Label-Matcher in das Feld Nach Label suchen ein. Es können mehrere Matcher eingegeben werden, getrennt durch ein Komma. Eine gültige Matcher-Eingabe könnte beispielsweise sein. severity=high, region=~EMEA|NA

  Anmerkung

  Bei der Suche nach Bezeichnungen werden alle übereinstimmenden Richtlinien exakt übereinstimmen. Partielle Übereinstimmungen und Übereinstimmungen im Regex-Stil werden nicht unterstützt.

So funktioniert der Labelabgleich

Eine Richtlinie entspricht einer Warnung, wenn die Bezeichnungen der Warnung mit allen in der Richtlinie angegebenen übereinstimmenden Labels übereinstimmen.

• Bezeichnung — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen.

• Operator — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind:

  • =Wählen Sie Beschriftungen aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt.

  • !=Wählen Sie Beschriftungen aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt.

  • =~Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert).

  • !=Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen.

• Wert — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen.