Konfigurieren von mit Datenquellen verwalteten Warnungsregeln

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

Erstellen Sie Warnungsregeln für eine externe Instanz von Grafana Mimir oder Loki, für die das Lineal API aktiviert ist. Diese werden als datenquellenverwaltete Warnungsregeln bezeichnet.

Anmerkung

Warnungsregeln für eine externe Grafana Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.

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 dem Alerting. API

Voraussetzungen

• Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus- oder Loki-Datenquelle haben. Andernfalls können Sie keine verwalteten Alarmregeln von Grafana Mimir erstellen oder aktualisieren.

• Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen den Ruler, API indem Sie ihre jeweiligen Dienste konfigurieren.

  • Loki — Der local Regelspeichertyp, standardmäßig für die Loki-Datenquelle, unterstützt nur die Anzeige von Regeln. Um Regeln zu bearbeiten, konfigurieren Sie einen der anderen Regelspeichertypen.

  • Grafana Mimir - benutze das /prometheus Präfix. Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sowohl Query API als auch Ruler unter demselben stehen. API URL Sie können keinen separaten Wert für das Lineal angeben. URL API

Anmerkung

Wenn Sie keine Warnungsregeln für eine bestimmte Loki- oder Prometheus-Datenquelle verwalten möchten, gehen Sie zu deren Einstellungen und deaktivieren Sie das Kontrollkästchen Benachrichtigungen über die Alerting-Benutzeroberfläche verwalten.

In den folgenden Verfahren führen wir Sie durch den Prozess der Erstellung Ihrer durch eine Datenquelle verwalteten Warnregeln.

Um eine von einer Datenquelle verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Warnungen im Workspace und befolgen Sie die folgenden Schritte, um Ihnen zu helfen.

So legen Sie den Namen der Warnungsregel fest

1. Wählen Sie Warnung -> Warnungsregeln -> + Neue Warnungsregel.

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 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 eine Abfrage und eine Bedingung zu definieren

1. Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Um zu einer von einer Datenquelle verwalteten Warnregel zu wechseln, wählen Sie Zu einer von einer Datenquelle verwalteten Warnungsregel wechseln.

2. Wählen Sie eine Datenquelle aus der Dropdownliste aus.

   Sie können auch „Erweiterte Datenquellenauswahl öffnen“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren).

3. Geben Sie eine PromQL- oder LogQL-Abfrage ein.

4. Wählen Sie Warnmeldungen in der Vorschau aus.

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

So legen Sie das Verhalten bei der Auswertung von Warnungen fest

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

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

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

   Alle Regeln innerhalb derselben Gruppe werden nacheinander ü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 Pending Status über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den Firing Status, andernfalls kehrt sie in den Normal Status zurück.

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.

Konfigurieren von -Benachrichtigungen

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

Fügen Sie Anmerkungen hinzu, um in Ihren Warnmeldungen mehr Kontext zur Warnung bereitzustellen.

Anmerkungen fügen Metadaten hinzu, um mehr Informationen zur Warnung in Ihren Warnmeldungen bereitzustellen. Fügen Sie beispielsweise eine Summary Anmerkung hinzu, die Ihnen mitteilt, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie ausgelöst wurde.

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 ein 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).