Konfigurieren Sie die verwalteten Warnungsregeln von Grafana

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

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

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

Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Warnmeldungen zu erstellen, die auf Daten aus allen von uns unterstützten Datenquellen reagieren können. Neben der Unterstützung mehrerer Datenquellen können Sie auch Ausdrücke hinzufügen, um Ihre Daten zu transformieren und Warnbedingungen festzulegen. Die Verwendung von Bildern in Warnmeldungen wird ebenfalls unterstützt. Dies ist der einzige Regeltyp, der Warnmeldungen aus mehreren Datenquellen in einer einzigen Regeldefinition ermöglicht.

Als Ergebnis einer Warnungsregel (auch bekannt als multidimensionale Warnung) können mehrere Warnungsinstanzen erstellt werden.

Von Grafana verwaltete Warnungsregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind.

Wenn Sie eine in der Benutzeroberfläche erstellte Warnressource löschen, können Sie sie nicht mehr abrufen. Um eine Sicherungskopie Ihrer Konfiguration zu erstellen und gelöschte Alert-Ressourcen wiederherstellen zu können, erstellen Sie Ihre Alert-Ressourcen mit Terraform oder der Alerting API.

In den folgenden Verfahren gehen wir den Prozess der Erstellung Ihrer von Grafana verwalteten Warnregeln durch.

Um eine von Grafana verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Benachrichtigungen im Arbeitsbereich und folgen Sie diesen Schritten, um Ihnen zu helfen.

Geben Sie den Namen der Warnungsregel

1. Wählen Sie Alerts & IRM -> Warnungsregeln -> + Neue Warnungsregel aus.

2. Geben Sie einen Namen ein, um Ihre Warnungsregel zu identifizieren.

   Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die alertname Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.

Definieren Sie als Nächstes eine Abfrage, um die Daten abzurufen, die Sie messen möchten, sowie eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.

Um die Abfrage und die Bedingung zu definieren

1. Wählen Sie eine Datenquelle aus.

2. Geben Sie in der Dropdownliste Optionen einen Zeitraum an.

   Anmerkung

   Grafana Alerting unterstützt beispielsweise nur feste relative Zeitbereiche. now-24hr: now

   Absolute Zeitbereiche: 2021-12-02 00:00:00 to 2021-12-05 23:59:592 oder halbrelative Zeitbereiche: werden nicht unterstützt. now/d to: now

3. Fügen Sie eine Abfrage hinzu.

   Um mehrere Abfragen hinzuzufügen, wählen Sie Abfrage hinzufügen.

   Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Wenn Sie zu einer von einer Datenquelle verwalteten Warnungsregel wechseln möchten, klicken Sie auf Zu einer von einer Datenquelle verwalteten Warnungsregel wechseln.

4. Fügen Sie einen oder mehrere Ausdrücke hinzu.

   1. Wählen Sie für jeden Ausdruck entweder klassische Bedingung aus, um eine einzelne Warnungsregel zu erstellen, oder wählen Sie aus den Optionen Math, Reduce und Resample, um für jede Serie eine separate Warnung zu generieren.

      Anmerkung

      Wenn Sie Prometheus verwenden, können Sie einen Instant-Vektor und integrierte Funktionen verwenden, sodass Sie keine zusätzlichen Ausdrücke hinzufügen müssen.

   2. Wählen Sie Vorschau, um zu überprüfen, ob der Ausdruck erfolgreich ist.

5. [Optional] Um einen Wiederherstellungsschwellenwert hinzuzufügen, aktivieren Sie die Option Benutzerdefinierter Wiederherstellungsschwellenwert und geben Sie einen Wert ein, ab dem Ihre Warnungsregel nicht mehr ausgelöst werden soll.

   Sie können einer Abfrage nur einen Wiederherstellungsschwellenwert hinzufügen, und es muss sich dabei um die Alarmbedingung handeln.

6. Wählen Sie In der Abfrage oder dem Ausdruck, den Sie als Warnbedingung festlegen möchten, die Option Als Warnbedingung festlegen aus.

Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden sollte und wie schnell sie ihren Status ändern sollte.

Dazu müssen Sie sicherstellen, dass sich Ihre Warnungsregel in der richtigen Bewertungsgruppe befindet, und einen Wartezeitraum festlegen, der für Ihren Anwendungsfall am besten geeignet ist.

So legen Sie das Verhalten bei der Auswertung von Warnungen fest

