Mit Benachrichtigungsrichtlinien arbeiten

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 8.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 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9

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 Warnbezeichnungen 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.

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.

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. Wählen Sie optional Gruppierung überschreiben aus, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet.

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

9. 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.

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.

Timings stummschalten

Eine Stummschaltung ist ein wiederkehrendes Zeitintervall, in dem keine neuen Benachrichtigungen für eine Richtlinie generiert oder gesendet werden. Verwenden Sie sie, um zu verhindern, dass Warnmeldungen für einen bestimmten und sich wiederholenden Zeitraum ausgelöst werden, z. B. während eines regulären Wartungszeitraums.

Ähnlich wie bei Stummschaltungen verhindern auch Stummschaltungen nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern auch nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Sie verhindern lediglich, dass Benachrichtigungen erstellt werden.

Sie können von Grafana verwaltete Stummschaltezeiten sowie Stummschaltezeiten für eine externe Alertmanager-Datenquelle konfigurieren.

Stummschaltungen im Vergleich zu Stummschaltungen

In der folgenden Tabelle werden die Unterschiede zwischen Stummschaltezeiten und Stummschaltungen hervorgehoben.

Timing stummschalten	Schweigen
Verwendet Zeitintervalldefinitionen, die sich wiederholen können	Hat eine feste Start- und Endzeit
Wird erstellt und dann zu den Benachrichtigungsrichtlinien hinzugefügt	Verwendet Labels, um mit einer Warnung abzugleichen, um zu bestimmen, ob sie stummgeschaltet werden soll oder nicht

Um ein Timing zum Stummschalten zu erstellen

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.

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

4. Wählen Sie im Bereich Timings für die Stummschaltung die Schaltfläche Timing für Stummschaltung hinzufügen aus.

5. Wählen Sie das Zeitintervall aus, für das die Stummschaltung gelten soll.

6. Wählen Sie „Senden“, um die Stummschaltung festzulegen.

Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen

1. Wählen Sie die Benachrichtigungsrichtlinie aus, zu der Sie die Stummschaltung hinzufügen möchten, und klicken Sie auf die Schaltfläche Bearbeiten.

2. Wählen Sie in der Dropdownliste für die Stummschaltung die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten.

   Wählen Sie die Schaltfläche Richtlinie speichern.

Zeitintervalle

Ein Zeitintervall ist eine Definition für einen Zeitbereich. Wenn während dieses Intervalls eine Warnung ausgelöst wird, wird sie unterdrückt. Bereiche werden unterstützt mit : (zum Beispielmonday:thursday). Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten. Ein Zeitintervall besteht aus mehreren Feldern (Details in der folgenden Liste), die alle übereinstimmen müssen, damit die Alerts unterdrückt werden. Wenn Sie beispielsweise Wochentage und einen Zeitraum zwischen 8:00 monday:friday und 9:00 Uhr angeben, werden Benachrichtigungen von Montag bis Freitag von 8 bis 9 Uhr unterdrückt, aber nicht beispielsweise von 8 bis 9 Uhr am Samstag.

• Zeitraum — Die Tageszeit, zu der Benachrichtigungen unterdrückt werden sollen. Besteht aus zwei Unterfeldern: Startzeit und Endzeit. Ein Beispiel für die Zeit ist14:30. Die Uhrzeit wird in 24-Stunden-Notation in UTC angegeben.

• Wochentage — Die Wochentage. Dabei kann es sich um einen einzelnen Tag handelnmonday, z. B. um einen Bereichmonday:friday, oder um eine durch Kommas getrennte Liste von Tagen, z. B. monday, tuesday, wednesday

• Monate — Die Monate, die ausgewählt werden sollen. Sie können Monate mit numerischen Bezeichnungen oder mit dem vollständigen Monatsnamen angeben, 1 oder january beide geben Januar an. Sie können einen einzelnen Monat, einen Bereich von Monaten oder eine durch Kommas getrennte Liste von Monaten angeben.

• Tage des Monats — Die Daten innerhalb eines Monats. Die Werte können im Bereich von 1 - liegen31. Negative Werte geben die Tage des Monats in umgekehrter Reihenfolge an, -1 stellen also den letzten Tag des Monats dar. Tage des Monats können als einzelner Tag, als Bereich von Tagen oder als durch Kommas getrennte Liste von Tagen angegeben werden.