Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Benachrichtigungen in Grafana-Version 9
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Grafana-Alerting bietet Ihnen robuste und umsetzbare Warnmeldungen, mit denen Sie sofort nach ihrem Auftreten über Probleme in den Systemen informiert werden können, wodurch Unterbrechungen Ihrer Dienste minimiert werden.
Amazon Managed Grafana bietet Zugriff auf ein aktualisiertes Warnsystem, *Grafana Alerting, das Warninformationen* in einer einzigen, durchsuchbaren Ansicht zentralisiert. Es umfasst die folgenden Funktionen:
+ Erstellen und verwalten Sie Grafana-Benachrichtigungen in einer zentralen Ansicht.
+ Erstellen und verwalten Sie verwaltete Cortex- und Loki-Benachrichtigungen über eine einzige Oberfläche.
+ Zeigen Sie Warninformationen von Prometheus, Amazon Managed Service for Prometheus und anderen AlertManager-kompatiblen Datenquellen an.
Wenn Sie Ihren Amazon Managed Grafana-Workspace erstellen, haben Sie die Wahl, Grafana-Benachrichtigungen zu verwenden oder die. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md) In diesem Abschnitt wird die Grafana-Warnung behandelt.
**Anmerkung**
Wenn Sie Ihren Workspace mit aktivierten klassischen Benachrichtigungen erstellt haben und zu Grafana-Benachrichtigungen wechseln möchten, können Sie [zwischen den beiden Warnsystemen wechseln](v9-alerting-use-grafana-alerts.md). .
## Einschränkungen bei Grafana-Benachrichtigungen
+ Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Amazon Managed Service für Prometheus-, Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Regeln aus anderen unterstützten Datenquellen abzurufen.
+ Warnregeln, die in Grafana und nicht in Prometheus definiert sind, senden mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Benachrichtigungen anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für in Prometheus Alertmanager erstellte Warnungen sendet.
**Anmerkung**
Diese Einschränkung gilt nicht mehr für Amazon Managed Grafana-Arbeitsbereiche, die Grafana v10.4 und höher unterstützen.
**Topics**
+ [Einschränkungen bei Grafana-Benachrichtigungen](#v9-alert-limitations)
+ [-Übersicht](v9-alerting-overview.md)
+ [Alerting erkunden](v9-alerting-explore.md)
+ [Alerting einrichten](v9-alerting-setup.md)
+ [Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen](v9-alerting-use-grafana-alerts.md)
+ [Verwalte deine Alarmregeln](v9-alerting-managerules.md)
+ [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md)
# -Übersicht
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Im Folgenden erhalten Sie einen Überblick über die Funktionsweise von Grafana Alerting und stellen Ihnen einige der wichtigsten Konzepte vor, die zusammenarbeiten und den Kern der flexiblen und leistungsstarken Alerting Engine bilden.
1. **Datenquelle**
Stellt eine Verbindung zu Daten her, die für Alerting verwendet werden sollen. Bei diesen Daten handelt es sich häufig um Zeitreihendaten für Warnmeldungen. Sie zeigen die Details eines Systems, das überwacht und analysiert werden soll. Weitere Informationen finden Sie unter [Datenquellen](AMG-data-sources-builtin.md).
1. **Regeln für Warnmeldungen**
Legen Sie Bewertungskriterien fest, die bestimmen, ob eine Warnungsinstanz ausgelöst wird. Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken zum Abrufen von Daten aus der Datenquelle, einer Bedingung, die beschreibt, warum eine Warnung erforderlich ist, wie häufig sie ausgewertet wird und optional, für welche Dauer die Bedingung erfüllt sein muss, damit eine Warnung ausgelöst wird.
Von Grafana verwaltete Benachrichtigungen unterstützen mehrdimensionale Benachrichtigungen, was bedeutet, dass jede Warnungsregel mehrere Warnungsinstanzen erstellen kann. Dies ist besonders leistungsstark, wenn Sie mehrere Serien in einem einzigen Ausdruck beobachten.
1. **Labels**
Ordnen Sie eine Warnungsregel und ihre Instanzen den Benachrichtigungsrichtlinien und der Stummschaltung zu. Sie können auch verwendet werden, um Ihre Benachrichtigungen nach Schweregrad zu gruppieren.
1. **Richtlinien für Benachrichtigungen**
Lege fest, wo, wann und wie die Benachrichtigungen weitergeleitet werden, um dein Team zu benachrichtigen, wenn die Warnung ausgelöst wird. Jede Benachrichtigungsrichtlinie gibt eine Reihe von Label-Matchern an, die angeben, für welche Benachrichtigungen sie verantwortlich sind. Einer Benachrichtigungsrichtlinie ist eine Kontaktstelle zugewiesen, die aus einem oder mehreren Meldern besteht.
1. **Kontaktstellen**
Definieren Sie, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Wir unterstützen eine Vielzahl von ChatOps Tools, um sicherzustellen, dass die Benachrichtigungen Ihr Team erreichen.
## Features
**Eine Seite für alle Benachrichtigungen**
Eine einzige Grafana-Warnseite konsolidiert sowohl von Grafana verwaltete Benachrichtigungen als auch Benachrichtigungen, die sich in Ihrer Promethus-kompatiblen Datenquelle befinden, an einem einzigen Ort.
**Mehrdimensionale Warnmeldungen**
Mit Warnungsregeln können mehrere einzelne Warnungsinstanzen pro Warnungsregel erstellt werden, die als multidimensionale Warnungen bezeichnet werden. So erhalten Sie die Möglichkeit und Flexibilität, mit nur einer einzigen Warnung einen Überblick über Ihr gesamtes System zu erhalten.
**Weiterleitung von Warnmeldungen**
Leiten Sie jede Warnungsinstanz auf der Grundlage der von Ihnen definierten Labels an einen bestimmten Kontaktpunkt weiter. Bei Benachrichtigungsrichtlinien handelt es sich um ein Regelwerk, das festlegt, wo, wann und wie die Benachrichtigungen an Kontaktstellen weitergeleitet werden.
**Warnmeldungen zum Schweigen bringen**
Stummschalten ermöglicht es Ihnen, den Empfang permanenter Benachrichtigungen von einer oder mehreren Warnregeln zu beenden. Sie können eine Warnung auch auf der Grundlage bestimmter Kriterien teilweise pausieren. Für automatische Benachrichtigungen gibt es einen eigenen Bereich, der der besseren Organisation und Sichtbarkeit dient. So können Sie Ihre Regeln für pausierte Alarme überprüfen, ohne dass die Hauptansicht der Warnmeldungen überladen wird.
**Timings stummschalten**
Mit den Zeiten für die Stummschaltung können Sie ein Zeitintervall angeben, in dem keine neuen Benachrichtigungen generiert oder gesendet werden sollen. Sie können Warnmeldungen auch für wiederkehrende Zeiträume einfrieren, z. B. während eines Wartungszeitraums.
# Alerting erkunden
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Unabhängig davon, ob Sie Ihre Implementierung von Grafana Alerting starten oder erweitern, erfahren Sie mehr über die wichtigsten Konzepte und verfügbaren Funktionen, mit denen Sie Ihre Benachrichtigungen erstellen, verwalten und darauf reagieren und die Fähigkeit Ihres Teams verbessern können, Probleme schnell zu lösen.
Schauen wir uns zunächst die verschiedenen Warnregeltypen an, die Grafana Alerting bietet.
## Arten von Warnungsregeln
**Von Grafana verwaltete Regeln**
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. Dies ist der einzige Regeltyp, der Warnmeldungen aus mehreren Datenquellen in einer einzigen Regeldefinition ermöglicht.
**Regeln für Mimir und Loki**
Um Mimir- oder Loki-Benachrichtigungen zu erstellen, benötigen Sie eine kompatible Prometheus- oder Loki-Datenquelle. Sie können überprüfen, ob Ihre Datenquelle die Regelerstellung über Grafana unterstützt, indem Sie die Datenquelle testen und beobachten, ob die Ruler-API unterstützt wird.
**Regeln aufzeichnen**
Aufzeichnungsregeln sind nur für kompatible Prometheus- oder Loki-Datenquellen verfügbar. Mit einer Aufzeichnungsregel können Sie häufig benötigte oder rechenintensive Ausdrücke vorab berechnen und deren Ergebnis als neue Zeitreihen speichern. Dies ist nützlich, wenn Sie Warnmeldungen zu aggregierten Daten ausführen möchten oder wenn Sie über Dashboards verfügen, die rechenintensive Ausdrücke wiederholt abfragen.
## Die wichtigsten Konzepte und Funktionen
Die folgende Tabelle enthält eine Liste der wichtigsten Konzepte, Funktionen und deren Definitionen, die Ihnen helfen sollen, Grafana Alerting optimal zu nutzen.
| Schlüsselkonzept oder Merkmal | Definition |
| --- | --- |
| Datenquellen für Warnmeldungen | Wählen Sie Datenquellen aus, aus denen Sie Metriken, Logs und Traces abfragen und visualisieren möchten. |
| Bereitstellung für Warnmeldungen | Verwalten Sie Ihre Alarmressourcen und stellen Sie sie mithilfe von Dateibereitstellung oder Terraform in Ihrem Grafana-System bereit. |
| Alertmanager | Verwaltet das Routing und die Gruppierung von Alert-Instanzen. |
| Warnungsregel | Eine Reihe von Bewertungskriterien für den Zeitpunkt, an dem eine Warnregel ausgelöst werden soll. Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und der Dauer, über die die Bedingung erfüllt wird. Eine Warnungsregel kann mehrere Warnungsinstanzen erzeugen. |
| Warnungsinstanz | Eine Warnungsinstanz ist eine Instanz einer Warnungsregel. Eine eindimensionale Warnungsregel hat eine Warnungsinstanz. Eine mehrdimensionale Warnungsregel hat eine oder mehrere Warnungsinstanzen. Eine einzelne Warnungsregel, die mehreren Ergebnissen entspricht, z. B. CPU gegen 10 VMs, wird als mehrere (in diesem Fall 10) Warnungsinstanzen gezählt. Diese Zahl kann im Laufe der Zeit variieren. Beispielsweise enthält eine Warnungsregel, die die CPU-Auslastung für alle VMs in einem System überwacht, mehr Warnungsinstanzen als hinzugefügt VMs werden. Weitere Informationen über Kontingente für Warnungsinstanzen finden Sie unter. [Fehler beim Erreichen des Kontingents](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached) |
| Warnungsgruppe | Der Alertmanager gruppiert Warnungsinstanzen standardmäßig anhand der Bezeichnungen für die Stammbenachrichtigungsrichtlinie. Dadurch werden die Deduplizierung und Gruppen von Warnungsinstanzen gesteuert, die an Kontaktstellen gesendet werden. |
| Kontaktstelle | Definieren Sie, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird. |
| Erstellung von Nachrichtenvorlagen | Erstellen Sie wiederverwendbare benutzerdefinierte Vorlagen und verwenden Sie sie in Kontaktpunkten. |
| Benachrichtigungsrichtlinie | Regelwerk, das festlegt, wo, wann und wie die Benachrichtigungen gruppiert und an Kontaktstellen weitergeleitet werden. |
| Labels und Label-Matcher | Mit Labels lassen sich Warnregeln eindeutig identifizieren. Sie verknüpfen Warnregeln mit Benachrichtigungsrichtlinien und Stummschaltungen und legen fest, welche Richtlinie sie behandeln soll und welche Warnregeln zum Schweigen gebracht werden sollen. |
| Schweigen | Stoppt Benachrichtigungen von einer oder mehreren Warnungsinstanzen. Der Unterschied zwischen einer Stille und einer Stummschaltung besteht darin, dass eine Stille nur für ein bestimmtes Zeitfenster andauert, wohingegen eine Stummschaltung dazu gedacht ist, sich nach einem bestimmten Zeitplan zu wiederholen. Verwendet Label-Matcher, um Warnungsinstanzen zum Schweigen zu bringen. |
| Timings stummschalten | Geben Sie ein Zeitintervall an, in dem keine neuen Benachrichtigungen generiert oder gesendet werden sollen. Sie können Warnmeldungen auch für wiederkehrende Zeiträume einfrieren, z. B. während eines Wartungszeitraums. Muss mit einer bestehenden Benachrichtigungsrichtlinie verknüpft sein. |
# Datenquellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Es gibt eine Reihe von [Datenquellen](AMG-data-sources-builtin.md), die mit Grafana Alerting kompatibel sind. Jede Datenquelle wird von einem Plugin unterstützt. Sie können eine der unten aufgeführten integrierten Datenquellen verwenden.
Dies sind die Datenquellen, die mit Amazon Managed Grafana kompatibel sind und von Amazon Managed Grafana unterstützt werden.
+ [Stellen Sie eine Connect zu einer AlertManager-Datenquelle her](data-source-alertmanager.md)
+ [Stellen Sie eine Connect zu einer CloudWatch Amazon-Datenquelle her](using-amazon-cloudwatch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Amazon OpenSearch Service-Datenquelle her](using-Amazon-OpenSearch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer AWS IoT SiteWise Datenquelle her](using-iotsitewise-in-AMG.md)
+ [Stellen Sie eine Connect zu einer AWS IoT TwinMaker Datenquelle her](AMG-iot-twinmaker.md)
+ [Connect zu Amazon Managed Service for Prometheus und Open-Source-Prometheus-Datenquellen her](prometheus-data-source.md)
+ [Stellen Sie eine Connect zu einer Amazon Timestream Timestream-Datenquelle her](timestream-datasource.md)
+ [Stellen Sie eine Connect zu einer Amazon Athena Athena-Datenquelle her](AWS-Athena.md)
+ [Stellen Sie eine Connect zu einer Amazon Redshift Redshift-Datenquelle her](AWS-Redshift.md)
+ [Connect zu einer AWS X-Ray Datenquelle herstellen](x-ray-data-source.md)
+ [Stellen Sie eine Connect zu einer Azure Monitor-Datenquelle her](using-azure-monitor-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Google Cloud Monitoring-Datenquelle her](using-google-cloud-monitoring-in-grafana.md)
+ [Stellen Sie eine Connect zu einer Graphite-Datenquelle her](using-graphite-in-AMG.md)
+ [Stellen Sie eine Connect zu einer InfluxDB-Datenquelle her](using-influxdb-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Loki-Datenquelle her](using-loki-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Microsoft SQL Server-Datenquelle her](using-microsoft-sql-server-in-AMG.md)
+ [Stellen Sie eine Connect zu einer MySQL-Datenquelle her](using-mysql-in-AMG.md)
+ [Stellen Sie eine Connect zu einer OpenTSDB-Datenquelle her](using-opentsdb-in-AMG.md)
+ [Stellen Sie eine Connect zu einer PostgreSQL-Datenquelle her](using-postgresql-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Jaeger-Datenquelle her](jaeger-data-source.md)
+ [Stellen Sie eine Connect zu einer Zipkin-Datenquelle her](zipkin-data-source.md)
+ [Mit einer Tempo-Datenquelle verbinden](tempo-data-source.md)
+ [Konfigurieren Sie eine TestData Datenquelle zum Testen](testdata-data-source.md)
# Über Warnungsregeln
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Eine Warnregel besteht aus einer Reihe von Bewertungskriterien, die bestimmen, ob eine Warnungsinstanz ausgelöst wird. Die Regel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, über die die Bedingung erfüllt wird.
Abfragen und Ausdrücke wählen zwar den Datensatz aus, der ausgewertet werden soll, aber eine Bedingung legt den Schwellenwert fest, den eine Warnung erfüllen oder überschreiten muss, um eine Warnung auszulösen.
Ein Intervall gibt an, wie oft eine Warnregel ausgewertet wird. Die Dauer gibt, sofern konfiguriert, an, wie lange eine Bedingung erfüllt sein muss. Die Warnungsregeln können auch das Warnverhalten bei fehlenden Daten definieren.
**Topics**
+ [Arten von Warnungsregeln](v9-alerting-explore-rules-types.md)
+ [Warnungsinstanzen](v9-alerting-rules-instances.md)
+ [Namespaces und Gruppen](v9-alerting-rules-grouping.md)
+ [Vorlagen für Benachrichtigungen](v9-alerting-rules-notification-templates.md)
# Arten von Warnungsregeln
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Grafana unterstützt mehrere Warnungsregeltypen. In den folgenden Abschnitten werden ihre Vor- und Nachteile erläutert und Sie bei der Auswahl des richtigen Warnungstyps für Ihren Anwendungsfall unterstützt.
Von Grafana verwaltete Regeln
Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Warnmeldungen zu erstellen, die auf Daten aus jeder Ihrer vorhandenen Datenquellen reagieren können.
Sie unterstützen nicht nur jede Datenquelle, sondern können auch [Ausdrücke](v9-panels-query-xform-expressions.md) hinzufügen, um Ihre Daten zu transformieren und Alarmbedingungen auszudrücken.
Mimir-, Loki- und Cortex-Regeln
Um Mimir-, Loki- oder Cortex-Benachrichtigungen zu erstellen, benötigen Sie eine kompatible Prometheus-Datenquelle. Sie können überprüfen, ob Ihre Datenquelle kompatibel ist, indem Sie die Datenquelle testen und anhand der Details überprüfen, ob die Lineal-API unterstützt wird.
Regeln für die Aufzeichnung
Aufzeichnungsregeln sind nur für kompatible Prometheus-Datenquellen wie Mimir, Loki und Cortex verfügbar.
Eine Aufzeichnungsregel ermöglicht es Ihnen, das Ergebnis eines Ausdrucks in einer neuen Reihe von Zeitreihen zu speichern. Dies ist nützlich, wenn Sie Benachrichtigungen zu aggregierten Daten ausführen möchten oder wenn Sie über Dashboards verfügen, die denselben Ausdruck wiederholt abfragen.
Lesen Sie mehr über die [Aufnahmeregeln](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.
# Warnungsinstanzen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Von Grafana verwaltete Benachrichtigungen unterstützen mehrdimensionale Benachrichtigungen. Jede Warnungsregel kann mehrere Warnungsinstanzen erstellen. Dies ist besonders nützlich, wenn Sie mehrere Serien in einem einzigen Ausdruck beobachten.
Betrachten Sie den folgenden PromQL-Ausdruck:
```
sum by(cpu) (
rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```
Eine Regel, die diesen Ausdruck verwendet, erzeugt so viele Alert-Instanzen, wie CPUs bei der Auswertung beobachtet wurden, sodass eine einzige Regel den Status jeder CPU melden kann.
# Namespaces und Gruppen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Benachrichtigungen können mithilfe von Ordnern für von Grafana verwaltete Regeln und Namespaces für Mimir-, Loki- oder Prometheus-Regeln und Gruppennamen organisiert werden.
**Namespaces**
Bei der Erstellung von von Grafana verwalteten Regeln kann der Ordner verwendet werden, um die Zugriffskontrolle durchzuführen und den Zugriff auf alle Regeln innerhalb eines bestimmten Ordners zu gewähren oder zu verweigern.
**Gruppen**
**Alle Regeln innerhalb einer Gruppe werden im gleichen Intervall ausgewertet.**
Warn- und Aufzeichnungsregeln innerhalb einer Gruppe werden immer **sequentiell** ausgewertet, d. h. Regeln werden nicht gleichzeitig und in der Reihenfolge ihres Auftretens ausgewertet.
**Tipp**
Wenn Sie möchten, dass Regeln gleichzeitig und mit unterschiedlichen Intervallen ausgewertet werden, sollten Sie sie in verschiedenen Gruppen speichern.
# Vorlagen für Benachrichtigungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Benachrichtigungen, die über Kontaktpunkte gesendet werden, werden mithilfe von Benachrichtigungsvorlagen erstellt. Die Standardvorlagen von Grafana basieren auf dem [Go-Vorlagensystem](https://golang.org/pkg/text/template), bei dem einige Felder als Text ausgewertet werden, während andere als HTML ausgewertet werden (was sich auf die Escape-Funktion auswirken kann).
Die Standardvorlage [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) ist eine nützliche Referenz für benutzerdefinierte Vorlagen.
Da die meisten Kontaktpunktfelder mit Vorlagen versehen werden können, können Sie wiederverwendbare benutzerdefinierte Vorlagen erstellen und diese in mehreren Kontaktpunkten verwenden. Weitere Informationen zu benutzerdefinierten Benachrichtigungen mithilfe von Vorlagen finden Sie unter[Benachrichtigungen anpassen](v9-alerting-notifications.md).
**Verschachtelte Vorlagen**
Sie können Vorlagen in andere Vorlagen einbetten.
Sie können beispielsweise ein Vorlagenfragment mithilfe des `define` Schlüsselworts definieren.
```
{{ define "mytemplate" }}
{{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```
Anschließend können Sie mithilfe des `template` Schlüsselworts benutzerdefinierte Vorlagen in dieses Fragment einbetten. Beispiel:
```
Alert summary:
{{ template "mytemplate" . }}
```
Sie können jede der folgenden integrierten Vorlagenoptionen verwenden, um benutzerdefinierte Vorlagen einzubetten.
| Name | Hinweise |
| --- | --- |
| `default.title` | Zeigt Statusinformationen auf hoher Ebene an. |
| `default.message` | Stellt eine formatierte Zusammenfassung der ausgelösten und gelösten Alarme bereit. |
| `teams.default.message` | Ähnlich wie`default.messsage`, formatiert für Microsoft Teams. |
**HTML in Benachrichtigungsvorlagen**
HTML in Vorlagen für Warnmeldungen ist maskiert. Wir unterstützen das Rendern von HTML in der resultierenden Benachrichtigung nicht.
Einige Notifier unterstützen alternative Methoden zur Änderung des Erscheinungsbilds der resultierenden Benachrichtigung. Grafana installiert beispielsweise die Basisvorlage für Benachrichtigungen per E-Mail. `/public/emails/ng_alert_notification.html` Sie können diese Datei bearbeiten, um das Erscheinungsbild aller Warn-E-Mails zu ändern.
# Warnmeldungen bei numerischen Daten
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
In diesem Thema wird beschrieben, wie Grafana mit Benachrichtigungen bei numerischen Daten und nicht bei Zeitreihendaten umgeht.
Bei bestimmten Datenquellen können numerische Daten, bei denen es sich nicht um Zeitreihen handelt, direkt gemeldet oder an Server Side Expressions (SSE) übergeben werden. Dies ermöglicht eine bessere Verarbeitung und damit eine höhere Effizienz innerhalb der Datenquelle und kann auch die Warnungsregeln vereinfachen. Bei Warnmeldungen für numerische Daten anstelle von Zeitreihendaten ist es nicht erforderlich, jede beschriftete Zeitreihe auf eine einzelne Zahl zu reduzieren. Stattdessen werden beschriftete Zahlen stattdessen an Grafana zurückgegeben.
**Tabellarische Daten**
Diese Funktion wird bei Backend-Datenquellen unterstützt, die Tabellendaten abfragen:
+ SQL-Datenquellen wie MySQL, Postgres, MSSQL und Oracle.
+ Die auf Azure Kusto basierenden Dienste: Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) und Azure Data Explorer.
Eine Abfrage mit von Grafana verwalteten Benachrichtigungen oder SSE wird bei diesen Datenquellen als numerisch betrachtet, wenn:
+ Die Option „Format AS“ ist in der Datenquellenabfrage auf „Tabelle“ eingestellt.
+ Die von der Abfrage an Grafana zurückgegebene Tabellenantwort enthält nur eine numerische Spalte (z. B. int, double, float) und optional zusätzliche Zeichenkettenspalten.
Wenn es Zeichenkettenspalten gibt, werden diese Spalten zu Beschriftungen. Der Name der Spalte wird zum Labelnamen, und der Wert für jede Zeile wird zum Wert der entsprechenden Bezeichnung. Wenn mehrere Zeilen zurückgegeben werden, sollte jede Zeile mit ihren Beschriftungen eindeutig identifiziert werden.
**Beispiel**
Für eine MySQL-Tabelle namens „DiskSpace“:
| Zeit | Host | Festplatte | PercentFree |
| --- | --- | --- | --- |
| 2021-Juni-7 | Netz 1 | /usw | 3 |
| 2021-Juni-7 | Netz 2 | /var | 4 |
| 2021-Juni-7 | Netz 3 | /var | 8 |
| ... | ... | ... | ... |
Sie können die Datenfilterung rechtzeitig abfragen, ohne jedoch die Zeitreihe an Grafana zurückzugeben. Zum Beispiel eine Warnung, die pro Host und Festplatte ausgelöst wird, wenn weniger als 5% freier Speicherplatz zur Verfügung steht:
```
SELECT Host , Disk , CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
SELECT
Host,
Disk,
Avg(PercentFree)
FROM DiskSpace
Group By
Host,
Disk
Where __timeFilter(Time)
```
Diese Abfrage gibt die folgende Tabellenantwort an Grafana zurück:
| Host | Festplatte | PercentFree |
| --- | --- | --- |
| web1 | /usw | 3 |
| web2 | /var | 4 |
| web3 | /var | 0 |
Wenn diese Abfrage als **Bedingung** in einer Warnungsregel verwendet wird, wird ein Wert ungleich Null als Warnung verwendet. Infolgedessen werden drei Warnungsinstanzen erzeugt:
| Labels | Status |
| --- | --- |
| \$1host=WEB1, DISK=/etc\$1 | Warnfunktion |
| \$1Host=Web2, Festplatte=/var\$1 | Warnfunktion |
| \$1host=WEB3, Festplatte=/var\$1 | Normal |
# Beschriftungen und Anmerkungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Beschriftungen und Anmerkungen enthalten Informationen zu einer Warnung. Sowohl Beschriftungen als auch Anmerkungen haben dieselbe Struktur: eine Reihe benannter Werte; ihre Verwendungszwecke sind jedoch unterschiedlich. Ein Beispiel für eine Bezeichnung oder eine entsprechende Anmerkung könnte sein`alertname="test"`.
Der Hauptunterschied zwischen einer Bezeichnung und einer Anmerkung besteht darin, dass Beschriftungen verwendet werden, um eine Warnung von allen anderen Warnungen zu unterscheiden, während Anmerkungen dazu verwendet werden, einer vorhandenen Warnung zusätzliche Informationen hinzuzufügen.
Stellen Sie sich zum Beispiel zwei Warnmeldungen mit hohem CPU-Wert vor: eine für `server1` und eine weitere für`server2`. In einem solchen Beispiel könnten wir eine Bezeichnung haben, `server` bei der die erste Warnung die Bezeichnung `server="server1"` und die zweite Warnung die Bezeichnung trägt`server="server2"`. Möglicherweise möchten wir jedoch auch jeder Warnung eine Beschreibung hinzufügen`"The CPU usage for server1 is above 75%."`, z. B. wo `server1` und `75%` werden durch den Namen und die CPU-Auslastung des Servers ersetzt (Informationen dazu finden Sie in der Dokumentation). [Vorlagen für Beschriftungen und Anmerkungen erstellen](v9-alerting-explore-labels-templating.md) Diese Art von Beschreibung wäre besser als Anmerkung geeignet.
## Labels
Beschriftungen enthalten Informationen, anhand derer eine Warnung identifiziert werden kann. Ein Beispiel für ein Etikett könnte sein`server=server1`. Jede Warnung kann mehr als ein Label haben, und der komplette Satz von Labels für eine Warnung wird als Labelsatz bezeichnet. Es ist dieser Labelsatz, der die Warnung identifiziert.
Beispielsweise kann für eine Warnung die Bezeichnung festgelegt sein, `{alertname="High CPU usage",server="server1"}` während für eine andere Warnung die Bezeichnung festgelegt sein könnte`{alertname="High CPU usage",server="server2"}`. Dabei handelt es sich um zwei separate Benachrichtigungen, da ihre `alertname` Beschriftungen zwar identisch sind, ihre `server` Beschriftungen jedoch unterschiedlich sind.
Die für eine Warnung festgelegte Bezeichnung ist eine Kombination aus den Bezeichnungen aus der Datenquelle, benutzerdefinierten Bezeichnungen aus der Warnungsregel und einer Reihe von reservierten Bezeichnungen wie. `alertname`
**Benutzerdefinierte Beschriftungen**
Benutzerdefinierte Beschriftungen sind zusätzliche Beschriftungen aus der Warnungsregel. Wie Anmerkungen müssen benutzerdefinierte Beschriftungen einen Namen haben, und ihr Wert kann eine Kombination aus Text und Vorlagencode enthalten, der ausgewertet wird, wenn eine Warnung ausgelöst wird. Eine Dokumentation zur Erstellung von Vorlagen für benutzerdefinierte Beschriftungen finden Sie [hier.](v9-alerting-explore-labels-templating.md)
Wenn Sie benutzerdefinierte Beschriftungen mit Vorlagen verwenden, müssen Sie sicherstellen, dass sich der Labelwert zwischen aufeinanderfolgenden Auswertungen der Warnmeldungsregel nicht ändert, da dies zu einer großen Anzahl unterschiedlicher Benachrichtigungen führen kann. Es ist jedoch in Ordnung, wenn die Vorlage unterschiedliche Labelwerte für verschiedene Warnungen erzeugt. Fügen Sie den Wert der Abfrage beispielsweise nicht in ein benutzerdefiniertes Label ein, da dadurch bei jeder Änderung des Werts ein neuer Satz von Benachrichtigungen erstellt wird. Verwenden Sie stattdessen Anmerkungen.
Es ist auch wichtig sicherzustellen, dass das für eine Warnung festgelegte Label nicht zwei oder mehr Labels mit demselben Namen enthält. Wenn ein benutzerdefiniertes Label denselben Namen wie ein Label aus der Datenquelle hat, wird es dieses Label ersetzen. Sollte ein benutzerdefiniertes Label jedoch denselben Namen wie ein reserviertes Label haben, wird das benutzerdefinierte Label in der Warnung weggelassen.
## Anmerkungen
Bei Anmerkungen handelt es sich um benannte Paare, die vorhandenen Warnungen zusätzliche Informationen hinzufügen. In Grafana gibt es eine Reihe von vorgeschlagenen Anmerkungen wie`description`, `summary``runbook_url`, `dashboardUId` und. `panelId` Wie benutzerdefinierte Beschriftungen müssen Anmerkungen einen Namen haben, und ihr Wert kann eine Kombination aus Text und Vorlagencode enthalten, die ausgewertet wird, wenn eine Warnung ausgelöst wird. Wenn eine Anmerkung Vorlagencode enthält, wird die Vorlage einmal ausgewertet, wenn die Warnung ausgelöst wird. Sie wird nicht erneut bewertet, auch wenn die Warnung behoben ist. [Eine Dokumentation zur Erstellung von Vorlagen für Anmerkungen finden Sie hier.](v9-alerting-explore-labels-templating.md)
# So funktioniert der Labelabgleich
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Verwenden Sie Labels und Label-Matcher, um Warnungsregeln mit Benachrichtigungsrichtlinien und Stummschalten zu verknüpfen. Auf diese Weise können Sie Ihre Warnungsinstanzen sehr flexibel verwalten und festlegen, welche Richtlinie sie behandeln soll und welche Alarme ausgeblendet werden sollen.
Ein Label-Matcher besteht aus drei verschiedenen Teilen: dem **Label**, dem **Wert** und dem **Operator**.
+ Das **Label-Feld** ist der Name der Bezeichnung, der zugeordnet werden soll. Es muss genau mit dem Labelnamen übereinstimmen.
+ Das **Wertfeld** stimmt mit dem entsprechenden Wert für den angegebenen **Labelnamen** überein. Wie es übereinstimmt, hängt vom **Operator-Wert** ab.
+ Das Feld **Operator** ist der Operator, der mit dem Labelwert verglichen werden soll. Die verfügbaren Operatoren sind:
| Operator | Description |
| --- | --- |
| `=` | Wählen Sie Beschriftungen aus, die genau dem Wert entsprechen. |
| `!=` | Wählen Sie Beschriftungen aus, die nicht dem Wert entsprechen. |
| `=~` | Wählen Sie Beschriftungen aus, die dem Wert im Regex-Format entsprechen. |
| `!~` | Wählen Sie Beschriftungen aus, die nicht mit dem Regex-Wert übereinstimmen. |
Wenn Sie mehrere Label-Matcher verwenden, werden sie mit dem logischen Operator AND kombiniert. Das bedeutet, dass alle Matcher übereinstimmen müssen, um eine Regel mit einer Richtlinie zu verknüpfen.
**Beispielszenario**
Wenn Sie den folgenden Satz von Bezeichnungen für Ihre Warnung definieren:
```
{ foo=bar, baz=qux, id=12 }
```
dann:
+ Ein Label-Matcher, der als definiert ist, `foo=bar` entspricht dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, entspricht `foo!=bar` *nicht* dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, `id=~[0-9]+` entspricht dieser Warnungsregel.
+ Ein Label-Matcher, der als definiert ist, `baz!~[0-9]+` entspricht dieser Warnungsregel.
+ Zwei Label-Matcher, die als definiert sind `foo=bar` und dieser Warnungsregel `id=~[0-9]+` entsprechen.
# Etiketten in Grafana-Benachrichtigungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
In diesem Thema wird erklärt, warum Beschriftungen ein grundlegender Bestandteil von Warnmeldungen sind.
+ Der vollständige Satz von Bezeichnungen für eine Warnung identifiziert eine Warnung innerhalb von Grafana-Benachrichtigungen eindeutig.
+ Der Alertmanager verwendet Labels, um Alerts für Stummmeldungen und Warnungsgruppen in den Benachrichtigungsrichtlinien zuzuordnen.
+ In der Benutzeroberfläche für Warnmeldungen werden Beschriftungen für jede Warnungsinstanz angezeigt, die bei der Auswertung dieser Regel generiert wurde.
+ Kontaktstellen können auf Labels zugreifen, um dynamisch Benachrichtigungen zu generieren, die spezifische Informationen zu der Warnung enthalten, die zu einer Benachrichtigung führt.
+ Sie können einer [Warnregel](v9-alerting-managerules.md) Labels hinzufügen. Beschriftungen können manuell konfiguriert werden, verwenden Vorlagenfunktionen und können auf andere Beschriftungen verweisen. Zu einer Warnregel hinzugefügte Labels haben im Falle einer Kollision zwischen Labels Vorrang (außer im Fall von reservierten Grafana-Labels, weitere Informationen finden Sie weiter unten).
**Kompatibilität mit externem Alertmanager**
Der integrierte Alertmanager von Grafana unterstützt sowohl Unicode-Labelschlüssel als auch Werte. [Wenn Sie einen externen Prometheus Alertmanager verwenden, müssen die Labelschlüssel mit ihrem Datenmodell kompatibel sein.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) **Das bedeutet, dass Labelschlüssel nur **ASCII-Buchstaben**, **Zahlen** sowie Unterstriche enthalten dürfen und der Regex entsprechen dürfen.** `[a-zA-Z_][a-zA-Z0-9_]*` Alle ungültigen Zeichen werden von der Grafana-Alerting Engine entfernt oder ersetzt, bevor sie gemäß den folgenden Regeln an den externen Alertmanager gesendet werden:
+ `Whitespace`wird entfernt.
+ `ASCII characters`wird ersetzt durch`_`.
+ `All other characters`wird durch ihre Hexadezimaldarstellung in Kleinbuchstaben ersetzt. Wenn dies das erste Zeichen ist, wird ihm ein Präfix vorangestellt. `_`
**Anmerkung**
Wenn mehrere Labelschlüssel auf denselben Wert bereinigt werden, wird an die Duplikate ein kurzer Hash des ursprünglichen Labels als Suffix angehängt.
**Grafana reservierte Labels**
**Anmerkung**
Etiketten mit dem Präfix `grafana_` sind von Grafana für spezielle Zwecke reserviert. Wenn ein manuell konfiguriertes Label hinzugefügt wird, kann `grafana_` es im Kollisionsfall überschrieben werden.
Reservierte Grafana-Labels können genauso verwendet werden wie manuell konfigurierte Labels. Die aktuelle Liste der verfügbaren reservierten Labels lautet:
| Label (Bezeichnung) | Description |
| --- | --- |
| grafana\$1folder | Titel des Ordners, der die Warnung enthält. |
# Vorlagen für Beschriftungen und Anmerkungen erstellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
In Grafana erstellen Sie Vorlagen für Beschriftungen und Anmerkungen, genau wie in Prometheus. Wenn Sie Prometheus schon einmal verwendet haben, sollten Sie mit den `$value` Variablen `$labels` und vertraut sein, die die Bezeichnungen und den Wert der Warnung enthalten. Sie können dieselben Variablen in Grafana verwenden, auch wenn die Warnung keine Prometheus-Datenquelle verwendet. Wenn Sie Prometheus noch nicht verwendet haben, machen Sie sich keine Sorgen, denn jede dieser Variablen und wie Sie sie als Vorlage verwenden, wird im weiteren Verlauf dieser Seite erklärt.
## Die Vorlagensprache von Go
[Vorlagen für Beschriftungen und Anmerkungen sind in der Vorlagensprache von Go, Text/Vorlage, geschrieben.](https://pkg.go.dev/text/template)
**Tags öffnen und schließen**
In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}`
**Print (Ausgabe)**
Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können das Ergebnis einer Funktion oder den Wert einer Variablen drucken. Um beispielsweise die `$labels` Variable zu drucken, würden Sie Folgendes schreiben:
```
{{ $labels }}
```
**Iterieren Sie über Beschriftungen**
Um über jedes Etikett zu iterieren, können `$labels` Sie a verwenden. `range` `$k`Bezieht sich hier auf den Namen und `$v` bezieht sich auf den Wert des aktuellen Labels. Wenn Ihre Abfrage beispielsweise ein Label zurückgibt, `instance=test` dann `$k` wäre `instance` und `$v` wäre es`test`.
```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```
## Die Variablen Labels, Value und Values
**Die Bezeichnungsvariable**
Die `$labels` Variable enthält die Labels aus der Abfrage. Beispielsweise kann eine Abfrage, die prüft, ob eine Instanz ausgefallen ist, ein Instanzlabel mit dem Namen der Instanz zurückgeben, die ausgefallen ist. Nehmen wir beispielsweise an, Sie haben eine Warnungsregel, die ausgelöst wird, wenn eine Ihrer Instances länger als 5 Minuten ausgefallen ist. Sie möchten der Warnung eine Zusammenfassung hinzufügen, die Ihnen mitteilt, welche Instanz ausgefallen ist. Mit der `$labels` Variablen können Sie eine Zusammenfassung erstellen, die das Instanzlabel in der Zusammenfassung ausgibt:
```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```
**Beschriftungen mit Punkten**
Wenn das Etikett, das Sie drucken möchten, einen Punkt (Punkt oder Punkt) im Namen enthält, funktioniert die Verwendung desselben Punktes in der Vorlage nicht:
```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```
Das liegt daran, dass die Vorlage versucht, ein nicht vorhandenes `name` aufgerufenes `$labels.instance` Feld zu verwenden. Sie sollten stattdessen die `index` Funktion verwenden, die das Etikett `instance.name` in der `$labels` Variablen druckt:
```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```
**Die Wertvariable**
Die `$value` Variable funktioniert anders als Prometheus. In Prometheus `$value` ist es eine Fließkommazahl, die den Wert des Ausdrucks enthält, aber in Grafana ist es eine Zeichenfolge, die die Bezeichnungen und Werte aller Threshold-, Reduce- und Math-Ausdrücke sowie der klassischen Bedingungen für diese Warnregel enthält. Sie enthält keine Ergebnisse von Abfragen, da diese zwischen 10 und 10.000 Zeilen oder Metriken zurückgeben können.
Wenn Sie die `$value` Variable in der Zusammenfassung einer Warnung verwenden würden:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```
Die Zusammenfassung könnte etwa wie folgt aussehen:
```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```
`var='B'`Bezieht sich hier auf den Ausdruck mit der Referenznummer B. In Grafana werden alle Abfragen und Ausdrücke durch eine RefID identifiziert, die jede Abfrage und jeden Ausdruck in einer Alert-Regel identifiziert. `labels={service=api}`Bezieht sich in ähnlicher Weise auf die Bezeichnungen und `value=6.789` bezieht sich auf den Wert.
Möglicherweise haben Sie festgestellt, dass es keine Referenznummer A gibt. Das liegt daran, dass sich die Referenznummer A in den meisten Warnungsregeln auf eine Abfrage bezieht und dass Abfragen viele Zeilen oder Zeitreihen zurückgeben können, in denen sie nicht enthalten sind. `$value`
**Die Werte sind variabel**
Wenn die `$value` Variable mehr Informationen enthält, als Sie benötigen, können Sie stattdessen die Bezeichnungen und den Wert einzelner Ausdrücke mit drucken`$values`. Im `$value` Gegensatz dazu handelt es sich bei der `$values` Variablen um eine Tabelle mit Objekten, die die Bezeichnungen und Fließkommawerte jedes Ausdrucks enthält, die anhand ihrer Referenznummer indexiert sind.
Wenn Sie den Wert des Ausdrucks mit refID `B` in der Zusammenfassung der Warnung drucken würden:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```
Die Zusammenfassung enthält nur den Wert:
```
api has an over 5% of responses with 5xx errors: 6.789%
```
Obwohl die Zahl 6,789 `{{ $values.B }}` gedruckt wird, handelt es sich tatsächlich um eine Zeichenfolge, da Sie das Objekt drucken, das sowohl die Beschriftungen als auch den Wert für Referenznummer B enthält, nicht den Fließkommawert von B. Um den Fließkommawert von Referenz B zu verwenden, müssen Sie das Feld von verwenden. `Value` `$values.B` Wenn Sie den Fließkommawert in der Zusammenfassung einer Warnung humanisieren würden:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```
**Keine Daten, Laufzeitfehler und Timeouts**
Wenn die Abfrage in Ihrer Warnungsregel keine Daten zurückgibt oder aufgrund eines Datenquellenfehlers oder einer Zeitüberschreitung fehlschlägt, geben alle Threshold-, Reduce- oder Math-Ausdrücke, die diese Abfrage verwenden, ebenfalls keine Daten oder einen Fehler zurück. In diesem Fall fehlen diese Ausdrücke in. `$values` Es empfiehlt sich, vor der Verwendung zu überprüfen, ob eine RefID vorhanden ist, da Ihre Vorlage sonst beschädigt wird, wenn Ihre Abfrage keine Daten oder einen Fehler zurückgibt. Sie können dies mit einer if-Anweisung tun:
```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```
## Klassische Bedingungen
Wenn die Regel klassische Bedingungen anstelle von Threshold-, Reduce- und Math-Ausdrücken verwendet, wird die `$values` Variable sowohl anhand der Referenz-ID als auch anhand der Position der Bedingung in der klassischen Bedingung indexiert. Wenn Sie beispielsweise eine klassische Bedingung mit RefID B haben, die zwei Bedingungen enthält, `$values` dann enthält sie zwei Bedingungen `B0` und. `B1`
```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```
## Funktionen
Die folgenden Funktionen sind auch verfügbar, wenn Beschriftungen und Anmerkungen erweitert werden:
**Argumente**
Die `args` Funktion übersetzt eine Liste von Objekten in eine Map mit den Schlüsseln arg0, arg1 usw. Dies soll die Übergabe mehrerer Argumente an Vorlagen ermöglichen.
**Beispiel**
```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```
```
1 2
```
**Externe URL**
Die `externalURL` Funktion gibt die externe URL des Grafana-Servers zurück, wie sie in der (den) INI-Datei (en) konfiguriert ist.
**Beispiel**
```
{{ externalURL }}
```
```
https://example.com/grafana
```
**GraphLink**
Die `graphLink` Funktion gibt den Pfad zur grafischen Ansicht [Erkunden Sie in Grafana-Version 9](v9-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.
**Beispiel**
```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```
```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```
**humanisieren**
Die `humanize` Funktion humanisiert Dezimalzahlen.
**Beispiel**
```
{{ humanize 1000.0 }}
```
```
1k
```
**humanisieren1024**
Das `humanize1024` funktioniert ähnlich wie, verwendet `humanize` aber 1024 statt 1000 als Basis.
**Beispiel**
```
{{ humanize1024 1024.0 }}
```
```
1ki
```
**Dauer humanisieren**
Die `humanizeDuration` Funktion humanisiert eine Dauer in Sekunden.
**Beispiel**
```
{{ humanizeDuration 60.0 }}
```
```
1m 0s
```
**Prozentsatz humanisieren**
Die `humanizePercentage` Funktion humanisiert einen Verhältniswert zu einem Prozentsatz.
**Beispiel**
```
{{ humanizePercentage 0.2 }}
```
```
20%
```
**HumanizeTimestamp**
Die `humanizeTimestamp` Funktion humanisiert einen Unix-Zeitstempel.
**Beispiel**
```
{{ humanizeTimestamp 1577836800.0 }}
```
```
2020-01-01 00:00:00 +0000 UTC
```
**Spiel**
Die `match` Funktion gleicht den Text mit einem regulären Ausdrucksmuster ab.
**Beispiel**
```
{{ match "a.*" "abc" }}
```
```
true
```
**Pfad/Präfix**
Die `pathPrefix` Funktion gibt den Pfad des Grafana-Servers zurück, wie er in der (den) INI-Datei (en) konfiguriert ist.
**Beispiel**
```
{{ pathPrefix }}
```
```
/grafana
```
**TableLink**
Die `tableLink` Funktion gibt den Pfad zur Tabellenansicht [Erkunden Sie in Grafana-Version 9](v9-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.
**Beispiel**
```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```
```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```
**Titel**
Die `title` Funktion schreibt das erste Zeichen jedes Worts groß.
**Beispiel**
```
{{ title "hello, world!" }}
```
```
Hello, World!
```
**toLower**
Die `toLower` Funktion gibt den gesamten Text in Kleinbuchstaben zurück.
**Beispiel**
```
{{ toLower "Hello, world!" }}
```
```
hello, world!
```
**toUpper**
Die `toUpper` Funktion gibt den gesamten Text in Großbuchstaben zurück.
**Beispiel**
```
{{ toUpper "Hello, world!" }}
```
```
HELLO, WORLD!
```
**reReplaceAll**
Die `reReplaceAll` Funktion ersetzt Text, der dem regulären Ausdruck entspricht.
**Beispiel**
```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```
```
example.com:8080
```
# Stand und Zustand der Warnregeln
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Der Status und die Integrität von Warnregeln helfen Ihnen dabei, mehrere wichtige Statusindikatoren Ihrer Benachrichtigungen zu verstehen.
Es gibt drei Hauptkomponenten: den *Status der Warnungsregel, den Status der* *Warnungsinstanz und den Zustand* *der Warnungsregel*. Obwohl sie miteinander verwandt sind, vermittelt jede Komponente subtil unterschiedliche Informationen.
**Status der Warnungsregel**
Eine Warnungsregel kann sich in einem der folgenden Zustände befinden:
| Status | Description |
| --- | --- |
| Normal | Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den `Firing` Status „`Pending`Oder“. |
| Ausstehend | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe ist`Pending`. |
| Wird gefeuert | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe ist`Firing`. |
**Anmerkung**
Warnmeldungen werden zuerst zu `pending` und dann `firing` weitergeleitet. Daher dauert es mindestens zwei Bewertungszyklen, bis eine Warnung ausgelöst wird.
**Status der Warnungsinstanz**
Eine Warnungsinstanz kann sich in einem der folgenden Zustände befinden:
| Status | Description |
| --- | --- |
| Normal | Der Status einer Warnung, die weder ausgelöst noch aussteht. Alles funktioniert einwandfrei. |
| Ausstehend | Der Status einer Warnung, die für weniger als die konfigurierte Schwellenwertdauer aktiv war. |
| Warnfunktion | Der Status einer Warnung, die länger als die konfigurierte Schwellenwertdauer aktiv war. |
| NoData | Für das konfigurierte Zeitfenster wurden keine Daten empfangen. |
| Fehler | Der Fehler, der beim Versuch, eine Warnregel auszuwerten, aufgetreten ist. |
**Zustand der Warnmeldungsregel**
Eine Warnungsregel kann einen der folgenden Integritätsstatus haben:
| Status | Description |
| --- | --- |
| OK | Bei der Auswertung einer Warnregel ist kein Fehler aufgetreten. |
| Fehler | Bei der Auswertung einer Warnregel ist ein Fehler aufgetreten. |
| NoData | Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde. |
**Besondere Warnmeldungen für `NoData` und `Error`**
Wenn die Auswertung einer Warnregel den Status `NoData` oder ergibt`Error`, generiert Grafana Alerting Warninstanzen mit den folgenden zusätzlichen Bezeichnungen:
| Label (Bezeichnung) | Description |
| --- | --- |
| Name der Warnung | Entweder `DatasourceNoData` oder `DatasourceError` je nach Bundesland. |
| datasource\$1uid | Die UID der Datenquelle, die den Status verursacht hat. |
Sie können diese Benachrichtigungen genauso behandeln wie normale Benachrichtigungen, indem Sie eine Stille, eine Route zu einem Kontaktpunkt usw. hinzufügen.
# Kontaktstellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird. Eine Kontaktstelle kann einen oder mehrere Kontaktpunkttypen haben, z. B. E-Mail, Slack, Webhook usw. Wenn eine Warnungsregel ausgelöst wird, wird eine Benachrichtigung an alle Kontaktpunkttypen gesendet, die für einen Kontaktpunkt aufgeführt sind. Kontaktpunkte können sowohl für den Grafana Alertmanager als auch für externe Alertmanager konfiguriert werden.
Sie können auch Benachrichtigungsvorlagen verwenden, um Benachrichtigungen für Kontaktpunkttypen anzupassen.
**Unterstützte Kontaktpunkttypen**
In der folgenden Tabelle sind die von Grafana unterstützten Kontaktpunkttypen aufgeführt.
| Name | Typ |
| --- | --- |
| Amazon SNS | `sns` |
| OpsGenie | `opsgenie` |
| Pager Duty | `pagerduty` |
| Slack | `slack` |
| VictorOps | `victorops` |
Weitere Informationen zu Kontaktstellen finden Sie unter [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md) und[Benachrichtigungen anpassen](v9-alerting-notifications.md).
# Benachrichtigungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Grafana verwendet Alertmanager, um Benachrichtigungen über ausgelöste und gelöste Alarme zu senden. [Grafana hat seinen eigenen Alertmanager, der in der Benutzeroberfläche als „Grafana“ bezeichnet wird, unterstützt aber auch das Senden von Benachrichtigungen von anderen Alertmanagern, wie dem Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Der Grafana Alertmanager verwendet Benachrichtigungsrichtlinien und Kontaktpunkte, um zu konfigurieren, wie und wo eine Benachrichtigung gesendet wird, wie oft eine Benachrichtigung gesendet werden soll und ob Benachrichtigungen alle in derselben Benachrichtigung, in gruppierten Benachrichtigungen basierend auf einer Reihe von Labels oder als separate Benachrichtigungen gesendet werden sollen.
## Richtlinien für Benachrichtigungen
Benachrichtigungsrichtlinien steuern, wann und wo Benachrichtigungen gesendet werden. Eine Benachrichtigungsrichtlinie kann wählen, ob alle Benachrichtigungen zusammen in derselben Benachrichtigung, Benachrichtigungen in gruppierten Benachrichtigungen auf der Grundlage einer Reihe von Labels oder Benachrichtigungen als separate Benachrichtigungen gesendet werden sollen. Sie können jede Benachrichtigungsrichtlinie so konfigurieren, dass gesteuert wird, wie oft Benachrichtigungen gesendet werden sollen. Außerdem können Sie eine oder mehrere Stummschaltungen einrichten, um Benachrichtigungen zu bestimmten Tageszeiten und an bestimmten Wochentagen zu blockieren.
Benachrichtigungsrichtlinien sind in einer Baumstruktur organisiert, wobei sich an der Wurzel der Struktur eine Benachrichtigungsrichtlinie befindet, die als Stammrichtlinie bezeichnet wird. Es kann nur eine Stammrichtlinie geben, und die Stammrichtlinie kann nicht gelöscht werden.
Spezifische Routing-Richtlinien sind der Stammrichtlinie untergeordnet und können verwendet werden, um entweder allen Warnungen oder einer Teilmenge von Warnungen auf der Grundlage einer Reihe von übereinstimmenden Bezeichnungen zuzuordnen. Eine Benachrichtigungsrichtlinie entspricht einer Warnung, wenn ihre entsprechenden Bezeichnungen mit den Bezeichnungen in der Warnung übereinstimmen.
Eine bestimmte Routing-Richtlinie kann eigene untergeordnete Richtlinien haben, die als verschachtelte Richtlinien bezeichnet werden und eine zusätzliche Zuordnung von Warnmeldungen ermöglichen. Ein Beispiel für eine bestimmte Routing-Richtlinie könnte das Senden von Infrastrukturwarnungen an das Ops-Team sein, während eine untergeordnete Richtlinie Benachrichtigungen mit hoher Priorität an Pagerduty und Benachrichtigungen mit niedriger Priorität an Slack senden könnte.
Alle Benachrichtigungen, unabhängig von ihrer Bezeichnung, entsprechen der Root-Richtlinie. Wenn die Stammrichtlinie jedoch eine Warnung erhält, überprüft sie jede spezifische Routing-Richtlinie und sendet die Warnung an die erste spezifische Routing-Richtlinie, die der Warnung entspricht. Wenn die spezifische Routing-Richtlinie weitere untergeordnete Richtlinien hat, kann sie versuchen, die Warnung mit einer ihrer verschachtelten Richtlinien abzugleichen. Wenn keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die spezifische Routing-Richtlinie die passende Richtlinie. Wenn es keine spezifischen Routing-Richtlinien gibt oder keine spezifischen Routing-Richtlinien mit der Warnung übereinstimmen, ist die Stammrichtlinie die passende Richtlinie.
## Kontaktstellen
Kontaktpunkte enthalten die Konfiguration für das Senden von Benachrichtigungen. Eine Kontaktstelle ist eine Liste von Integrationen, von denen jede eine Benachrichtigung an eine bestimmte E-Mail-Adresse, einen bestimmten Dienst oder eine bestimmte URL sendet. Kontaktstellen können mehrere Integrationen derselben Art oder eine Kombination von Integrationen verschiedener Art haben. Eine Kontaktstelle könnte beispielsweise eine Pager Duty-Integration, eine Pager Duty- und Slack-Integration oder eine Pager Duty-Integration, eine Slack-Integration und zwei Amazon SNS-Integrationen enthalten. Sie können auch einen Kontaktpunkt ohne Integrationen konfigurieren. In diesem Fall werden keine Benachrichtigungen gesendet.
Eine Kontaktstelle kann erst dann Benachrichtigungen senden, wenn sie zu einer Benachrichtigungsrichtlinie hinzugefügt wurde. Eine Benachrichtigungsrichtlinie kann nur Benachrichtigungen an eine Kontaktstelle senden, aber eine Kontaktstelle kann gleichzeitig zu einer Reihe von Benachrichtigungsrichtlinien hinzugefügt werden. Wenn eine Warnung mit einer Benachrichtigungsrichtlinie übereinstimmt, wird die Warnung an die Kontaktstelle in dieser Benachrichtigungsrichtlinie gesendet, die dann eine Benachrichtigung an jede Integration in ihrer Konfiguration sendet.
**Anmerkung**
Informationen zu unterstützten Integrationen für Kontaktstellen finden Sie unter[Kontaktstellen](v9-alerting-explore-contacts.md).
## Vorlagen für Benachrichtigungen erstellen
Sie können Benachrichtigungen mit Vorlagen anpassen. Vorlagen können beispielsweise verwendet werden, um den Titel und die Nachricht von Benachrichtigungen zu ändern, die an Slack gesendet werden.
Vorlagen sind nicht auf eine einzelne Integration oder einen einzelnen Kontaktpunkt beschränkt, sondern können stattdessen in einer Reihe von Integrationen an derselben Kontaktstelle und sogar in Integrationen an verschiedenen Kontaktpunkten verwendet werden. Beispielsweise kann ein Grafana-Benutzer eine Vorlage namens erstellen `custom_subject_or_title` und sie sowohl für die Vorlage von Betreffs in Pager Duty als auch für Titel von Slack-Nachrichten verwenden, ohne zwei separate Vorlagen erstellen zu müssen.
Alle Vorlagen für Benachrichtigungen sind in der [Vorlagensprache von Go verfasst und befinden sich](https://pkg.go.dev/text/template) auf der Seite „Benachrichtigungen“ auf der Registerkarte „Kontaktstellen“.
## Schweigen
Du kannst Stummschaltungen verwenden, um Benachrichtigungen über eine oder mehrere Feuerregeln stummzuschalten. Stille verhindert nicht, dass Warnmeldungen ausgelöst oder behoben werden, und sie verbergen auch keine Warnmeldungen in der Benutzeroberfläche. Eine Stille dauert so lange wie ihre Dauer, die in Minuten, Stunden, Tagen, Monaten oder Jahren konfiguriert werden kann.
# Alerting einrichten
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Konfigurieren Sie die Funktionen und Integrationen, die Sie zum Erstellen und Verwalten Ihrer Benachrichtigungen benötigen.
**Topics**
+ [Fügen Sie einen externen Alertmanager hinzu](v9-alerting-setup-alertmanager.md)
+ [Bereitstellung von Grafana-Alerting-Ressourcen](v9-alerting-setup-provision.md)
# Fügen Sie einen externen Alertmanager hinzu
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Richten Sie Grafana so ein, dass ein externer Alertmanager als einziger Alertmanager verwendet wird, um alle Ihre Benachrichtigungen zu erhalten. Dieser externe Alertmanager kann dann von Grafana aus konfiguriert und verwaltet werden.
Sobald Sie den Alertmanager hinzugefügt haben, können Sie die Grafana Alerting UI verwenden, um Stille, Kontaktpunkte und Benachrichtigungsrichtlinien zu verwalten. Eine Dropdown-Option auf diesen Seiten ermöglicht es Ihnen, zwischen Alertmanagern zu wechseln.
**Anmerkung**
Ab Grafana 9.2 ist die URL-Konfiguration externer Alertmanager auf der Registerkarte Admin auf der Alerting-Seite veraltet. Es wird in einer future Version entfernt.
Externe Alertmanager sollten jetzt mithilfe der Grafana-Konfiguration im Grafana-Navigationsmenü als Datenquellen konfiguriert werden. Auf diese Weise können Sie die Kontaktpunkte und Benachrichtigungsrichtlinien externer Alertmanager von Grafana aus verwalten und außerdem die HTTP-Basisauthentifizierungsdaten verschlüsseln, die zuvor bei der Konfiguration externer Alertmanager per URL sichtbar waren.
Gehen Sie wie folgt vor, um einen externen Alertmanager hinzuzufügen.
1. Klicken Sie auf Konfiguration und dann auf Datenquellen.
1. Suchen Sie nach Alertmanager.
1. Wählen Sie Ihre Implementierung und füllen Sie die Felder auf der Seite nach Bedarf aus.
Wenn Sie Ihre Datenquelle bereitstellen, setzen Sie die Markierung `handleGrafanaManagedAlerts` im `jsonData` Feld auf, um von Grafana verwaltete Benachrichtigungen an diesen Alertmanager `true` zu senden.
**Anmerkung**
Prometheus-, Grafana Mimir- und Cortex-Implementierungen von Alertmanager werden unterstützt. Für Prometheus sind Kontaktstellen und Benachrichtigungsrichtlinien in der Grafana Alerting UI schreibgeschützt.
1. Klicken Sie auf Speichern und testen.
# Bereitstellung von Grafana-Alerting-Ressourcen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Die Alarminfrastruktur ist oft komplex, da sich viele Teile der Pipeline oft an unterschiedlichen Orten befinden. Dies auf mehrere Teams und Organisationen zu skalieren, ist eine besonders herausfordernde Aufgabe. Die Bereitstellung von Grafana Alerting erleichtert diesen Prozess, da Sie Ihre Warndaten so erstellen, verwalten und verwalten können, wie es für Ihr Unternehmen am besten geeignet ist.
Es stehen zwei Optionen zur Auswahl:
1. Stellen Sie Ihre Alert-Ressourcen mithilfe der Alerting Provisioning HTTP-API bereit.
**Anmerkung**
In der Regel können Sie von der API bereitgestellte Warnungsregeln nicht über die Grafana-Benutzeroberfläche bearbeiten.
Um die Bearbeitung zu ermöglichen, fügen Sie den folgenden Anfragen den x-disable-provenance Header hinzu, wenn Sie Ihre Warnungsregeln in der API erstellen oder bearbeiten:
```
POST /api/v1/provisioning/alert-rules
PUT /api/v1/provisioning/alert-rules/{UID}
```
1. Stellen Sie Ihre Benachrichtigungsressourcen mithilfe von Terraform bereit.
**Anmerkung**
Derzeit unterstützt die Bereitstellung für Grafana Alerting Warnregeln, Kontaktpunkte, Stummschaltezeiten und Vorlagen. Bereitgestellte Warnressourcen mithilfe von Dateibereitstellung oder Terraform können nur in der Quelle bearbeitet werden, in der sie erstellt wurden, und nicht in Grafana oder einer anderen Quelle. Wenn Sie beispielsweise Ihre Warnressourcen mithilfe von Dateien von der Festplatte bereitstellen, können Sie die Daten nicht in Terraform oder in Grafana bearbeiten.
**Topics**
+ [Erstellen und verwalten Sie Warnressourcen mit Terraform](v9-alerting-setup-provision-terraform.md)
+ [Bereitgestellte Alert-Ressourcen in Grafana anzeigen](v9-alerting-setup-provision-view.md)
# Erstellen und verwalten Sie Warnressourcen mit Terraform
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Verwenden Sie den Grafana-Anbieter von Terraform, um Ihre Alarmressourcen zu verwalten und sie in Ihrem Grafana-System bereitzustellen. Die Terraform-Anbieterunterstützung für Grafana Alerting macht es einfach, Ihren gesamten Grafana Alerting Stack als Code zu erstellen, zu verwalten und zu warten.
Weitere Informationen zur Verwaltung Ihrer Benachrichtigungsressourcen mit Terraform finden Sie in der [Grafana-Provider-Dokumentation](https://registry.terraform.io/providers/grafana/grafana/latest/docs) in der Terraform-Dokumentation.
Führen Sie die folgenden Aufgaben aus, um Ihre Benachrichtigungsressourcen mit Terraform zu erstellen und zu verwalten.
1. Erstellen Sie einen API-Schlüssel für die Bereitstellung.
1. Konfigurieren Sie den Terraform-Anbieter.
1. Definieren Sie Ihre Benachrichtigungsressourcen in Terraform.
1. Führen Sie aus`terraform apply`, um Ihre Alarm-Ressourcen bereitzustellen.
## Voraussetzungen
+ Stellen Sie sicher, dass Sie den grafana/grafana [Terraform-Anbieter](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 oder höher haben.
+ Stellen Sie sicher, dass Sie Grafana 9.1 oder höher verwenden. Wenn Sie Ihre Amazon Managed Grafana-Instance mit Grafana-Version 9 erstellt haben, trifft dies zu.
## Erstellen Sie einen API-Schlüssel für die Bereitstellung
Sie können [einen normalen Grafana-API-Schlüssel erstellen, um Terraform mit Grafana](Using-Grafana-APIs.md) zu authentifizieren. Die meisten vorhandenen Tools, die API-Schlüssel verwenden, sollten automatisch mit der neuen Grafana Alerting-Unterstützung funktionieren. Informationen speziell zum Erstellen von Schlüsseln für die Verwendung mit Terraform finden Sie unter [Verwenden von Terraform für die Amazon](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/) Managed Grafana-Automatisierung.
**So erstellen Sie einen API-Schlüssel für die Bereitstellung**
1. Erstellen Sie ein neues Dienstkonto für Ihre CI-Pipeline.
1. Weisen Sie die Rolle „Access the Alert Rules Provisioning API“ zu.
1. Erstellen Sie ein neues Dienstkonto-Token.
1. Benennen und speichern Sie das Token zur Verwendung in Terraform.
Alternativ können Sie die Standardauthentifizierung verwenden. Alle unterstützten Authentifizierungsformate finden Sie unter [Grafana-Authentifizierung](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) in der Terraform-Dokumentation.
## Konfigurieren Sie den Terraform-Anbieter
Die Unterstützung von Grafana Alerting ist im [Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Terraform-Anbieter enthalten.
Im Folgenden finden Sie ein Beispiel, mit dem Sie den Terraform-Anbieter konfigurieren können.
```
terraform {
required_providers {
grafana = {
source = "grafana/grafana"
version = ">= 1.28.2"
}
}
}
provider "grafana" {
url =
auth =
}
```
## Stellen Sie Kontaktpunkte und Vorlagen bereit
Kontaktstellen verbinden einen Alarm-Stack mit der Außenwelt. Sie teilen Grafana mit, wie Sie sich mit Ihren externen Systemen verbinden und wo Benachrichtigungen zugestellt werden sollen. Es stehen über fünfzehn verschiedene [Integrationen](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) zur Auswahl. In diesem Beispiel wird ein Slack-Kontaktpunkt verwendet.
**Um Kontaktpunkte und Vorlagen bereitzustellen**
1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer. Ersetze es ** durch deine Slack-Webhook-URL (oder einen anderen Kontakt).
In diesem Beispiel wird eine Kontaktstelle erstellt, die Warnmeldungen an Slack sendet.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
Benachrichtigungsrichtlinien teilen Grafana mit, wie Alarminstanzen weitergeleitet werden sollen, und nicht wohin. Sie verbinden ausgelöste Alarme mithilfe eines Systems von Labels und Matchern mit Ihren zuvor definierten Kontaktpunkten.
**Zur Bereitstellung von Benachrichtigungsrichtlinien und Routing**
1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.
In diesem Beispiel werden die Benachrichtigungen nach gruppiert`alertname`, was bedeutet, dass alle Benachrichtigungen, die von Benachrichtigungen stammen, die denselben Namen haben, in derselben Slack-Nachricht gruppiert werden.
Wenn du bestimmte Benachrichtigungen unterschiedlich weiterleiten möchtest, kannst du Unterrichtlinien hinzufügen. Mithilfe von Unterrichtlinien können Sie das Routing auf verschiedene Benachrichtigungen anwenden, die auf der Zuordnung von Bezeichnungen basieren. In diesem Beispiel wenden wir eine Stummschaltung auf alle Alarme mit der Bezeichnung a=b an.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. Verknüpfen Sie im Feld mute\$1timings einen Zeitpunkt der Stummschaltung mit Ihrer Benachrichtigungsrichtlinie.
1. Führen Sie den Befehl `terraform apply` aus.
1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihrer Benachrichtigungsrichtlinie.
**Anmerkung**
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Benachrichtigungsstapel immer mit Ihrem Code synchron bleibt.
1. Klicken Sie auf **Test**, um zu überprüfen, ob der Benachrichtigungspunkt ordnungsgemäß funktioniert.
## Stellen Sie Zeiten zur Stummschaltung bereit
Stummschaltungen bieten die Möglichkeit, Warnmeldungen für bestimmte Zeiträume stummzuschalten.
**Zur Bereitstellung von Timings für die Stummschaltung**
1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.
In diesem Beispiel sind Warnmeldungen am Wochenende stummgeschaltet.
```
resource "grafana_mute_timing" "my_mute_timing" {
name = "My Mute Timing"
intervals {
times {
start = "04:56"
end = "14:17"
}
weekdays = ["saturday", "sunday", "tuesday:thursday"]
months = ["january:march", "12"]
years = ["2025:2027"]
}
}
```
1. Führen Sie den Befehl `terraform apply` aus.
1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihres Mute-Timings.
1. Verweisen Sie mithilfe des `mute_timings` Felds in einer Benachrichtigungsrichtlinie auf Ihr neu erstelltes Timing für die Stummschaltung. Dadurch wird dein Timing für die Stummschaltung auf einige oder alle deine Benachrichtigungen angewendet.
**Anmerkung**
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Benachrichtigungsstapel immer mit Ihrem Code synchron bleibt.
1. Klicken Sie auf **Test**, um zu überprüfen, ob das Timing der Stummschaltung korrekt funktioniert.
## Regeln für Warnmeldungen bereitstellen
[Mit Warnungsregeln](v9-alerting-managerules.md) können Sie vor jeder Grafana-Datenquelle warnen. Dies kann eine Datenquelle sein, die Sie bereits konfiguriert haben, oder Sie können [Ihre Datenquellen in Terraform zusammen mit Ihren Warnungsregeln definieren](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source).
**Um Warnungsregeln bereitzustellen**
1. Erstellen Sie eine Datenquelle für die Abfrage und einen Ordner zum Speichern Ihrer Regeln.
In diesem Beispiel wird die [Konfigurieren Sie eine TestData Datenquelle zum Testen](testdata-data-source.md) Datenquelle verwendet.
Alerts können für jede Backend-Datenquelle in Grafana definiert werden.
```
resource "grafana_data_source" "testdata_datasource" {
name = "TestData"
type = "testdata"
}
resource "grafana_folder" "rule_folder" {
title = "My Rule Folder"
}
```
1. Definieren Sie eine Warnungsregel.
Weitere Informationen zu Warnungsregeln finden Sie unter [So erstellen Sie von Grafana](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/) verwaltete Benachrichtigungen.
1. Erstellen Sie eine Regelgruppe, die eine oder mehrere Regeln enthält.
In diesem Beispiel wird die `grafana_rule_group` Ressourcengruppe verwendet.
```
resource "grafana_rule_group" "my_rule_group" {
name = "My Alert Rules"
folder_uid = grafana_folder.rule_folder.uid
interval_seconds = 60
org_id = 1
rule {
name = "My Random Walk Alert"
condition = "C"
for = "0s"
// Query the datasource.
data {
ref_id = "A"
relative_time_range {
from = 600
to = 0
}
datasource_uid = grafana_data_source.testdata_datasource.uid
// `model` is a JSON blob that sends datasource-specific data.
// It's different for every datasource. The alert's query is defined here.
model = jsonencode({
intervalMs = 1000
maxDataPoints = 43200
refId = "A"
})
}
// The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
data {
datasource_uid = "__expr__"
// You can also create a rule in the UI, then GET that rule to obtain the JSON.
// This can be helpful when using more complex reduce expressions.
model = <
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sie können überprüfen, ob Ihre Warnressourcen in Grafana erstellt wurden.
**So zeigen Sie Ihre bereitgestellten Ressourcen in Grafana an**
1. Öffnen Sie Ihre Grafana-Instanz.
1. Navigieren Sie zu Alerting.
1. Klicken Sie auf einen Ressourcenordner für Warnmeldungen, z. B. auf Warnungsregeln.
Bereitgestellte Ressourcen werden als **Bereitgestellt** gekennzeichnet, sodass deutlich wird, dass sie nicht manuell erstellt wurden.
**Anmerkung**
Sie können bereitgestellte Ressourcen nicht von Grafana aus bearbeiten. Sie können die Ressourceneigenschaften nur ändern, indem Sie die Provisioning-Datei ändern und Grafana neu starten oder einen Hot-Reload durchführen. Dadurch wird verhindert, dass Änderungen an der Ressource vorgenommen werden, die überschrieben würden, wenn eine Datei erneut bereitgestellt oder ein Hot-Reload durchgeführt würde.
# Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Arbeitsbereiche, die Grafana-Benachrichtigungen nicht verwenden möchten, verwenden die klassischen Dashboard-Benachrichtigungen. Um zur neuen Grafana-Benachrichtigung zu wechseln, müssen Sie sich für die Funktion anmelden.
Sie können Ihre Amazon Managed Grafana-Instance so konfigurieren, dass Grafana-Benachrichtigungen mithilfe der AWS-Managementkonsole, der oder der Amazon Managed Grafana-API verwendet werden. AWS CLI Einzelheiten zur Konfiguration von Amazon Managed Grafana, einschließlich der Aktivierung oder Deaktivierung von Grafana-Benachrichtigungen, finden Sie unter. [Konfigurieren Sie einen Amazon Managed Grafana-Arbeitsbereich](AMG-configure-workspace.md)
**Anmerkung**
Wenn Sie Grafana-Benachrichtigungen verwenden, senden Warnregeln, die in Grafana und nicht in Prometheus definiert sind, mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Benachrichtigungen anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für in Prometheus Alertmanager erstellte Warnungen sendet.
Diese Einschränkung wurde in Amazon Managed Grafana-Arbeitsbereichen, die Grafana v10.4 und höher unterstützen, aufgehoben.
## Migration zum Grafana-Warnsystem
Wenn die Grafana-Warnung aktiviert ist, werden bestehende klassische Dashboard-Benachrichtigungen in ein Format migriert, das mit der Grafana-Warnung kompatibel ist. Auf der Seite „Benachrichtigungen“ Ihrer Grafana-Instanz können Sie die migrierten Benachrichtigungen zusammen mit neuen Benachrichtigungen anzeigen. Mit Grafana-Benachrichtigungen senden Ihre von Grafana verwalteten Alarmregeln mehrere Benachrichtigungen statt einer einzigen Warnung, wenn sie übereinstimmen.
Der Lese- und Schreibzugriff auf klassische Dashboard-Benachrichtigungen und Grafana-Benachrichtigungen wird durch die Berechtigungen der Ordner geregelt, in denen sie gespeichert sind. Während der Migration werden die klassischen Dashboard-Warnungsberechtigungen wie folgt den neuen Regelberechtigungen zugeordnet:
+ Wenn das Dashboard der ursprünglichen Warnung über Berechtigungen verfügt, wird bei der Migration ein Ordner mit diesem Format erstellt`Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}`, der den Berechtigungen des ursprünglichen Dashboards entspricht (einschließlich der geerbten Berechtigungen aus dem Ordner).
+ Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard unter einem Ordner befindet, wird die Regel mit diesem Ordner verknüpft und erbt dessen Berechtigungen.
+ Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard im Ordner Allgemein befindet, wird die Regel mit dem Ordner Allgemeine Benachrichtigungen verknüpft, und die Regel erbt die Standardberechtigungen.
**Anmerkung**
Da es `NoData` in Grafana-Benachrichtigungen keine `Keep Last State` Option gibt, wird diese Option `NoData` bei der klassischen Regelmigration aktiviert. Die Option `Keep Last State` für die `Error` Handhabung wurde auf eine neue Option migriert. `Error` Um dem Verhalten der zu entsprechen`Keep Last State`, erstellt Amazon Managed Grafana in beiden Fällen während der Migration automatisch eine Stille für jede Alarmregel mit einer Dauer von einem Jahr.
Benachrichtigungskanäle werden auf eine Alertmanager-Konfiguration mit den entsprechenden Routen und Empfängern migriert. Standardbenachrichtigungskanäle werden als Kontaktpunkte zur Standardroute hinzugefügt. Benachrichtigungskanäle, die keiner Dashboard-Warnung zugeordnet sind, führen zur `autogen-unlinked-channel-recv` Route.
### Einschränkungen
+ Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Warnregeln aus anderen unterstützten Datenquellen abzurufen.
+ Die Migration zwischen Grafana-Benachrichtigungen und den klassischen Dashboard-Benachrichtigungen kann zu Datenverlust für Funktionen führen, die in einem System unterstützt werden, im anderen jedoch nicht.
**Anmerkung**
Wenn Sie zurück zur klassischen Dashboard-Warnung migrieren, verlieren Sie alle Änderungen, die an der Warnungskonfiguration vorgenommen wurden, während Sie die Grafana-Warnung aktiviert hatten, einschließlich aller neuen Warnungsregeln, die erstellt wurden.
# Verwalte deine Alarmregeln
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Eine Warnregel besteht aus einer Reihe von Bewertungskriterien, die bestimmen, ob eine Warnung ausgelöst wird. Die Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, für die die Bedingung erfüllt ist.
Abfragen und Ausdrücke wählen zwar den Datensatz aus, der ausgewertet werden soll, aber eine Bedingung legt den Schwellenwert fest, den eine Warnung erfüllen oder überschreiten muss, um eine Warnung zu erzeugen. Ein Intervall gibt an, wie oft eine Warnungsregel ausgewertet wird. Die Dauer gibt, sofern konfiguriert, an, wie lange eine Bedingung erfüllt sein muss. Warnungsregeln können auch das Warnverhalten bei fehlenden Daten definieren.
**Anmerkung**
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.
Warnungsregeln für eine externe Grafana Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.
**Topics**
+ [Von Grafana verwaltete Alarmregeln erstellen](v9-alerting-managerules-grafana.md)
+ [Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen](v9-alerting-managerules-mimir-loki.md)
+ [Erstellen von verwalteten Aufnahmeregeln mit Grafana, Mimir oder Loki](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir oder Loki Regelgruppen und Namespaces](v9-alerting-managerules-mimir-loki-groups.md)
+ [Warnregeln anzeigen und bearbeiten](v9-alerting-managerules-view-edit.md)
# Von Grafana verwaltete Alarmregeln erstellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Grafana ermöglicht es Ihnen, Warnregeln zu erstellen, die eine oder mehrere Datenquellen abfragen, die Ergebnisse reduzieren oder transformieren und sie miteinander oder mit festen Schwellenwerten vergleichen. Wenn diese ausgeführt werden, sendet Grafana Benachrichtigungen an die Kontaktstelle.
**So fügen Sie eine verwaltete Grafana-Regel hinzu**
1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen.
1. **Wählen Sie Neue Warnungsregel.**
1. Fügen Sie in **Schritt 1** den Namen, den Typ und den Speicherort der Regel wie folgt hinzu:
+ Fügen Sie im **Feld Regelname** einen beschreibenden Namen hinzu. 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.
+ Wählen Sie **in der Dropdownliste Regeltyp** die Option **Grafana Managed** Alert aus.
+ Wählen Sie aus der Dropdownliste **Ordner** den Ordner aus, in dem Sie die Regel speichern möchten. Wenn Sie keinen Ordner auswählen, wird die Regel in dem `General` Ordner gespeichert. Um einen Ordner zu erstellen, wählen Sie das Drop-down-Menü aus und geben Sie einen neuen Ordnernamen ein.
1. Fügen Sie in **Schritt 2** die auszuwertenden Abfragen und Ausdrücke hinzu.
+ Behalten Sie den Standardnamen bei oder bewegen Sie den Mauszeiger darüber und wählen Sie das Bearbeitungssymbol, um den Namen zu ändern.
+ Wählen Sie für Abfragen eine Datenquelle aus der Dropdownliste aus.
+ Fügen Sie eine oder mehrere [Abfragen oder Ausdrücke](v9-panels-query-xform-expressions.md) hinzu.
+ Wählen Sie für jeden Ausdruck entweder **klassische Bedingung** aus, um eine einzelne Warnungsregel zu erstellen, oder wählen Sie aus den Optionen **Mathe**, **Reduce**, **Resample**, um separate Alerts für jede Serie zu generieren. Einzelheiten zu diesen Optionen finden Sie unter[Ein- und mehrdimensionale Regeln](#v9-alerting-single-multi-rule).
+ Wählen Sie **Abfragen ausführen**, um zu überprüfen, ob die Abfrage erfolgreich ist.
1. Fügen Sie in **Schritt 3** Bedingungen hinzu.
+ Wählen Sie in der Dropdownliste **Bedingung** die Abfrage oder den Ausdruck aus, mit dem die Warnungsregel initiiert werden soll.
+ Geben **Sie für Alle auswerten** die Häufigkeit der Auswertung an. Muss ein Vielfaches von 10 Sekunden sein. Zum Beispiel `1m`, `30s`.
+ Geben Sie unter **Evaluieren für** die Dauer an, für die die Bedingung erfüllt sein muss, bevor eine Warnung ausgelöst wird.
**Anmerkung**
Wenn eine Bedingung verletzt wurde, geht die Warnung in den `Pending` Status über. Bleibt die Bedingung für die angegebene Dauer verletzt, wechselt die Warnung in den `Firing` Status. Wenn sie nicht mehr erfüllt ist, wird der `Normal` Status wiederhergestellt.
+ **Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung** das Warnverhalten bei fehlenden Daten. Beachten Sie die Richtlinien unter. [Es werden keine Daten- oder Fehlerfälle behandelt](#v9-alerting-rule-no-data-error)
+ Wählen Sie „**Warnmeldungen in der Vorschau**“, um das Ergebnis der Ausführung der Abfrage in diesem Moment zu überprüfen. In der Vorschau sind keine Daten und keine Bedingungen für die Fehlerbehandlung enthalten.
1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
+ Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Beschriftungen und Anmerkungen](v9-alerting-explore-labels.md).
+ Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
+ Fügen Sie benutzerdefinierte Labels hinzu.
1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.
Nachdem Sie Ihre Regel erstellt haben, können Sie eine Benachrichtigung für Ihre Regel erstellen. Weitere Informationen zu Benachrichtigungen finden Sie unter [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md).
## Ein- und mehrdimensionale Regeln
Für von Grafana verwaltete Warnungsregeln können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen.
**Eindimensionale Regel (klassische Bedingung)**
Verwenden Sie einen 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.
Weitere Informationen zum Formatieren von Ausdrücken finden Sie unter [Ausdrücke](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) in der *Grafana-Dokumentation*.
**Mehrdimensionale Regel**
Um für jede in der Abfrage zurückgegebene Serie eine separate Warnungsinstanz zu generieren, erstellen Sie eine multidimensionale Regel.
**Anmerkung**
Jede durch eine multidimensionale Regel generierte Warnungsinstanz wird auf Ihr Gesamtkontingent an Warnmeldungen angerechnet. Regeln werden nicht ausgewertet, wenn Sie Ihr Alert-Kontingent erreicht haben. Weitere Informationen zu Kontingenten für mehrdimensionale Regeln finden Sie unter[Fehler beim Erreichen des Kontingents](#v9-alerting-rule-quota-reached).
Um mehrere Instanzen aus einer einzigen Regel zu erstellen, verwenden Sie, oder `Resample` Ausdrücke `Math``Reduce`, um eine multidimensionale Regel zu erstellen. Beispielsweise ist Folgendes möglich:
+ 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](v9-alerting-explore-numeric.md)).
+ Fügen Sie einen `Math` Ausdruck mit der Bedingung für die Regel hinzu. Dies ist nicht erforderlich, wenn eine Abfrage oder ein Reduce-Ausdruck bereits 0 zurückgibt, wenn die Regel keine Warnung auslösen soll, oder eine positive Zahl, wenn sie eine Warnung auslösen soll.
Hier einige Beispiele:
+ `$B > 70`wenn sie eine Warnung auslösen soll, falls der Wert von B größer als 70 query/expression ist.
+ `$B < $C * 100`falls es eine Warnung auslösen soll, 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 auf der Community-Seite. [Vorlagenvariablen werden bei der Einrichtung von Alert in Warnungsabfragen nicht unterstützt](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).
**Überlegungen zur Leistung multidimensionaler Regeln**
Jede Warnungsinstanz wird auf das Warnungskontingent angerechnet. Mehrdimensionale Regeln, die mehr Instanzen erstellen, als innerhalb des Warnungskontingents untergebracht werden können, werden nicht ausgewertet und geben einen Kontingentfehler zurück. Weitere Informationen finden Sie unter [Fehler beim Erreichen des Kontingents](#v9-alerting-rule-quota-reached).
Mehrdimensionale Benachrichtigungen können einen großen Einfluss auf die Leistung Ihres Grafana-Workspace sowie auf die Leistung Ihrer Datenquellen haben, da Grafana sie abfragt, um Ihre Warnungsregeln auszuwerten. Die folgenden Überlegungen können hilfreich sein, wenn Sie versuchen, die Leistung Ihres Überwachungssystems zu optimieren.
+ **Häufigkeit der Regelauswertung** — Die Eigenschaft „**Alle auswerten**“ einer Warnungsregel steuert die Häufigkeit der Regelauswertung. Wir empfehlen, die niedrigste akzeptable Evaluierungshäufigkeit zu verwenden.
+ **Kardinalität der Ergebnismenge** — Die Anzahl der Warnungsinstanzen, die Sie mit einer Regel erstellen, wirkt sich auf deren Leistung aus. Angenommen, Sie überwachen API-Antwortfehler für jeden API-Pfad auf jeder VM in Ihrer Flotte. Dieser Satz hat eine Kardinalität der Anzahl der Pfade multipliziert mit der Anzahl von. VMs Sie können die Kardinalität der Ergebnismenge reduzieren, indem Sie beispielsweise die Gesamtanzahl der Fehler pro VM statt pro Pfad pro VM überwachen.
+ **Komplexität der Abfrage** — Abfragen, die Datenquellen schnell verarbeiten und beantworten können, verbrauchen weniger Ressourcen. Diese Überlegung ist zwar weniger wichtig als die anderen oben aufgeführten Überlegungen, aber wenn Sie sie so weit wie möglich reduziert haben, könnte die Betrachtung der individuellen Abfrageleistung einen Unterschied machen. Sie sollten sich auch der Auswirkungen bewusst sein, die die Bewertung dieser Regeln auf die Leistung Ihrer Datenquellen hat. Warnabfragen machen häufig die überwiegende Mehrheit der Abfragen aus, die von Überwachungsdatenbanken verarbeitet werden. Daher wirken sich dieselben Auslastungsfaktoren, die sich auf die Grafana-Instanz auswirken, auch auf sie aus.
## Fehler beim Erreichen des Kontingents
Es gibt ein Kontingent für die Anzahl der Warnungsinstanzen, die Sie in einem einzelnen Workspace haben können. Wenn Sie diese Anzahl erreichen, können Sie in diesem Workspace keine neuen Warnungsregeln mehr erstellen. Bei mehrdimensionalen Benachrichtigungen kann die Anzahl der Warnungsinstanzen im Laufe der Zeit variieren.
Bei der Arbeit mit Warnungsinstanzen sollten Sie Folgendes beachten.
+ Wenn Sie nur eindimensionale Regeln erstellen, ist jede Regel eine einzelne Warnungsinstanz. Sie können in einem einzigen Workspace die gleiche Anzahl von Regeln erstellen wie Ihr Kontingent für Warnungsinstanzen, und nicht mehr.
+ Mehrdimensionale Regeln erzeugen mehrere Warnungsinstanzen, deren Anzahl jedoch erst bekannt ist, wenn sie ausgewertet wurden. Wenn Sie beispielsweise eine Warnungsregel erstellen, die die CPU-Auslastung Ihrer Amazon EC2 EC2-Instances verfolgt, gibt es bei der Erstellung möglicherweise 50 EC2-Instances (und somit 50 Alert-Instances). Wenn Sie jedoch eine Woche später 10 weitere EC2-Instances hinzufügen, umfasst die nächste Auswertung 60 Alert-Instances.
Die Anzahl der Alert-Instances wird ausgewertet, wenn Sie eine multidimensionale Warnung erstellen, und Sie können keine erstellen, bei der Sie sofort Ihr Alert-Instance-Kontingent überschreiten. Da sich die Anzahl der Warnungsinstanzen ändern kann, wird Ihr Kontingent bei jeder Auswertung Ihrer Regeln überprüft.
+ Wenn Sie bei der Regelauswertung aufgrund einer Regel Ihr Kontingent für Warnungsinstanzen überschreiten, wird diese Regel erst evaluiert, wenn die Warnungsregel aktualisiert wird, sodass die Gesamtzahl der Warnungsinstanzen unter das Dienstkontingent fällt. In diesem Fall erhalten Sie eine Warnmeldung, die Sie darüber informiert, dass Ihr Kontingent erreicht wurde (die Benachrichtigung verwendet die Benachrichtigungsrichtlinie für die auszuwertende Regel). Die Benachrichtigung enthält eine `Error` Anmerkung mit dem Wert`QuotaReachedError`.
+ Eine Regel, die bewirkt, dass a `QuotaReachedError` nicht mehr ausgewertet wird. Die Auswertung wird nur dann wieder aufgenommen, wenn ein Update vorgenommen wird und die Auswertung nach dem Update selbst keine Ursache hat`QuotaReachedError`. Eine Regel, die nicht ausgewertet wird, zeigt in der Grafana-Konsole den Fehler **Kontingent erreicht** an.
+ Sie können die Anzahl der Warnungsinstanzen verringern, indem Sie Warnungsregeln entfernen oder indem Sie mehrdimensionale Warnungen bearbeiten, sodass weniger Warnungsinstanzen angezeigt werden (z. B. indem Sie eine Warnung bei Fehlern pro VM anstelle einer Warnung bei Fehlern pro API in einer VM haben).
+ Um die Evaluierungen fortzusetzen, aktualisieren Sie die Warnung und speichern Sie sie. Sie können es aktualisieren, um die Anzahl der Warnungsinstanzen zu verringern, oder wenn Sie andere Änderungen vorgenommen haben, um die Anzahl der Warnungsinstanzen zu verringern, können Sie es unverändert speichern. Wenn es wieder aufgenommen werden kann, ist es das auch. Wenn es ein anderes verursacht`QuotaReachedError`, können Sie es nicht speichern.
+ Wenn eine Warnung gespeichert wird und die Auswertung wieder aufgenommen wird, ohne das Warnungskontingent zu überschreiten, kann der Fehler **Kontingent erreicht** noch einige Zeit (bis zum Bewertungsintervall) in der Grafana-Konsole angezeigt werden. Die Auswertung der Warnungsregel wird jedoch gestartet und es werden Warnungen gesendet, wenn der Regelschwellenwert erreicht ist.
+ Einzelheiten zur Quote für Warnmeldungen sowie zu anderen Kontingenten finden Sie unter. [Amazon Managed Grafana-Servicekontingente](AMG_quotas.md)
## Es werden keine Daten- oder Fehlerfälle behandelt
Wählen Sie Optionen für den Umgang mit Warnmeldungen, wenn keine Daten vorliegen oder Fehler auftreten.
Die Optionen für den Umgang mit fehlenden Daten sind in der folgenden Tabelle aufgeführt.
| Option „Keine Daten“ | Behavior |
| --- | --- |
| Keine Daten | Erstellen Sie eine Warnung `DatasourceNoData` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. |
| Warnfunktion | Legen Sie den Status der Warnungsregel auf fest. `Alerting` |
| OK | Stellen Sie den Status der Warnungsregel auf ein`Normal`. |
Die Optionen für die Behandlung von Fehlerfällen sind in der folgenden Tabelle aufgeführt.
| Fehler- oder Timeout-Option | Behavior |
| --- | --- |
| Warnfunktion | Setzen Sie den Status der Warnungsregel auf `Alerting` |
| OK | Legen Sie den Status der Warnungsregel fest auf `Normal` |
| Fehler | Erstellen Sie eine Warnung `DatasourceError` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. |
# Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Mit Grafana können Sie Warnregeln für eine externe Grafana-Mimir- oder Loki-Instanz erstellen.
**Anmerkung**
Grafana Mimir kann eine Verbindung zu Amazon Managed Service for Prometheus- und Prometheus-Datenquellen herstellen.
**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus-Datenquelle haben. Andernfalls können Sie keine von Cortex verwalteten Warnregeln erstellen oder aktualisieren.
+ Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen die 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 Speichertypen.
+ **Grafana Mimir** — Verwenden Sie das `/api/prom` Legacy-Präfix, nicht. `/prometheus` Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sich sowohl die Query-API als auch die Ruler-API unter derselben URL befinden. Sie können keine separate URL für die Ruler-API angeben.
**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 UI verwalten**.
**So fügen Sie eine verwaltete Alarmregel mit Grafana, Mimir oder Loki hinzu**
1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die **Warnseite mit den vorhandenen Benachrichtigungen** zu öffnen.
1. **Wählen Sie Warnungsregel erstellen.**
1. Wählen Sie in **Schritt 1** den Regeltyp und die Details wie folgt aus:
+ Wählen Sie **Mimir oder Loki Alert**.
+ Fügen Sie im **Feld Regelname** einen aussagekräftigen Namen hinzu. 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.
+ **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus.
+ Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](alert-rules.md#alert-rule-groups).
+ Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden am Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.
1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu.
Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt.
1. Geben Sie in **Schritt 3** das Bewertungsintervall für die Warnung an.
Geben Sie im Textfeld **Für** der Bedingung die Dauer an, für die die Bedingung erfüllt sein muss, bevor die Warnung ausgelöst wird. Wenn Sie angeben`5m`, müssen die Bedingungen fünf Minuten lang erfüllt sein, bevor die Warnung ausgelöst wird.
**Anmerkung**
Wenn 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. Wenn sie nicht mehr erfüllt ist, wird der `Normal` Status wiederhergestellt.
1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
+ Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen anzupassen. Verwenden Sie die Richtlinien in[Beschriftungen und Anmerkungen](v9-alerting-explore-labels.md).
+ Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
+ Fügen Sie benutzerdefinierte Labels hinzu.
1. Wählen Sie „**Warnmeldungen in der Vorschau anzeigen**“, um die Regel auszuwerten und zu sehen, welche Warnmeldungen sie ausgeben würde. Es wird eine Liste von Warnmeldungen mit Status und Wert der einzelnen Warnungen angezeigt.
1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.
Nachdem Sie Ihre Regel erstellt haben, können Sie eine Benachrichtigung für Ihre Regel erstellen. Weitere Informationen zu Benachrichtigungen finden Sie unter [Verwalte deine Warnmeldungen](v9-alerting-managenotifications.md).
# Erstellen von verwalteten Aufnahmeregeln mit Grafana, Mimir oder Loki
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sie können Aufzeichnungsregeln für eine externe Instanz von Grafana Mimir oder Loki erstellen und verwalten. Aufzeichnungsregeln berechnen häufig benötigte Ausdrücke oder rechenaufwändige Ausdrücke im Voraus und speichern das Ergebnis als neue Zeitreihe. Die Abfrage dieser neuen Zeitreihe ist schneller, insbesondere bei Dashboards, da bei jeder Aktualisierung der Dashboards derselbe Ausdruck abgefragt wird.
**Voraussetzungen**
Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen die 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 Speichertypen.
+ **Grafana Mimir** — Wenn Sie eine Datenquelle so konfigurieren, dass sie auf Grafana Mimir verweist, verwenden Sie das `/api/prom` Legacy-Präfix, nicht. `/prometheus` Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sich sowohl die Query-API als auch die Ruler-API unter derselben URL befinden. Sie können keine separate URL für die Ruler-API angeben.
**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 UI verwalten**.
**So fügen Sie eine Regel für verwaltete Aufzeichnungen mit Grafana, Mimir oder Loki hinzu**
1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen.
1. **Wählen Sie Warnungsregel erstellen.**
1. Fügen Sie in **Schritt 1** den Regeltyp, den Regelnamen und den Speicherort wie folgt hinzu.
+ Wählen Sie die Option **Mimir- oder Loki-Aufnahmeregel** aus.
+ Fügen Sie im **Feld Regelname** einen aussagekräftigen Namen hinzu. 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.
+ **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus.
+ Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](alert-rules.md#alert-rule-groups).
+ Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.
1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu.
Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt.
1. Fügen Sie in **Schritt 3** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind.
+ Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Anmerkungen und Beschriftungen für Warnregeln](alert-rules.md#alert-rule-labels).
+ Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu.
+ Fügen Sie benutzerdefinierte Labels hinzu.
1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren.
# Grafana Mimir oder Loki Regelgruppen und Namespaces
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sie können Ihre Regeln organisieren. Regeln werden innerhalb von Regelgruppen erstellt, und Regelgruppen sind in Namespaces organisiert. Die Regeln innerhalb einer Regelgruppe werden nacheinander in regelmäßigen Abständen ausgeführt. Das Standardintervall ist eine Minute. Sie können Grafana Mimir- oder Loki-Namespaces und Regelgruppen umbenennen und die Bewertungsintervalle für Regelgruppen bearbeiten.
**Um eine Regelgruppe oder einen Namespace zu bearbeiten**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**
1. Navigieren Sie zu einer Regel innerhalb der Regelgruppe oder des Namespace, die Sie bearbeiten möchten.
1. Wählen Sie das Symbol **Bearbeiten** (Stift).
1. Nehmen Sie Änderungen an der Regelgruppe oder dem Namespace vor.
**Anmerkung**
Bei Namespaces können Sie nur den Namen bearbeiten. Bei Regelgruppen ändern Sie den Namen oder das Bewertungsintervall für Regeln in der Gruppe. Sie können beispielsweise festlegen`1m`, dass die Regeln einmal pro Minute oder `30s` einmal alle 30 Sekunden ausgewertet werden.
1. Wählen Sie **Änderungen speichern ** aus.
# Warnregeln anzeigen und bearbeiten
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Auf der Seite „**Benachrichtigungen“ werden Warnregeln aufgeführt.** Standardmäßig sind Regeln nach Datenquellentypen gruppiert. Der **Grafana-Abschnitt** listet Regeln auf, die von Grafana verwaltet werden, und der Abschnitt **Cortex/Loki** listet Regeln für Prometheus-kompatible Datenquellen auf. Sie können Warnregeln für Prometheus-kompatible Datenquellen anzeigen, sie jedoch nicht bearbeiten.
Im Abschnitt Mimir/Cortex/Loki Regeln sind alle Regeln für Mimir-, Cortex- oder Loki-Datenquellen aufgeführt. Cloud-Warnungsregeln sind ebenfalls in diesem Abschnitt aufgeführt.
Bei der Verwaltung großer Mengen von Benachrichtigungen können Sie erweiterte Funktionen zur Suche nach Warnungsregeln verwenden, um nach Ordnern, Bewertungsgruppen und Regeln zu filtern. Darüber hinaus können Sie Warnungsregeln nach ihren Eigenschaften wie Bezeichnungen, Status, Typ und Zustand filtern.
**Anmerkung**
Sie können Abfragedefinitionen für bereitgestellte Benachrichtigungen anzeigen, sie jedoch nicht bearbeiten. Wenn Sie sie anzeigen können, können Sie überprüfen, ob Ihre Abfragen und Regeldefinitionen korrekt sind, ohne zu Ihrem Provisioning-Repository für Regeldefinitionen zurückkehren zu müssen.
## Regeln für Warnmeldungen anzeigen
Mit Grafana-Benachrichtigungen können Sie alle Ihre Benachrichtigungen auf einer Seite anzeigen.
**Um die Details der Benachrichtigungen anzuzeigen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** Standardmäßig werden Regeln in Gruppen nach Datenquellentyp angezeigt. Sie können die einzelnen Warnmeldungen auch anhand des aktuellen Status anzeigen (diese werden im folgenden Text ausführlicher beschrieben).
1. In „**Anzeigen als**“ können Sie zwischen der Gruppen- und der Statusansicht wechseln, indem Sie die von Ihnen bevorzugte Option auswählen.
1. Wählen Sie den Pfeil neben einer Zeile, um weitere Details zu dieser Zeile anzuzeigen. Zu den Details einer Regel gehören die Regelbezeichnungen, Anmerkungen, Datenquellen und Abfragen sowie eine Liste der Warnungsinstanzen, die sich aus der Regel ergeben.
**Anmerkung**
Weitere Informationen zum Verständnis der Details Ihrer Benachrichtigungen finden Sie unter[Stand und Zustand der Warnregeln](v9-alerting-explore-state.md).
**Gruppenansicht**
Die Gruppenansicht zeigt Grafana-Alarmregeln gruppiert nach Ordnern und Loki- oder Prometheus-Alarmregeln gruppiert nach \$1. `namespace` `group` Dies ist die Standardregellistenansicht, die für die Verwaltung von Regeln vorgesehen ist. Sie können jede Gruppe erweitern, um eine Liste der Regeln in dieser Gruppe anzuzeigen. Erweitern Sie eine Regel weiter, um ihre Details anzuzeigen. Sie können auch Aktionsschaltflächen und Warnmeldungen, die sich aus der Regel ergeben, erweitern, um deren Details anzuzeigen.
**Ansicht „Status“**
In der Statusansicht werden die Warnungsregeln nach Bundesland gruppiert angezeigt. Verwenden Sie diese Ansicht, um einen Überblick darüber zu erhalten, welche Regeln sich in welchem Status befinden. Jede Regel kann erweitert werden, um ihre Details anzuzeigen. Aktionsschaltflächen und alle durch diese Regel generierten Warnungen. Jede Warnung kann weiter erweitert werden, um ihre Details anzuzeigen.
**Regeln für die Filterung von Warnmeldungen**
Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen“ angezeigt werden, auf verschiedene** Arten filtern.
+ Sie können filtern, um die Regeln anzuzeigen, die eine bestimmte Datenquelle abfragen, indem **Sie Datenquellen auswählen** und dann eine Datenquelle auswählen, nach der gefiltert werden soll.
+ Sie können nach Bezeichnungen filtern, indem Sie unter Nach **Bezeichnung suchen die gewünschten** Suchkriterien auswählen. Sie könnten beispielsweise eingeben, `environment=production,region=~US|EU,severity!=warning` um nach Produktionswarnungen in den USA und der EU zu filtern.
+ Sie können filtern, um die Regeln in einem bestimmten Bundesstaat anzuzeigen, indem Sie die Option **Benachrichtigungen nach Bundesland filtern** und dann den Bundesstaat auswählen, den Sie anzeigen möchten.
## Warnungsregeln bearbeiten oder löschen
Von Grafana verwaltete Alarmregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind. Warnregeln für eine externe Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.
**Um eine Regel zu bearbeiten oder zu löschen**
1. Erweitern Sie eine Regel, bis Sie die Regelsteuerelemente für **Anzeigen**, **Bearbeiten** und **Löschen** sehen können.
1. Wählen Sie **Bearbeiten**, um die Seite „Regel erstellen“ zu öffnen. Nehmen Sie Aktualisierungen auf die gleiche Weise vor, wie Sie eine Regel erstellen. Einzelheiten finden Sie in den Anweisungen unter [Von Grafana verwaltete Alarmregeln erstellen](v9-alerting-managerules-grafana.md) oder[Regeln für verwaltete Benachrichtigungen mit Grafana Mimir oder Loki erstellen](v9-alerting-managerules-mimir-loki.md).
1. Wählen Sie optional **Löschen**, um eine Regel zu löschen.
## Warnungsregeln exportieren
**Sie können Regeln im Grafana-Arbeitsbereich nach YAML oder JSON exportieren, indem Sie Exportieren wählen.** Sie haben die Möglichkeit, eine neue Regel zu definieren und diese dann zu exportieren. Sie können eine Regel mithilfe der Benutzeroberfläche erstellen und sie dann zur Verwendung in der Provisioning-API oder in Terraform-Skripten exportieren.
**Anmerkung**
Dies wird sowohl im Grafana-Workspace als auch in der Provisioning-Schnittstelle unterstützt.
# Verwalte deine Warnmeldungen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Die Entscheidung, wie, wann und wohin Ihre Warnmeldungen gesendet werden sollen, ist ein wichtiger Bestandteil der Einrichtung Ihres Warnsystems. Diese Entscheidungen wirken sich direkt auf Ihre Fähigkeit aus, Probleme schnell zu lösen und nichts Wichtiges zu verpassen.
Definieren Sie als ersten Schritt Ihre *Kontaktstellen* und an wen Sie Ihre Warnmeldungen senden möchten. Bei einer Kontaktstelle kann es sich um eine Reihe von Zielen für passende Benachrichtigungen handeln. Fügen Sie Benachrichtigungsvorlagen zu Kontaktpunkten hinzu, um sie wiederzuverwenden und die Nachrichtenübermittlung in Ihren Benachrichtigungen einheitlich zu gestalten.
Erstellen Sie als Nächstes eine *Benachrichtigungsrichtlinie*. Dabei handelt es sich um eine Reihe von Regeln dafür, wo, wann und wie Ihre Benachrichtigungen an Kontaktstellen weitergeleitet werden. In einer Benachrichtigungsrichtlinie definieren Sie, wohin Ihre Warnmeldungen gesendet werden sollen, indem Sie eine der von Ihnen erstellten Kontaktstellen auswählen. Fügen Sie Ihrer Benachrichtigungsrichtlinie Zeiten für die Stummschaltung hinzu. Eine *Stummschaltung* ist ein wiederkehrendes Zeitintervall, in dem du nicht möchtest, dass Benachrichtigungen versendet werden.
Wenn eine Warnungsregel ausgewertet wird, sendet die Warnmeldungsinstanz Warninstanzen an den Alertmanager — eine Warnungsregel kann mehrere einzelne *Warnungsinstanzen* auslösen.
Der Alertmanager empfängt diese Warnungsinstanzen und kümmert sich dann um die Stummschaltung, gruppiert Alarme und sendet Benachrichtigungen an Ihre Kontaktstellen, wie in der Benachrichtigungsrichtlinie definiert.
**Topics**
+ [Alert-Manager](v9-alerting-managenotifications-alertmanager.md)
+ [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md)
+ [Mit Benachrichtigungsrichtlinien arbeiten](v9-alerting-notification-policies.md)
+ [Benachrichtigungen anpassen](v9-alerting-notifications.md)
+ [Stummschalten von Warnmeldungen für Prometheus-Datenquellen](v9-alerting-silences.md)
+ [Timings stummschalten](v9-alerting-notification-muting.md)
+ [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v9-alerting-viewfiltergroups.md)
+ [Benachrichtigungsfehler anzeigen](v9-alerting-viewnotificationerrors.md)
# Alert-Manager
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Mit Alertmanager können Sie Warnmeldungen schnell und effizient verwalten und darauf reagieren. Er empfängt Benachrichtigungen, kümmert sich um Stummschaltung, Sperrung, Gruppierung und Weiterleitung, indem er Benachrichtigungen über den Kanal Ihrer Wahl versendet, z. B. E-Mail oder Slack.
In Grafana können Sie den Grafana Alertmanager oder einen externen Alertmanager verwenden. Sie können auch mehrere Alertmanager ausführen. Ihre Entscheidung hängt von Ihrer Einrichtung ab und davon, wo Ihre Benachrichtigungen generiert werden.
**Grafana Alarmmanager**
Grafana Alertmanager ist ein interner Alertmanager, der vorkonfiguriert ist und standardmäßig ausgewählt werden kann, wenn Sie Grafana vor Ort oder als Open Source ausführen.
Der Grafana Alertmanager kann Benachrichtigungen von Grafana empfangen, aber er kann keine Benachrichtigungen von außerhalb von Grafana empfangen, z. B. von Mimir oder Loki.
**Anmerkung**
Inhibitionsregeln werden im Grafana Alertmanager nicht unterstützt.
**Externer Alertmanager**
Wenn Sie einen einzigen Alertmanager verwenden möchten, um alle Ihre Grafana-, Loki-, Mimir- und Prometheus-Benachrichtigungen zu erhalten, können Sie Grafana so einrichten, dass ein externer Alertmanager verwendet wird. Dieser externe Alertmanager kann in Grafana selbst konfiguriert und verwaltet werden.
Hier sind zwei Beispiele dafür, wann Sie vielleicht Ihren eigenen externen Alertmanager konfigurieren und Ihre Benachrichtigungen anstelle des Grafana-Alertmanagers dorthin senden möchten:
1. Sie haben bereits Alertmanager vor Ort in Ihrer eigenen Cloud-Infrastruktur, die Sie eingerichtet haben und weiterhin verwenden möchten, da Sie über andere Alert-Generatoren wie Prometheus verfügen.
1. Sie möchten sowohl Prometheus vor Ort als auch gehostetes Grafana verwenden, um Benachrichtigungen an denselben Alertmanager zu senden, der in Ihrer Cloud-Infrastruktur ausgeführt wird.
Alertmanager sind im Drop-down-Menü auf den Seiten Alerting Contact Points und Notification Policies sichtbar.
Wenn Sie Ihre Datenquelle bereitstellen, setzen Sie die Markierung `handleGrafanaManagedAlerts` im `jsonData` Feld auf, um von Grafana verwaltete Benachrichtigungen an diesen Alertmanager `true` zu senden.
# Mit Kontaktstellen 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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Eine Kontaktstelle kann über eine oder mehrere Kontaktpunktintegrationen verfügen, z. B. Amazon Simple Notification Service oder Slack. Wenn eine Warnung ausgelöst wird, wird eine Benachrichtigung an alle Kontaktpunkt-Integrationen gesendet, die für eine Kontaktstelle aufgeführt sind. Verwenden Sie optional [Benachrichtigungsvorlagen](v9-alerting-create-templates.md), um die Benachrichtigungen an die Kontaktpunkttypen anzupassen.
**Anmerkung**
Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktpunkte für Alertmanager-Benachrichtigungen sind schreibgeschützt.
## Mit Kontaktpunkten arbeiten
In den folgenden Verfahren wird detailliert beschrieben, wie Kontaktpunkte hinzugefügt, bearbeitet, getestet und gelöscht werden.
**Um eine Kontaktstelle hinzuzufügen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**
1. **Wählen Sie **Kontaktpunkte** und dann Kontaktstelle hinzufügen.**
1. Wählen Sie im Drop-down-Menü **Alertmanager** einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt.
1. Geben Sie einen **Namen** für die Kontaktstelle ein.
1. Wählen **Sie unter Kontaktpunktintegration** einen Typ und die darauf basierenden Pflichtfelder aus. Wenn du dich beispielsweise für Slack entscheidest, gib die Slack-Kanäle und Benutzer ein, die kontaktiert werden sollen.
1. Falls für den von dir ausgewählten Kontaktpunkt verfügbar, wähle die gewünschten **optionalen Einstellungen, um zusätzliche Einstellungen** festzulegen.
1. Wählen Sie unter **Benachrichtigungseinstellungen** optional die Option **Gelöste Nachricht deaktivieren** aus, wenn Sie nicht benachrichtigt werden möchten, wenn eine Warnung behoben wird.
1. Wenn Ihre Kontaktstelle mehr Kontaktpunkttypen benötigt, können Sie **Kontaktpunktintegration hinzufügen** auswählen und die Schritte für jeden benötigten Kontaktpunkttyp wiederholen.
1. Wählen Sie **Kontaktpunkt speichern**, um Ihre Änderungen zu speichern.
**Um eine Kontaktstelle zu bearbeiten**
1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen zu sehen.
1. Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift).
1. Nehmen Sie alle erforderlichen Änderungen vor und wählen Sie dann **Kontaktstelle speichern**, um Ihre Änderungen zu speichern.
Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie ordnungsgemäß konfiguriert ist.
**Um eine Testbenachrichtigung zu senden**
1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen.
1. Wählen Sie die Kontaktstelle aus, die Sie testen möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift).
1. Wählen Sie das **Testsymbol** (Papierflugzeug).
1. Wählen Sie aus, ob Sie eine vordefinierte Testbenachrichtigung senden möchten, oder wählen Sie **Benutzerdefiniert**, um der Testbenachrichtigung Ihre eigenen benutzerdefinierten Anmerkungen und Beschriftungen hinzuzufügen.
1. Wählen Sie **Testbenachrichtigung senden**, um die Warnung mit den angegebenen Kontaktpunkten zu testen.
Sie können Kontaktpunkte löschen, die nicht von einer Benachrichtigungsrichtlinie verwendet werden.
**Um eine Kontaktstelle zu löschen**
1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen.
1. Wählen Sie die Kontaktstelle aus, die Sie löschen möchten, und wählen Sie dann das **Löschen-Symbol** (Mülleimer).
1. Wählen Sie im Bestätigungsdialogfeld **Ja, löschen** aus.
**Anmerkung**
Wenn der Kontaktpunkt von einer Benachrichtigungsrichtlinie verwendet wird, müssen Sie die Benachrichtigungsrichtlinie löschen oder sie so bearbeiten, dass sie einen anderen Kontaktpunkt verwendet, bevor Sie den Kontaktpunkt löschen.
## Liste der unterstützten Notifier
| Name | Typ |
| --- | --- |
| Amazon SNS | sns |
| OpsGenie | opsgenie |
| Pager Duty | pagerduty |
| Slack | slack |
| VictorOps | victorops |
# 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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
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 Bezeichnung`env=environmentname`. Es gibt eine Warnregel, mit der überwacht wird, ob Ihre Dienste die Datenbank erreichen können. Die Warnungsregel erstellt Warnungen mit dem Namen`alertname=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.**
1. **Wählen Sie Benachrichtigungsrichtlinien aus.**
1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.
1. Wählen Sie im Bereich **Root-Richtlinie** das Symbol **Bearbeiten** (Stift) aus.
1. Aktualisieren **Sie unter Standardkontaktpunkt** die Kontaktstelle, an die Benachrichtigungen für Regeln gesendet werden sollen, wenn die Warnungsregeln keiner bestimmten Richtlinie entsprechen.
1. Wählen Sie unter **Gruppieren nach** die Labels (oder speziellen Gruppen) aus, nach denen Benachrichtigungen gruppiert werden sollen.
1. 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.
1. 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.**
1. **Wählen Sie Benachrichtigungsrichtlinien aus.**
1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.
1. **Wählen Sie im Abschnitt **Spezifisches Routing die Option Neue spezifische** Richtlinie aus.**
1. **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.
1. 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.
1. 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.
1. Wählen Sie optional **Gruppierung überschreiben**, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet.
1. Wählen Sie optional **Allgemeine Zeitangaben außer Kraft setzen, um** die Zeitoptionen in der Gruppenbenachrichtigungsrichtlinie außer Kraft zu setzen.
1. 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.
1. 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).
1. 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.
1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und klicken Sie dann auf das Symbol **Bearbeiten** (Stift).
1. Nehmen Sie alle Änderungen vor (z. B. beim Hinzufügen einer spezifischen Richtlinie auf oberster Ebene).
1. 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.
# Benachrichtigungen anpassen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Passen Sie Ihre Benachrichtigungen mit Vorlagen für Benachrichtigungen an.
Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und das Format der Nachricht in Ihren Benachrichtigungen zu ändern.
Benachrichtigungsvorlagen sind nicht an bestimmte Kontaktpunkt-Integrationen wie E-Mail oder Slack gebunden. Sie können sich jedoch dafür entscheiden, separate Benachrichtigungsvorlagen für verschiedene Kontaktpunkt-Integrationen zu erstellen.
Sie können Benachrichtigungsvorlagen verwenden, um:
+ Informationen in der Benachrichtigung hinzufügen, entfernen oder neu anordnen, einschließlich Zusammenfassung, Beschreibung, Beschriftungen und Anmerkungen, Werten und Links
+ Formatieren Sie Text fett und kursiv und fügen Sie Zeilenumbrüche hinzu oder entfernen Sie sie
Sie können Benachrichtigungsvorlagen nicht verwenden, um:
+ Ändern Sie das Design von Benachrichtigungen in Instant-Messaging-Diensten wie Slack und Microsoft Teams
**Topics**
+ [Verwendung der Template-Sprache von Go](v9-alerting-notifications-go-templating.md)
+ [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md)
+ [Vorlage – Referenz](v9-alerting-template-reference.md)
# Verwendung der Template-Sprache von Go
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
[Sie schreiben Benachrichtigungsvorlagen in der Vorlagensprache von Go, Text/Vorlage.](https://pkg.go.dev/text/template)
Dieser Abschnitt bietet einen Überblick über die Vorlagensprache von Go und das Schreiben von Vorlagen in Text/Vorlage.
## Punkt
Darin text/template befindet sich ein spezieller Cursor namens Punkt, der als geschrieben wird`.`. Sie können sich diesen Cursor als eine Variable vorstellen, deren Wert sich ändert, je nachdem, wo in der Vorlage er verwendet wird. Beispielsweise `.` bezieht sich eine Benachrichtigungsvorlage zu Beginn auf das `ExtendedData` Objekt, das eine Reihe von Feldern enthält`Alerts`, darunter `Status``GroupLabels`,`CommonLabels`, `CommonAnnotations` und`ExternalURL`. Punkt kann sich jedoch auf etwas anderes beziehen, wenn es in einer Liste verwendet wird, wenn `range` es in einer Liste verwendet wird, wenn es innerhalb einer verwendet wird oder wenn Feature-Vorlagen geschrieben werden`with`, die in anderen Vorlagen verwendet werden sollen. Beispiele dafür finden Sie in [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v9-alerting-template-reference.md).
## Tags öffnen und schließen
In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}`
## Print (Ausgabe)
Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können den Wert eines Punkts, ein Punktfeld, das Ergebnis einer Funktion und den Wert einer [Variablen](#v9-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben:
```
{{ .Alerts }}
```
## Iterieren Sie über Warnmeldungen
Um nur die Beschriftungen jeder Warnung und nicht alle Informationen über die Warnung zu drucken, können Sie a verwenden, um die Warnungen in `range` folgenden Schritten zu iterieren: `ExtendedData`
```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```
Innerhalb des Bereichs bezieht sich der Punkt nicht mehr auf`ExtendedData`, sondern auf eine`Alert`. Sie können `{{ .Labels }}` es verwenden, um die Beschriftungen der einzelnen Warnmeldungen zu drucken. Das funktioniert, weil `{{ range .Alerts }}` sich der Punkt so ändert, dass er sich auf die aktuelle Warnung in der Liste der Benachrichtigungen bezieht. Wenn der Bereich abgeschlossen ist, wird der Punkt auf den Wert zurückgesetzt, den er vor dem Beginn des Bereichs hatte. In diesem Beispiel ist das`ExtendedData`:
```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```
## Iterieren Sie über Anmerkungen und Beschriftungen
Lassen Sie uns eine Vorlage schreiben, um die Beschriftungen jeder Warnung in dem Format zu drucken`The name of the label is $name, and the value is $value`, in dem sie den Namen `$name` und den Wert jedes Labels `$value` enthalten.
Verwenden Sie wie im vorherigen Beispiel einen Bereich, um über die Warnungen zu iterieren, sodass der Punkt auf die aktuelle Warnung in der Liste der Warnungen verweist, und verwenden Sie dann einen zweiten Bereich für die sortierten Beschriftungen, sodass der Punkt ein zweites Mal aktualisiert wird, sodass er auf das aktuelle Label verweist. `.Alerts` Verwenden Sie innerhalb des zweiten Bereichs `.Name` und`.Value`, um den Namen und den Wert jedes Labels zu drucken:
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```
## Wenn Aussagen
Sie können if-Anweisungen in Vorlagen verwenden. Um beispielsweise zu drucken, `There are no alerts` wenn keine Warnmeldungen enthalten sind, würden `.Alerts` Sie Folgendes schreiben:
```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```
## Mit
With ähnelt if-Anweisungen, `with` aktualisiert jedoch im Gegensatz zu if-Anweisungen den Punkt so, dass er auf den Wert von with verweist:
```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```
## Variablen
Variablen in text/template müssen innerhalb der Vorlage erstellt werden. Um beispielsweise eine Variable zu erstellen, die `$variable` mit dem aktuellen Wert von Punkt aufgerufen wird, würden Sie Folgendes schreiben:
```
{{ $variable := . }}
```
Sie können `$variable` innerhalb eines Bereichs oder verwenden `with` und es bezieht sich auf den Wert von Punkt zu dem Zeitpunkt, als die Variable definiert wurde, und nicht auf den aktuellen Wert von Punkt.
Sie können beispielsweise keine Vorlage schreiben, die den zweiten `{{ .Labels }}` Bereich verwendet, da sich Punkt hier auf das aktuelle Label bezieht, nicht auf die aktuelle Warnung:
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```
Sie können dies beheben, indem Sie eine Variable definieren, die `$alert` im ersten Bereich und vor dem zweiten Bereich aufgerufen wird:
```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```
## Bereich mit Index
Sie können den Index jeder Warnung innerhalb eines Bereichs abrufen, indem Sie Index- und Wertvariablen am Anfang des Bereichs definieren:
```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```
## Definieren Sie Vorlagen
Sie können Vorlagen definieren, die in anderen Vorlagen verwendet werden können, indem Sie `define` den Namen der Vorlage in doppelten Anführungszeichen verwenden. Sie sollten keine Vorlagen mit demselben Namen wie andere Vorlagen definieren, einschließlich Standardvorlagen wie `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Wenn eine Vorlage mit demselben Namen wie eine Standardvorlage oder eine Vorlage in einer anderen Benachrichtigungsvorlage erstellt wurde, verwendet Grafana möglicherweise eine der beiden Vorlagen. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt.
```
{{ define "print_labels" }}
{{ end }}
```
## Vorlagen einbetten
Sie können eine definierte Vorlage in Ihre Vorlage einbetten`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor, der an die Vorlage übergeben werden soll, verwenden:
```
{{ template "print_labels" . }}
```
## Übergeben Sie Daten an Vorlagen
Innerhalb einer Vorlage bezieht sich der Punkt auf den Wert, der an die Vorlage übergeben wird.
Wenn einer Vorlage beispielsweise eine Liste mit Auslösewarnungen übergeben wird, bezieht sich Punkt auf diese Liste von Auslösewarnungen:
```
{{ template "print_alerts" .Alerts }}
```
Wenn der Vorlage die sortierten Labels für eine Warnung übergeben werden, bezieht sich Punkt auf die Liste der sortierten Labels:
```
{{ template "print_labels" .SortedLabels }}
```
Dies ist nützlich, wenn Sie wiederverwendbare Vorlagen schreiben. Um beispielsweise alle Benachrichtigungen zu drucken, könnten Sie Folgendes schreiben:
```
{{ template "print_alerts" .Alerts }}
```
Um dann nur die Feuermeldungen auszudrucken, könnten Sie Folgendes schreiben:
```
{{ template "print_alerts" .Alerts.Firing }}
```
Das funktioniert, weil es sich bei beiden `.Alerts` um Listen von Warnmeldungen `.Alerts.Firing` handelt.
```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```
## Kommentare
Sie können Kommentare hinzufügen mit `{{/*` und`*/}}`:
```
{{/* This is a comment */}}
```
Um zu verhindern, dass Kommentare Zeilenumbrüche hinzufügen, verwende:
```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```
## Einrückung
Sie können Einzüge, sowohl Tabulatoren als auch Leerzeichen, und Zeilenumbrüche verwenden, um die Lesbarkeit von Vorlagen zu verbessern:
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
Einrückungen in der Vorlage werden jedoch auch im Text vorhanden sein. Als nächstes werden wir sehen, wie man es entfernt.
## Entferne Leerzeichen und Zeilenumbrüche
Wird text/template verwendet `{{-` und dient `-}}` zum Entfernen von führenden und nachfolgenden Leerzeichen und Zeilenumbrüchen.
Wenn Sie beispielsweise Einrückungen und Zeilenumbrüche verwenden, um eine Vorlage lesbarer zu machen:
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
Der Einzug und die Zeilenumbrüche werden auch im Text vorhanden sein:
```
alertname = "Test"
grafana_folder = "Test alerts"
```
Sie können den Einzug und die Zeilenumbrüche aus dem Text entfernen, indem Sie `}}` zu `-}}` Beginn jedes Bereichs wechseln:
```
{{ range .Alerts -}}
{{ range .Labels.SortedPairs -}}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
Der Einzug und die Zeilenumbrüche in der Vorlage fehlen jetzt im Text:
```
alertname = "Test"
grafana_folder = "Test alerts"
```
# Vorlagen für Benachrichtigungen erstellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Erstellen Sie wiederverwendbare Benachrichtigungsvorlagen, die Sie an Ihre Kontaktstellen senden können.
Sie können Ihrer Benachrichtigungsvorlage eine oder mehrere Vorlagen hinzufügen.
Der Name Ihrer Benachrichtigungsvorlage muss eindeutig sein. Sie können nicht zwei Vorlagen mit demselben Namen in derselben Benachrichtigungsvorlage oder in verschiedenen Benachrichtigungsvorlagen haben. Vermeiden Sie es, Vorlagen mit demselben Namen wie Standardvorlagen zu definieren, z. B.: `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`.
Auf der Registerkarte Kontaktstellen finden Sie eine Liste Ihrer Benachrichtigungsvorlagen.
## Vorlagen für Benachrichtigungen erstellen
**Um eine Benachrichtigungsvorlage zu erstellen**
1. Klicken Sie auf **Vorlage hinzufügen**.
1. Wählen Sie einen Namen für die Benachrichtigungsvorlage, z. `email.subject` B.
1. Schreiben Sie den Inhalt der Vorlage in das Inhaltsfeld.
Beispiel:
```
{{ if .Alerts.Firing -}}
{{ len .Alerts.Firing }} firing alerts
{{ end }}
{{ if .Alerts.Resolved -}}
{{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. Klicken Sie auf Speichern.
`{{ define "email.subject" }}`(wo `email.subject` ist der Name Ihrer Vorlage) und `{{ end }}` wird automatisch am Anfang und Ende des Inhalts hinzugefügt.
**Um eine Benachrichtigungsvorlage zu erstellen, die mehr als eine Vorlage enthält:**
1. Klicken Sie auf **Vorlage hinzufügen**.
1. Geben Sie einen Namen für die gesamte Benachrichtigungsvorlage ein. Beispiel, `email`.
1. Schreiben Sie jede Vorlage in das Feld Inhalt, einschließlich `{{ define "name-of-template" }}` und `{{ end }}` am Anfang und Ende jeder Vorlage. Sie können für jede Vorlage in der Benachrichtigungsvorlage aussagekräftige Namen verwenden, z. B. `email.subject` oder`email.message`. Verwenden Sie in diesem Fall nicht den Namen der Benachrichtigungsvorlage, den Sie oben eingegeben haben.
In den folgenden Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie erstellen könnten.
1. Klicken Sie auf Speichern.
## Eine Vorlage für den Betreff einer E-Mail erstellen
Erstellen Sie eine Vorlage für den Betreff einer E-Mail, die die Anzahl der ausgelösten und gelösten Benachrichtigungen enthält, wie in diesem Beispiel:
```
1 firing alerts, 0 resolved alerts
```
**Um eine Vorlage für den Betreff einer E-Mail zu erstellen**
1. Erstellen Sie eine Vorlage namens `email.subject` mit dem folgenden Inhalt:
```
{{ define "email.subject" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Betreff** mit dem `template` Schlüsselwort einfügen.
```
{{ template "email.subject" . }}
```
## Erstellen Sie eine Vorlage für die Nachricht einer E-Mail
Erstellen Sie eine Vorlage für die Nachricht einer E-Mail, die eine Zusammenfassung aller ausgelösten und gelösten Alarme enthält, wie in diesem Beispiel:
```
There are 2 firing alerts, and 1 resolved alerts
Firing alerts:
- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2
Resolved alerts:
- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```
**Um eine Vorlage für die Nachricht einer E-Mail zu erstellen**
1. Erstellen Sie eine Benachrichtigungsvorlage `email` mit zwei Vorlagen im Inhalt: `email.message_alert` und`email.message`.
Die `email.message_alert` Vorlage wird verwendet, um die Bezeichnungen und Werte für jede ausgelöste und behobene Warnung zu drucken, wobei die `email.message` Vorlage die Struktur der E-Mail enthält.
```
{{- define "email.message_alert" -}}
{{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
{{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
{{- end -}}
{{ define "email.message" }}
There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
{{ if .Alerts.Firing -}}
Firing alerts:
{{- range .Alerts.Firing }}
- {{ template "email.message_alert" . }}
{{- end }}
{{- end }}
{{ if .Alerts.Resolved -}}
Resolved alerts:
{{- range .Alerts.Resolved }}
- {{ template "email.message_alert" . }}
{{- end }}
{{- end }}
{{ end }}
```
1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Textfeld** mit dem `template` Schlüsselwort einfügen.
```
{{ template "email.message" . }}
```
## Eine Vorlage für den Titel einer Slack-Nachricht erstellen
Erstelle eine Vorlage für den Titel einer Slack-Nachricht, die die Anzahl der ausgelösten und gelösten Alerts enthält, wie im folgenden Beispiel:
```
1 firing alerts, 0 resolved alerts
```
**Um eine Vorlage für den Titel einer Slack-Nachricht zu erstellen**
1. Erstelle eine Vorlage namens `slack.title` mit dem folgenden Inhalt:
```
{{ define "slack.title" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Titelfeld** mit dem `template` Schlüsselwort einfügen.
```
{{ template "slack.title" . }}
```
## Eine Vorlage für den Inhalt einer Slack-Nachricht erstellen
Erstelle eine Vorlage für den Inhalt einer Slack-Nachricht, die eine Beschreibung aller ausgelösten und gelösten Alerts enthält, einschließlich ihrer Labels, Anmerkungen und Dashboard-URL:
```
1 firing alerts:
[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
1 resolved alerts:
[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```
**Um eine Vorlage für den Inhalt einer Slack-Nachricht zu erstellen**
1. Erstelle ein Template namens `slack` mit zwei Templates im Inhalt: `slack.print_alert` und`slack.message`.
Die `slack.print_alert` Vorlage wird zum Drucken der Beschriftungen, Anmerkungen und der Dashboard-URL verwendet, während die `slack.message` Vorlage die Struktur der Benachrichtigung enthält.
```
{{ define "slack.print_alert" -}}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs -}}
- {{ .Name }}: {{ .Value }}
{{ end -}}
{{ if .Annotations -}}
Annotations:
{{ range .Annotations.SortedPairs -}}
- {{ .Name }}: {{ .Value }}
{{ end -}}
{{ end -}}
{{ if .DashboardURL -}}
Go to dashboard: {{ .DashboardURL }}
{{- end }}
{{- end }}
{{ define "slack.message" -}}
{{ if .Alerts.Firing -}}
{{ len .Alerts.Firing }} firing alerts:
{{ range .Alerts.Firing }}
{{ template "slack.print_alert" . }}
{{ end -}}
{{ end }}
{{ if .Alerts.Resolved -}}
{{ len .Alerts.Resolved }} resolved alerts:
{{ range .Alerts.Resolved }}
{{ template "slack.print_alert" .}}
{{ end -}}
{{ end }}
{{- end }}
```
1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Textkörper mit dem Schlüsselwort einfügen**. `template`
```
{{ template "slack.message" . }}
```
## Template sowohl für E-Mail als auch für Slack mit gemeinsam genutzten Vorlagen
Anstatt separate Benachrichtigungsvorlagen für jeden Kontaktpunkt wie E-Mail und Slack zu erstellen, kannst du dieselbe Vorlage gemeinsam nutzen.
Wenn du beispielsweise eine E-Mail mit diesem Betreff und eine Slack-Nachricht mit diesem Titel senden möchtest`1 firing alerts, 0 resolved alerts`, kannst du eine gemeinsame Vorlage erstellen.
**Um eine gemeinsame Vorlage zu erstellen**
1. Erstellen Sie eine Vorlage namens `common.subject_title` mit dem folgenden Inhalt:
```
{{ define "common.subject_title" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. Führen Sie für E-Mails die Vorlage im Betreff-Feld Ihrer E-Mail-Kontaktpunkt-Integration aus:
```
{{ template "common.subject_title" . }}
```
1. Für Slack führe die Vorlage im Titelfeld deiner Slack-Kontaktpunkt-Integration aus:
```
{{ template "common.subject_title" . }}
```
## Verwenden von Benachrichtigungsvorlagen
Verwenden Sie Vorlagen in Kontaktpunkten, um Ihre Benachrichtigungen zu personalisieren.
**Um eine Vorlage beim Erstellen einer Kontaktstelle zu verwenden**
1. Wählen Sie im Menü **„Benachrichtigungen**“ die Option **Kontaktstellen** aus, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.
1. Wählen Sie **Kontaktstelle hinzufügen**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie neben der Kontaktstelle, die Sie **bearbeiten** möchten, auf das Symbol Bearbeiten (Stift) klicken.
1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein oder mehrere Felder ein, z. B. **Nachricht** oder **Betreff**. Um eine Vorlage einzugeben, verwenden Sie das Formular `{{ template "template_name" . }}` und *template\$1name* ersetzen Sie es durch den Namen der Vorlage, die Sie verwenden möchten.
1. Klicken Sie auf **Kontaktstelle speichern**.
# Vorlage – Referenz
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen.
## Vorlagendaten
Die folgenden Daten werden an Nachrichtenvorlagen übergeben.
| Name | Typ | Hinweise |
| --- | --- | --- |
| `Receiver` | Zeichenfolge | Name der Kontaktstelle, an die die Benachrichtigung gesendet wird. |
| `Status` | Zeichenfolge | wird ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben. |
| `Alerts` | Warnung | Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten). |
| `GroupLabels` | KeyValue | Labels, nach denen diese Alerts gruppiert wurden. |
| `CommonLabels` | KeyValue | Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. |
| `CommonAnnotations` | KeyValue | Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. |
| `ExternalURL` | Zeichenfolge | Backlink zu der Grafana, die die Benachrichtigung gesendet hat. Wenn Sie einen externen Alertmanager verwenden, verlinken Sie zurück zu diesem Alertmanager. |
Der `Alerts` Typ stellt zwei Funktionen zum Filtern der zurückgegebenen Warnungen zur Verfügung.
+ `Alerts.Firing`— Gibt eine Liste von Auslösewarnungen zurück.
+ `Alerts.Resolved`— Gibt eine Liste der behobenen Alarme zurück.
**Warnung (Typ)**
Der Warnungstyp enthält die folgenden Daten.
| Name | Typ | Hinweise |
| --- | --- | --- |
| Status | Zeichenfolge | `firing` oder `resolved`. |
| Labels | KeyValue | Eine Reihe von Bezeichnungen, die der Warnung beigefügt sind. |
| Anmerkungen | KeyValue | Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. |
| Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen |
| StartsAt | Zeit.Zeit | Uhrzeit, zu der der Alarm ausgelöst wurde. |
| EndsAt | Zeit. Zeit | Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt. |
| Generator-URL | Zeichenfolge | Ein Backlink zu Grafana oder einem externen Alertmanager. |
| Silence-URL | Zeichenfolge | Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen. |
| Dashboard-URL | Zeichenfolge | Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. |
| Panel-URL | Zeichenfolge | Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. |
| Fingerabdruck | Zeichenfolge | Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. |
| ValueString | Zeichenfolge | Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. |
**ExtendedData**
Das ExtendedData Objekt enthält die folgenden Eigenschaften.
| Name | Art | Description | Beispiel |
| --- | --- | --- | --- |
| Empfänger | `string` | Der Name der Kontaktstelle, die die Benachrichtigung sendet. | `{{ .Receiver }}` |
| Status | `string` | Der Status ist `firing if at least one alert is firing, otherwise resolved.` | `{{ .Status }}` |
| Benachrichtigungen | `[]Alert` | Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung. | `There are {{ len .Alerts }} alerts` |
| Feuerwarnungen | `[]Alert` | Liste aller Feuerwarnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Firing }} firing alerts` |
| Behobene Warnungen | `[]Alert` | Liste aller gelösten Warnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Resolved }} resolved alerts` |
| GroupLabels | `KeyValue` | Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren. | `{{ .GroupLabels }}` |
| CommonLabels | `KeyValue` | Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonLabels }}` |
| CommonAnnotations | `KeyValue` | Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonAnnotations }}` |
| Externe URL | `string` | Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat. | `{{ .ExternalURL }}` |
**KeyValue Typ**
Der `KeyValue` Typ besteht aus einer Reihe von key/value Zeichenkettenpaaren, die Beschriftungen und Anmerkungen darstellen.
Neben dem direkten Zugriff auf die als `KeyValue` gespeicherten Daten gibt es auch Methoden zum Sortieren, Entfernen und Transformieren der Daten.
| Name | Argumente | Rückgabewert | Hinweise | Beispiel |
| --- | --- | --- | --- | --- |
| SortedPairs | | Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert | | `{{ .Annotations.SortedPairs }}` |
| Remove | [] Zeichenfolge | KeyValue | Gibt eine Kopie der Key/Value Map ohne die angegebenen Schlüssel zurück. | `{{ .Annotations.Remove "summary" }}` |
| Namen | | [] Zeichenfolge | Liste der Labelnamen | `{{ .Names }}` |
| Werte | | [] Zeichenfolge | Liste der Labelwerte | `{{ .Values }}` |
**Time (Zeit)**
Die Zeit stammt aus dem [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)Go-Paket. Sie können eine Uhrzeit in verschiedenen Formaten drucken. Um beispielsweise die Uhrzeit zu drucken, zu der eine Warnung ausgelöst wurde`Monday, 1st January 2022 at 10:00AM`, in diesem Format schreiben Sie die folgende Vorlage:
```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```
Eine Referenz für das Zeitformat von Go finden Sie [hier](https://pkg.go.dev/time#pkg-constants).
## Funktionen der Vorlage
Mithilfe von Vorlagenfunktionen können Sie Beschriftungen und Anmerkungen verarbeiten, um dynamische Benachrichtigungen zu generieren. Die folgenden Funktionen sind verfügbar.
| Name | Argumenttyp | Rückgabetyp | Description |
| --- | --- | --- | --- |
| `humanize` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format. |
| `humanize1024` | Zahl oder Zeichenfolge | Zeichenfolge | Wie Humanize, verwendet aber 1024 statt 1000 als Basis. |
| `humanizeDuration` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Dauer in Sekunden in ein besser lesbares Format. |
| `humanizePercentage` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Verhältniswert in einen Bruchteil von 100. |
| `humanizeTimestamp` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format. |
| `title` | Zeichenfolge | Zeichenfolge | Strings.Title schreibt das erste Zeichen jedes Worts groß. |
| `toUpper` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um. |
| `toLower` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um. |
| `match` | Muster, Text | Boolesch | Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung. |
| `reReplaceAll` | Muster, Ersatz, Text | Zeichenfolge | Regexp. ReplaceAllString Regexp-Substitution, nicht verankert. |
| `graphLink` | string — JSON-Objekt mit Feldern und `expr` `datasource` | Zeichenfolge | Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. |
| `tableLink` | string — JSON-Objekt mit `expr` und `datasource` -Feldern | Zeichenfolge | Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. |
| `args` | [] Schnittstelle \$1\$1 | map [string] Schnittstelle \$1\$1 | Konvertiert eine Liste von Objekten in eine Map mit Schlüsseln, zum Beispiel arg0, arg1. Verwenden Sie diese Funktion, um mehrere Argumente an Vorlagen zu übergeben. |
| `externalURL` | nichts | Zeichenfolge | Gibt eine Zeichenfolge zurück, die die externe URL darstellt. |
| `pathPrefix` | nichts | Zeichenfolge | Gibt den Pfad der externen URL zurück. |
Die folgende Tabelle zeigt Beispiele für die Verwendung der einzelnen Funktionen.
| Funktion | TemplateString | Input | Expected |
| --- | --- | --- | --- |
| humanisieren | \$1\$1value humanisieren\$1 | 1234567,0 | 1,235 M |
| humanisieren Sie 1024 | \$1humanise1024 \$1value\$1 | 1048576,0 | 1 Minuten |
| Dauer humanisieren | \$1humanizeDuration \$1value\$1 | 899,99 | 14 m 59 s |
| Prozentsatz humanisieren | \$1HumanizePercentage \$1value\$1 | 0,1234567 | 12,35% |
| Zeitstempel humanisieren | \$1HumanizeTimestamp \$1value\$1 | 1435065584,128 | 2015-06-23 13:19:44.128 \$10000 UTC |
| Titel | \$1\$1wert \$1 Titel\$1 | ein B C | Ein Bb Cc |
| toUpper | \$1\$1value \$1 toUpper\$1 | ein B C | EIN B C |
| toLower | \$1\$1value \$1 toLower\$1 | ein B C | ein b c |
| match | \$1entspricht „a\$1“ \$1labels.instance\$1 | aa | true |
| reReplaceAll | \$1\$1 reReplaceAll „localhost :( .\$1)“ „meine.domain: \$11“ \$1labels.instance\$1\$1 | localhost: 3000 | meine.domain: 3000 |
| GraphLink | \$1\$1GraphLink „\$1\$1" expr\$1“:\$1 "hoch\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :false, "range“ :true\$1] |
| Link zur Tabelle | \$1\$1TableLink „\$1\$1" expr\$1“:\$1 "nach oben\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :true, "range“ :false\$1] |
| args | \$1\$1definiere „x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1Vorlage „x“ (Argumente 1 „2")\$1\$1 | | 1 2 |
| Externe URL | \$1externe URL\$1 | | http://localhost/path/prefix |
| Pfad-Präfix | \$1Pfadpräfix\$1 | | /Pfad/Präfix |
# Stummschalten von Warnmeldungen für Prometheus-Datenquellen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
*Für externe Alert Manager-Datenquellen (einschließlich Amazon Managed Service for Prometheus) können Sie Warnmeldungen mit einer Stille unterdrücken.* Eine Stille verhindert nur, dass Benachrichtigungen erstellt werden: Stummschaltungen verhindern nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Wenn Sie eine Warnung stummschalten, geben Sie ein Zeitfenster an, in dem sie unterdrückt werden soll.
Sie können Stummschaltungen für eine externe AlertManager-Datenquelle konfigurieren.
**Anmerkung**
Um Warnmeldungen in regelmäßigen Zeitintervallen oder für andere Datenquellen (z. B. während regulärer Wartungsperioden) zu unterdrücken, verwenden Sie [Timings stummschalten](v9-alerting-notification-muting.md) anstelle von Stummschaltungen.
**Um eine Stille hinzuzufügen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.**
1. Wählen Sie **Stille**, um eine Seite mit einer vorhandenen Liste zu öffnen. [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md)
1. **Wählen Sie den externen Alertmanager aus der Dropdown-Liste Alertmanager aus.**
1. **Wählen** Sie Stille hinzufügen aus.
1. Wählen Sie das Start- und Enddatum **unter Start und Ende der Stille** aus, um anzugeben, wann die Stille in Kraft treten und wann sie enden soll.
Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt wird. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert.
1. Geben Sie in den Feldern **Name** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Der Labelabgleich wird im Anschluss an dieses Verfahren ausführlicher erörtert.
1. Fügen Sie optional einen **Kommentar** hinzu oder ändern Sie den **Ersteller** so, dass er den Besitzer der Stille festlegt.
1. Wählen Sie „**Erstellen**“, um die Stille zu erzeugen.
Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen.
**Labelabgleich für die Unterdrückung von Alarmen**
Wenn Sie eine Stille erstellen, erstellen Sie im Rahmen der Stille eine Reihe von *passenden Bezeichnungen*. Dabei handelt es sich um eine Reihe von Regeln für Bezeichnungen, die übereinstimmen müssen, damit die Warnung unterdrückt wird. Die passenden Beschriftungen bestehen aus drei Teilen:
+ **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 Labels aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt.
+ `!=`Wählen Sie Labels 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.
Eine Stille endet am angegebenen Enddatum, Sie können die Unterdrückung jedoch jederzeit manuell beenden.
**Um eine Stille manuell zu beenden**
1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option „**Stille**“, um die Liste der vorhandenen Pausen anzuzeigen.
1. **Wählen Sie die Stille aus, die Sie beenden möchten, und wählen Sie Stille aufheben.** Dadurch wird die Unterdrückung von Alarmen beendet.
**Anmerkung**
Durch das Aufheben der Stummschaltung wird die Unterdrückung von Alarmen beendet, als ob die Endzeit für die aktuelle Uhrzeit festgelegt wäre. Stille, die (automatisch oder manuell) beendet wurde, werden fünf Tage lang beibehalten und in der Liste aufgeführt. Sie können eine Stille nicht manuell aus der Liste entfernen.
**Einen Link zum Formular zur Erstellung von Stille erstellen**
Sie können eine URL zum Formular zur Erstellung von Stille erstellen, wobei die Details bereits ausgefüllt sind. Bediener können dies verwenden, um einen Alarm während eines Betriebsereignisses schnell zu unterdrücken.
Wenn Sie einen Link zu einem Silence-Formular erstellen, verwenden Sie einen `matchers` Abfrageparameter, um die entsprechenden Bezeichnungen anzugeben, und einen `comment` Abfrageparameter, um einen Kommentar anzugeben. Der `matchers` Parameter erfordert einen oder mehrere Werte im Formular`[label][operator][value]`, getrennt durch Kommas.
**Beispiel-URL**
Verwenden Sie eine URL wie die folgende, um einen Link zu einem `cluster!~europe-.*` Silence-Formular mit passenden Bezeichnungen `severity=critical` und einem Kommentar`Silencing critical EU alerts`, der besagt, zu verlinken. *mygrafana*Ersetzen Sie durch den Hostnamen Ihrer Grafana-Instanz.
```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```
Um eine Verknüpfung zu einer neuen Silence-Seite für einen externen Alertmanager herzustellen, fügen Sie einen `alertmanager` Abfrageparameter mit dem Alertmanage-Datenquellennamen hinzu, z. B. `alertmanager=myAlertmanagerdatasource`
# Timings stummschalten
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
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 | Stumm |
| --- | --- |
| 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 stummgeschaltet werden soll oder nicht. |
| Funktioniert mit Grafana-Alerting und externen Alertmanagern. | Funktioniert nur mit externen Alertmanagern. |
**Um ein Timing zur Stummschaltung zu erstellen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.**
1. **Wählen Sie Benachrichtigungsrichtlinien.**
1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.
1. **Wählen Sie im Bereich **Timings für die Stummschaltung die Schaltfläche Timing** für Stummschaltung hinzufügen aus.**
1. Wählen Sie das Zeitintervall aus, für das die Stummschaltung gelten soll.
1. Wählen Sie „**Senden**“, um die Dauer der Stummschaltung zu erstellen.
**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**.
1. Wählen Sie in der Dropdownliste **für** die Dauer der 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 Beispiel`monday: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, am Samstag jedoch nicht von 8 bis 9 Uhr.
+ **Zeitraum — Die Tageszeit, zu** der Benachrichtigungen unterdrückt werden sollen. Besteht aus zwei Unterfeldern: **Startzeit** und **Endzeit.** Ein Beispiel für die Zeit ist`14:30`. Die Uhrzeit wird in 24-Stunden-Notation in UTC angegeben.
+ **Wochentage** — Die Wochentage. Dabei kann es sich um einen einzelnen Tag handeln`monday`, z. B. um einen Bereich`monday: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` - liegen`31`. 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.
+ **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2025`.
Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Wenn Sie also Jahre auf festlegen`2023:2025, 2027`, gilt dies für die Jahre 2023, 2024, 2025 und 2027 (aber nicht 2026).
Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Ein Zeitpunkt muss allen Feldern entsprechen, um einem vollständigen Zeitintervall zu entsprechen.
Wenn Sie eine genaue Dauer angeben möchten, geben Sie alle für diese Dauer erforderlichen Optionen an. Wenn Sie beispielsweise ein Zeitintervall für den ersten Montag des Monats, für März, Juni, September und Dezember, zwischen 12:00 und 24:00 Uhr UTC erstellen möchten, könnte Ihre Zeitintervallspezifikation wie folgt lauten:
+ Zeitbereich:
+ Startzeit: `12:00`
+ Endzeit: `24:00`
+ Wochentage: `monday`
+ Monate: `3, 6, 9, 12`
+ Tage des Monats: `1:7`
# Warnungsgruppen anzeigen und nach Warnungsgruppen filtern
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig werden Warnungsregeln in Benachrichtigungsrichtlinien nach den Labelschlüsseln für die Stammrichtlinie gruppiert. Durch die Gruppierung allgemeiner Warnungsregeln in einer einzigen Warnungsgruppe wird verhindert, dass doppelte Warnungsregeln ausgelöst werden.
Sie können Warnungsgruppen anzeigen und auch nach Warnungsregeln filtern, die bestimmten Kriterien entsprechen.
**Um Warnungsgruppen anzuzeigen**
1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen.
1. Klicken Sie auf **Warnungsgruppen, um die Seite mit den vorhandenen Gruppen** zu öffnen.
1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus.
1. Wählen Sie im Drop-down-Menü „**Benutzerdefiniert gruppieren nach“ eine Kombination von** Bezeichnungen aus, um eine andere Gruppierung als die Standardgruppierung anzuzeigen. Dies ist nützlich, um Ihre Gruppierung von Benachrichtigungsrichtlinien zu debuggen und zu überprüfen.
Wenn eine Warnung keine Bezeichnungen enthält, die entweder in der Gruppierung der Stammrichtlinie oder in der benutzerdefinierten Gruppierung angegeben wurden, wird die Warnung einer Catch-All-Gruppe mit dem Header von hinzugefügt. `No grouping`
**Um nach Label zu filtern**
+ Geben Sie **unter Suchen** ein vorhandenes Label ein, um Benachrichtigungen anzuzeigen, die dem Label entsprechen.
Beispiel, `environment=production,region=~US|EU,severity!=warning`.
**Um nach Bundesland zu filtern**
+ Wählen Sie unter **Staaten den** Status Aktiv, Unterdrückt oder Nicht verarbeitet aus, um Benachrichtigungen anzuzeigen, die Ihrem ausgewählten Status entsprechen. Alle anderen Benachrichtigungen sind ausgeblendet.
# Benachrichtigungsfehler anzeigen
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sehen Sie sich Benachrichtigungsfehler an und erfahren Sie, warum sie nicht gesendet oder empfangen wurden.
**Anmerkung**
Diese Funktion wird nur für Grafana Alertmanager unterstützt.
**Um Benachrichtigungsfehler anzuzeigen**
1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen.
1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.
Wenn eine Kontaktstelle ausfällt, wird der Benutzer in einer Meldung in der rechten Ecke des Bildschirms darauf hingewiesen, dass und wie viele Fehler vorliegen.
1. Klicken Sie auf eine Kontaktstelle, um die Einzelheiten der Fehler für diese Kontaktstelle anzuzeigen.
Fehlerdetails werden angezeigt, wenn Sie den Mauszeiger über das Fehlersymbol bewegen.
Wenn eine Kontaktstelle über mehr als eine Integration verfügt, werden alle Fehler für jede der aufgelisteten Integrationen angezeigt.
1. Überprüfen Sie in der Spalte Health den Status der Benachrichtigung.
Dies kann entweder „OK“, „Keine Versuche“ oder „Fehler“ lauten.