1. Wählen Sie einen Ordner aus oder wählen Sie + Neuer Ordner.

2. Wählen Sie eine Bewertungsgruppe aus oder klicken Sie auf + Neue Bewertungsgruppe.

   Wenn Sie eine neue Bewertungsgruppe erstellen, geben Sie das Intervall für die Gruppe an.

   Alle Regeln innerhalb derselben Gruppe werden gleichzeitig über dasselbe Zeitintervall ausgewertet.

3. Geben Sie einen ausstehenden Zeitraum ein.

   Der Wartezeitraum ist der Zeitraum, in dem eine Warnungsregel gegen die Bedingung verstoßen kann, bis sie ausgelöst wird.

   Sobald eine Bedingung erfüllt ist, geht die Warnung in den Status Ausstehend über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den Status Auslösung, andernfalls kehrt sie in den Status Normal zurück.

4. Aktivieren Sie bei Bedarf die Benachrichtigungen mit Pausenwarnungen.

   Anmerkung

   Unterbrechen Sie die Auswertung der Warnungsregeln, um bei der Optimierung Ihrer Benachrichtigungen zu laute Warnmeldungen zu vermeiden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.

   Sie können die Auswertung von Warnungsregeln pausieren, um zu verhindern, dass bei der Optimierung Ihrer Warnmeldungen laute Warnmeldungen ausgegeben werden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.

5. Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung das Warnverhalten bei fehlenden Daten.

   Beachten Sie die Richtlinien weiter unten in diesem Abschnitt.

Fügen Sie Ihren Warnungsregeln Labels hinzu, um festzulegen, welche Benachrichtigungsrichtlinie Ihre Auslösewarnungen behandeln soll.

Alle Warnungsregeln und -instanzen, unabhängig von ihren Bezeichnungen, entsprechen der Standardbenachrichtigungsrichtlinie. Wenn es keine verschachtelten Richtlinien gibt oder keine verschachtelten Richtlinien den Bezeichnungen in der Warnungsregel oder Warnungsinstanz entsprechen, ist die Standardbenachrichtigungsrichtlinie die entsprechende Richtlinie.

So konfigurieren Sie Benachrichtigungen

1. Fügen Sie Labels hinzu, wenn Sie die Art und Weise ändern möchten, wie Ihre Benachrichtigungen weitergeleitet werden.

   Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.

2. Zeigen Sie eine Vorschau Ihrer Einrichtung für das Routing Ihrer Alert-Instanz an.

   Basierend auf den hinzugefügten Labels werden Warnungsinstanzen an die angezeigten Benachrichtigungsrichtlinien weitergeleitet.

   Erweitern Sie die einzelnen Benachrichtigungsrichtlinien, um weitere Details anzuzeigen.

3. Wählen Sie Details anzeigen aus, um Details zur Weiterleitung von Benachrichtigungen und eine Vorschau anzuzeigen.

Fügen Sie Anmerkungen hinzu, um mehr Kontext zu der Warnung in Ihrer Warnmeldung bereitzustellen.

Anmerkungen fügen Metadaten hinzu, um weitere Informationen zu der Warnung in Ihrer Warnmeldung bereitzustellen. Fügen Sie beispielsweise eine Anmerkung mit einer Zusammenfassung hinzu, um zu erfahren, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie aufgetreten ist.

Um Anmerkungen hinzuzufügen

1. [Optional] Fügen Sie eine Zusammenfassung hinzu.

   Kurze Zusammenfassung dessen, was passiert ist und warum.

2. [Optional] Fügen Sie eine Beschreibung hinzu.

   Beschreibung der Funktion der Warnungsregel.

3. [Optional] Fügen Sie eine Runbook-URL hinzu.

   Webseite, auf der Sie Ihr Runbook für die Warnung aufbewahren

4. [Optional] Fügen Sie eine benutzerdefinierte Anmerkung hinzu

5. [Optional] Fügen Sie ein Dashboard und einen Panel-Link hinzu.

   Verknüpft Benachrichtigungen mit Bedienfeldern in einem Dashboard.

6. Wählen Sie Save rule (Regel speichern).

Ein- und mehrdimensionale Regel

Für von Grafana verwaltete Benachrichtigungen können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen.

• Regel mit klassischer Bedingung

  Verwenden Sie den klassischen Bedingungsausdruck, um eine Regel zu erstellen, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Bei einer Abfrage, die mehrere Serien zurückgibt, verfolgt Grafana nicht den Alarmstatus jeder Serie. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.

• Mehrdimensionale Regel

  Um für jede Serie eine separate Warnung zu generieren, erstellen Sie eine mehrdimensionale Regel. Verwenden Sie Resample Ausdrücke MathReduce, oder, um eine mehrdimensionale Regel zu erstellen. Beispielsweise:

  • Fügen Sie für jede Abfrage einen Reduce Ausdruck hinzu, um Werte im ausgewählten Zeitraum zu einem einzigen Wert zusammenzufassen (nicht erforderlich für Regeln, die numerische Daten verwenden).

  • Fügen Sie einen Math Ausdruck mit der Bedingung für die Regel hinzu. Nicht erforderlich, falls eine Abfrage oder ein Reduce-Ausdruck bereits zurückgibt, 0 ob die Regel nicht ausgelöst werden soll, oder eine positive Zahl, wenn sie ausgelöst werden soll. Einige Beispiele: $B > 70 ob es ausgelöst werden soll, falls der Wert der B-Abfrage/des Ausdrucks größer als 70 ist. $B < $C * 100falls es ausgelöst werden sollte, wenn der Wert von B kleiner als der Wert von C multipliziert mit 100 ist. Wenn die Ergebnisse von Abfragen, die verglichen werden, mehrere Reihen enthalten, werden Reihen aus verschiedenen Abfragen abgeglichen, wenn sie dieselben Beschriftungen haben oder eine eine Teilmenge der anderen ist.

Anmerkung

Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden Sie unter https://community.grafana.com/t/ template-variables-are-not - supported-in-alert-queries - while-setting-up-alert /2514.

Konfigurieren Sie keine Daten und Fehlerbehandlung

Konfigurieren Sie das Warnverhalten, wenn Ihre Warnungsregelauswertung keine Daten oder einen Fehler zurückgibt.

Anmerkung

Warnungsregeln, die so konfiguriert sind, dass sie ausgelöst werden, wenn eine Auswertung keine Daten oder einen Fehler zurückgibt, werden nur ausgelöst, wenn der gesamte Evaluierungszeitraum abgelaufen ist. Das bedeutet, dass die Warnungsregel nicht sofort ausgelöst wird, wenn die Bedingung der Warnungsregel verletzt wird, sondern wartet, bis die für das Feld Für festgelegte Zeit abgelaufen ist, und wird dann ausgelöst, wodurch Warngeräusche reduziert werden und vorübergehende Probleme mit der Datenverfügbarkeit möglich sind.

Wenn bei der Auswertung der Warnungsregel keine Daten zurückgegeben werden, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:

Keine Daten	Beschreibung
Keine Daten	Erstellt eine neue Warnung DatasourceNoData mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen.
Warnfunktion	Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird.
Ok	Setzt den Status der Warnungsregel aufNormal.

Wenn Ihre Auswertung einen Fehler ergibt, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:

Fehler	Beschreibung
Fehler	Erstellt eine Warnungsinstanz DatasourceError mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen.
Warnfunktion	Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird.
Ok	Setzt den Status der Warnungsregel aufNormal.

Löst veraltete Warnungsinstanzen

Eine Warnungsinstanz gilt als veraltet, wenn ihre Dimension oder Serie für zwei Bewertungsintervalle vollständig aus den Abfrageergebnissen verschwunden ist.

Veraltete Warnungsinstanzen im StatusAlerting/NoData/Errorwerden automatisch als markiert, Resolved und die grafana_state_reason Anmerkung wird der Warnungsinstanz mit dem Grund hinzugefügt. MissingSeries

Erstellen Sie Warnmeldungen aus Panels

Erstellen Sie Benachrichtigungen aus einem beliebigen Panel-Typ. Das bedeutet, dass Sie die Abfragen im Panel wiederverwenden und darauf basierende Benachrichtigungen erstellen können.

1. Navigieren Sie im Bereich Dashboards zu einem Dashboard.

2. Wählen Sie in der oberen rechten Ecke des Panels die drei Punkte (Ellipsen) aus.

3. Wählen Sie im Dropdownmenü die Option Mehr... und wählen Sie dann Neue Warnungsregel aus.

Dadurch wird das Formular für Warnungsregeln geöffnet, in dem Sie Ihre Warnung auf der Grundlage der Abfrage des aktuellen Panels konfigurieren und erstellen können.