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 10
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 v10 bietet Amazon Managed Grafana Zugriff auf ein aktualisiertes Warnsystem, *Grafana Alerting, das Warninformationen in einer einzigen*, durchsuchbaren Ansicht zentralisiert. Grafana-Alerting wurde als optionale Funktion in Grafana v8 eingeführt und GrafanaLabs hat die Entfernung der älteren Warnmeldungen in Version 11 angekündigt.
**Anmerkung**
Diese Dokumentation behandelt die Grafana-Warnung. Informationen zu älteren Warnmeldungen finden Sie unter. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md)
Mit Grafana Alerting können Sie sofort nach ihrem Auftreten über Probleme in Ihren Systemen informiert werden.
Überwachen Sie Ihre eingehenden Metrikdaten oder Protokolleinträge und richten Sie Ihr Warnsystem so ein, dass es auf bestimmte Ereignisse oder Umstände achtet und dann Benachrichtigungen sendet, wenn diese Probleme gefunden werden.
Auf diese Weise machen Sie eine manuelle Überwachung überflüssig und bieten eine erste Verteidigungslinie gegen Systemausfälle oder Änderungen, die zu größeren Vorfällen führen könnten.
Mit Grafana Alerting erstellen Sie Abfragen und Ausdrücke aus mehreren Datenquellen — unabhängig davon, wo Ihre Daten gespeichert sind. So haben Sie die Flexibilität, Ihre Daten zu kombinieren und auf neue und einzigartige Weise auf Ihre Metriken und Protokolle zu warnen. Anschließend können Sie Ihre Benachrichtigungen in einer einzigen, konsolidierten Ansicht erstellen, verwalten und Maßnahmen ergreifen und so die Fähigkeit Ihres Teams verbessern, Probleme schnell zu identifizieren und zu lösen.
Mit den Warnregeln von Mimir und Loki können Sie Warnausdrücke näher an Ihren Daten und in großem Umfang ausführen, die alle über die Grafana-Benutzeroberfläche verwaltet werden, mit der Sie bereits vertraut sind.
**Anmerkung**
Wenn Sie von einer früheren Version von Grafana migrieren, in der Sie die alte Grafana-Warnung verwendet haben, ist es möglicherweise hilfreich, die [Unterschiede zwischen der alten und der neuen Grafana-Warnung](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) zu sehen.
## Die wichtigsten Funktionen und Vorteile
**Eine Seite für alle Benachrichtigungen**
Auf einer einzigen Grafana-Warnseite werden sowohl von Grafana verwaltete Benachrichtigungen als auch Benachrichtigungen, die sich in Ihrer Promethus-kompatiblen Datenquelle befinden, an einem einzigen Ort zusammengefasst.
**Mehrdimensionale Warnmeldungen**
Mit Warnungsregeln können mehrere einzelne Warnungsinstanzen pro Warnungsregel erstellt werden, die als multidimensionale Warnungen bezeichnet werden. Dadurch erhalten Sie die Möglichkeit und Flexibilität, mit nur einer einzigen Warnungsregel einen Überblick über Ihr gesamtes System zu erhalten. Dazu fügen Sie Ihrer Abfrage Labels hinzu, um anzugeben, welche Komponente überwacht wird, und mehrere Warnungsinstanzen für eine einzelne Warnungsregel zu generieren. Wenn Sie beispielsweise jeden Server in einem Cluster überwachen möchten, wird eine mehrdimensionale Warnung für jede CPU ausgegeben, wohingegen eine Standardwarnung für den gesamten Server eine Warnung ausgibt.
**Benachrichtigungen weiterleiten**
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 verhindert, dass Benachrichtigungen erstellt werden, und halten nur für ein bestimmtes Zeitfenster an. Stille ermöglicht es Ihnen, den Empfang permanenter Benachrichtigungen aufgrund einer oder mehrerer Warnungsregeln 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**
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.
## Entwerfen Sie Ihr Warnsystem
Es ist eine schwierige Aufgabe, komplexe IT-Systeme zu überwachen und zu verstehen, ob alles ordnungsgemäß läuft. Die Einrichtung eines effektiven Warnmanagementsystems ist daher unerlässlich, um Sie zu informieren, wenn etwas schief läuft, bevor sich dies auf Ihre Geschäftsergebnisse auswirkt.
Das Entwerfen und Konfigurieren eines funktionierenden Alert-Management-Setups erfordert Zeit.
Im Folgenden finden Sie einige Tipps, wie Sie ein effektives Alert-Management-Setup für Ihr Unternehmen einrichten können:
**Welche sind die wichtigsten Kennzahlen für Ihr Unternehmen, die Sie überwachen und auf die Sie aufmerksam machen möchten?**
+ Finden Sie Ereignisse, über die Sie Bescheid wissen sollten und die nicht so trivial oder häufig sind, dass die Empfänger sie ignorieren.
+ Benachrichtigungen sollten nur für große Ereignisse erstellt werden, die sofortige Aufmerksamkeit oder Intervention erfordern.
+ Denken Sie an Qualität vor Quantität.
**Welche Art von Warnung möchten Sie verwenden?**
+ Wählen Sie zwischen Grafana-Managed Alerting oder Grafana Mimir oder Loki-Managed Alerting oder beidem.
**Wie möchten Sie Ihre Benachrichtigungen und Benachrichtigungen organisieren?**
+ Seien Sie wählerisch, wen Sie für den Empfang von Benachrichtigungen einrichten. Erwägen Sie, sie an jemanden zu senden, der gerade auf Abruf ist, oder an einen bestimmten Slack-Kanal.
+ Automatisieren Sie so weit wie möglich mit der Alerting API oder Alerts as Code (Terraform).
**Wie können Sie die Alarmermüdung reduzieren?**
+ Vermeiden Sie laute, unnötige Warnmeldungen, indem Sie Stummschaltungen verwenden, die Zeit stummschalten oder die Auswertung von Alarmregeln pausieren.
+ Passen Sie Ihre Warnregeln kontinuierlich an, um deren Wirksamkeit zu überprüfen. Entfernen Sie Warnregeln, um doppelte oder ineffektive Benachrichtigungen zu vermeiden.
+ Denken Sie sorgfältig über Priorität und Schweregrad nach.
+ Überprüfen Sie kontinuierlich Ihre Schwellenwerte und Bewertungsregeln.
## Einschränkungen bei Grafana-Benachrichtigungen
+ Beim Aggregieren von Regeln aus anderen Systemen kann das Grafana-Warnsystem Regeln aus allen verfügbaren Amazon Managed Service for Prometheus-, Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Regeln aus anderen unterstützten Datenquellen abzurufen.
**Topics**
+ [Die wichtigsten Funktionen und Vorteile](#v10-alerting-key-features)
+ [Entwerfen Sie Ihr Warnsystem](#v10-alerting-design)
+ [Einschränkungen bei Grafana-Benachrichtigungen](#v10-alerting-limitations)
+ [-Übersicht](v10-alerting-overview.md)
+ [Alerting einrichten](v10-alerting-setup.md)
+ [Warnmeldungen konfigurieren](v10-alerting-configure.md)
+ [Verwalte deine Benachrichtigungen](v10-alerting-manage.md)
# -Übersicht
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Egal, ob Sie gerade erst anfangen oder ein erfahrener Benutzer von Grafana Alerting sind, erfahren Sie mehr über die Grundlagen und verfügbaren Funktionen, mit denen Sie Benachrichtigungen erstellen, verwalten und darauf reagieren können; und verbessern Sie die Fähigkeit Ihres Teams, Probleme schnell zu lösen.
## Prinzipien
In Prometheus basierten Warnsystemen verfügen Sie über einen Alert-Generator, der Alerts generiert, und einen Alert-Empfänger, der Alerts empfängt. Zum Beispiel ist Prometheus ein Alarmgenerator und für die Auswertung von Warnungsregeln verantwortlich, während Alertmanager ein Alarmempfänger ist und für das Gruppieren, Sperren, Stummschalten und Senden von Benachrichtigungen über ausgelöste und gelöste Alarme verantwortlich ist.
Grafana Alerting basiert auf dem Prometheus-Modell zur Entwicklung von Warnsystemen. Es verfügt über einen internen Alarmgenerator, der für die Planung und Auswertung von Alarmregeln zuständig ist, sowie über einen internen Alarmempfänger, der für das Gruppieren, Sperren, Stummschalten und Senden von Benachrichtigungen zuständig ist. Grafana verwendet Prometheus nicht als Alert-Generator, da Grafana Alerting neben Prometheus auch mit vielen anderen Datenquellen arbeiten muss. Es verwendet jedoch Alertmanager als Alert-Empfänger.
Alarme werden an den Alarmempfänger gesendet, wo sie weitergeleitet, gruppiert, gesperrt, stummgeschaltet und benachrichtigt werden. In Grafana Alerting ist der Standard-Alert-Empfänger der in Grafana eingebettete Alertmanager, der als Grafana Alertmanager bezeichnet wird. [Sie können jedoch auch andere Alertmanager verwenden, und diese werden als externe Alertmanager bezeichnet.](v10-alerting-setup-alertmanager.md)
## Grundlagen
Im Folgenden finden Sie einen Überblick über die verschiedenen Teile der Grafana-Warnung.
### Warnungsregeln
Eine Warnregel besteht aus einer Reihe von Kriterien, die bestimmen, wann eine Warnung ausgelöst werden soll. Sie besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, die erfüllt sein muss, einem Intervall, das bestimmt, wie oft die Warnungsregel ausgewertet wird, und einer Dauer, über die die Bedingung erfüllt sein muss, damit eine Warnung ausgelöst wird.
Warnungsregeln werden über ihr Intervall hinweg ausgewertet, und für jede Warnungsregel können null, eine oder eine beliebige Anzahl von Alarmen gleichzeitig ausgelöst werden. Der Status einer Warnungsregel wird durch die höchste `severe` Alarmstufe bestimmt, die entweder Normal, Ausstehend oder Auslösend lauten kann. Wenn beispielsweise mindestens eine Warnung einer Warnungsregel ausgelöst wird, wird auch die Warnungsregel ausgelöst. Der Zustand einer Warnungsregel wird durch den Status ihrer letzten Bewertung bestimmt. Diese können OK, Fehler und sein NoData.
Ein sehr wichtiges Merkmal von Warnungsregeln ist, dass sie benutzerdefinierte Anmerkungen und Beschriftungen unterstützen. Diese ermöglichen es Ihnen, Benachrichtigungen mit zusätzlichen Metadaten wie Zusammenfassungen und Beschreibungen zu versehen und zusätzliche Beschriftungen hinzuzufügen, um Benachrichtigungen an bestimmte Benachrichtigungsrichtlinien weiterzuleiten.
### Benachrichtigungen
Warnmeldungen werden durch Gruppen von key/value Paaren, die als Labels bezeichnet werden, eindeutig identifiziert. Jeder Schlüssel ist ein Labelname und jeder Wert ist ein Labelwert. Beispielsweise könnte eine Warnung die Beschriftungen `foo=bar` und eine andere Warnung die Beschriftungen haben`foo=baz`. Eine Warnung kann viele Bezeichnungen haben, `foo=bar,bar=baz` z. B. kann sie dieselbe Bezeichnung nicht zweimal haben, z. `foo=bar,foo=baz` B. Zwei Alerts können auch nicht dieselben Labels haben, und wenn zwei Alerts dieselbe Bezeichnung wie `foo=bar,bar=baz` und haben, `foo=bar,bar=baz` dann wird eine der Alerts verworfen. Warnungen werden behoben, wenn die Bedingung in der Warnungsregel nicht mehr erfüllt ist oder die Warnungsregel gelöscht wird.
In Grafana Managed Alerts können sich Benachrichtigungen im Status Normal, Ausstehend, Warnung, Keine Daten oder Fehler befinden. In von Datenquellen verwalteten Warnmeldungen wie Mimir und Loki können Benachrichtigungen den Status Normal, Ausstehend und Warnung haben, jedoch nicht oder Fehler. NoData
### Kontaktstellen
Kontaktstellen bestimmen, wohin Benachrichtigungen gesendet werden. Möglicherweise haben Sie eine Kontaktstelle, die Benachrichtigungen an eine E-Mail-Adresse, an Slack, an ein Incident Management System (IRM) wie Grafana OnCall oder Pagerduty oder an einen Webhook sendet.
Die Benachrichtigungen, die von Kontaktstellen gesendet werden, können mithilfe von Benachrichtigungsvorlagen angepasst werden. Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und die Struktur der Benachrichtigung zu ändern. Benachrichtigungsvorlagen sind nicht spezifisch für einzelne Integrationen oder Kontaktstellen.
### Richtlinien für Benachrichtigungen
Benachrichtigungsrichtlinien gruppieren Benachrichtigungen und leiten sie dann an Kontaktstellen weiter. Sie legen fest, wann Benachrichtigungen gesendet werden und wie oft Benachrichtigungen wiederholt werden sollen.
Benachrichtigungen werden mithilfe von Label-Matchern mit Benachrichtigungsrichtlinien abgeglichen. Dabei handelt es sich um menschenlesbare Ausdrücke, mit denen bestätigt wird, ob die Bezeichnungen der Warnung exakt übereinstimmen, ob sie nicht exakt übereinstimmen, ob sie den erwarteten Text enthalten oder nicht. Der Matcher `foo=bar` ordnet beispielsweise Warnungen mit der Bezeichnung zu, `foo=bar` während der Matcher Warnungen mit einem beliebigen Label namens foo mit einem Wert `foo=~[a-zA-Z]+` abgleicht, der dem regulären Ausdruck entspricht. `[a-zA-Z]+`
Standardmäßig kann eine Warnung nur einer Benachrichtigungsrichtlinie entsprechen. Mit dieser `continue` Funktion können jedoch Benachrichtigungen erstellt werden, die einer beliebigen Anzahl von Benachrichtigungsrichtlinien gleichzeitig entsprechen. Weitere Informationen zu Benachrichtigungsrichtlinien finden Sie unter [Benachrichtigungsrichtlinien](v10-alerting-explore-notifications-policies-details.md).
### Zeiten der Stille und Stummschaltung
Stummschalten und Stummschalten ermöglichen es dir, Benachrichtigungen für bestimmte Benachrichtigungen oder sogar ganze Benachrichtigungsrichtlinien zu pausieren. Verwenden Sie eine Stummschaltung, um Benachrichtigungen spontan zu unterbrechen, z. B. während Sie an einer Lösung für eine Warnung arbeiten. Verwenden Sie die Stummschaltung, um Benachrichtigungen in regelmäßigen Intervallen zu unterbrechen, z. B. während regelmäßig geplanten Wartungsfenstern.
**Topics**
+ [Prinzipien](#v10-alerting-overview-principles)
+ [Grundlagen](#v10-alerting-overview-fundamentals)
+ [Datenquellen und Grafana-Alerting](v10-alerting-overview-datasources.md)
+ [Warnmeldungen bei numerischen Daten](v10-alerting-overview-numeric.md)
+ [Beschriftungen und Anmerkungen](v10-alerting-overview-labels.md)
+ [Über Warnungsregeln](v10-alerting-explore-rules.md)
+ [Alert-Manager](v10-alerting-explore-alertmanager.md)
+ [Kontaktstellen](v10-alerting-explore-contacts.md)
+ [Benachrichtigungen](v10-alerting-explore-notifications.md)
+ [Warnung bei hoher Verfügbarkeit](v10-alerting-explore-high-availability.md)
# Datenquellen und Grafana-Alerting
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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, die mit Grafana Alerting kompatibel sind. Jede Datenquelle wird von einem Plugin unterstützt. Grafana-Alerting erfordert, dass Datenquellen-Plugins *Backend-Plugins* sind, um Regeln anhand der Datenquelle auszuwerten, da die Evaluierungs-Engine im Backend läuft. Plugins müssen außerdem angeben, dass sie mit Grafana-Alerting kompatibel sind.
Datenquellen werden im Laufe der Zeit hinzugefügt und aktualisiert. Es ist bekannt, dass die folgenden Datenquellen mit Grafana-Warnungen kompatibel sind.
+ [Stellen Sie eine Connect zu einer CloudWatch Amazon-Datenquelle her](using-amazon-cloudwatch-in-AMG.md)
+ [Stellen Sie eine Connect zu einer Azure Monitor-Datenquelle her](using-azure-monitor-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 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)
+ [Connect zu Amazon Managed Service for Prometheus und Open-Source-Prometheus-Datenquellen her](prometheus-data-source.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)
Ausführlichere Informationen zu Datenquellen und Datenquellen-Plugins in Amazon Managed Grafana finden Sie unter[Verbinden zu Datenquellen](AMG-data-sources.md).
# Warnmeldungen bei numerischen Daten
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
## Tabellendaten
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 einer 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 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-overview-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.](v10-alerting-overview-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.](v10-alerting-overview-labels-templating.md)
**Topics**
+ [Labels](#v10-alerting-overview-labels-labels)
+ [Anmerkungen](#v10-alerting-overview-labels-annotations)
+ [So funktioniert der Labelabgleich](v10-alerting-overview-labels-matching.md)
+ [Etiketten in Grafana-Benachrichtigungen](v10-alerting-overview-labels-alerting.md)
+ [Vorlagen für Beschriftungen und Anmerkungen](v10-alerting-overview-labels-templating.md)
# So funktioniert der Labelabgleich
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 angeben, 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.
## Beispiel
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.
## Beschriftungen ausschließen
Sie können auch Label-Matcher schreiben, um Labels auszuschließen.
Hier ist ein Beispiel, das zeigt, wie das Label `team` ausgeschlossen werden kann. Sie können zwischen jedem dieser Werte wählen, um das Label auszuschließen.
+ `team=""`
+ `team!~.+`
+ `team=~^$`
# Etiketten in Grafana-Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-configure.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, wird `grafana_` es im Kollisionsfall überschrieben.
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
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Vorlagen verwenden, um Daten aus Abfragen und Ausdrücken in Beschriftungen und Anmerkungen aufzunehmen. Möglicherweise möchten Sie den Schweregrad für eine Warnung auf der Grundlage des Werts der Abfrage festlegen oder das Instanzlabel aus der Abfrage in einer zusammenfassenden Anmerkung verwenden, damit Sie wissen, auf welchem Server eine hohe CPU-Auslastung herrscht.
Alle Vorlagen sollten in [Text/Vorlage](https://pkg.go.dev/text/template) geschrieben werden. Unabhängig davon, ob Sie eine Vorlage für ein Etikett oder eine Anmerkung erstellen, sollten Sie jede Vorlage direkt in das Etikett oder die Anmerkung schreiben, für die Sie eine Vorlage erstellen. Das bedeutet, dass Sie Vorlagen nicht gemeinsam mit Beschriftungen und Anmerkungen verwenden können. Stattdessen müssen Sie Vorlagen überall dort kopieren, wo Sie sie verwenden möchten.
Jede Vorlage wird immer dann ausgewertet, wenn die Warnungsregel ausgewertet wird, und zwar für jede Warnung separat. Wenn Ihre Warnungsregel beispielsweise eine Vorlage für eine Zusammenfassung enthält und die Warnungsregel 10 auslösende Alerts enthält, wird die Vorlage zehnmal ausgeführt, einmal für jede Warnung. Sie sollten versuchen, teure Berechnungen in Ihren Vorlagen so weit wie möglich zu vermeiden.
## Beispiele
Anstatt ein vollständiges Tutorial zu schreiben, text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template schauen Sie sich die [Text-/Vorlagendokumentation](https://pkg.go.dev/text/template) an.
**Drucken Sie alle Etiketten kommagetrennt**
Um alle Etiketten durch Kommas getrennt zu drucken, drucken Sie die `$labels` Variable:
```
{{ $labels }}
```
Wenn zum Beispiel eine Warnung mit den Beschriftungen angezeigt wird `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` und das würde Folgendes drucken:
```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```
**Anmerkung**
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).
**Druckt alle Etiketten, eines pro Zeile**
Um alle Etiketten zu drucken, eines pro Zeile, verwenden Sie a, `range` um über jedes key/value Paar zu iterieren und sie einzeln zu drucken. `$k`Bezieht sich hier auf den Namen und `$v` bezieht sich auf den Wert des aktuellen Labels:
```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```
Wenn zum Beispiel eine Warnung mit den Beschriftungen angezeigt `alertname=High CPU usage` wird`instance=server1`, `grafana_folder=CPU alerts` und das würde Folgendes ausgeben:
```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```
**Anmerkung**
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).
**Drucken Sie ein einzelnes Etikett**
Um ein einzelnes Etikett zu drucken, verwenden Sie die `index` Funktion mit der `$labels` Variablen:
```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```
Bei einer Warnung mit dem Etikett würde dies `instance=server1` beispielsweise Folgendes drucken:
```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```
**Anmerkung**
Wenn Sie klassische Bedingungen verwenden, enthält `$labels` diese Option keine Labels aus der Abfrage. Weitere Informationen finden Sie in [der Variablen \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).
**Gibt den Wert einer Abfrage aus**
Um den Wert einer Sofortabfrage zu drucken, können Sie ihre Ref-ID mit der `index` Funktion und der `$values` Variablen drucken:
```
{{ index $values "A" }}
```
Bei einer Sofortabfrage, die beispielsweise den Wert 81.2345 zurückgibt, wird Folgendes gedruckt:
```
81.2345
```
Um den Wert einer Bereichsabfrage zu drucken, müssen Sie ihn zunächst mit einem Reduce-Ausdruck von einer Zeitreihe auf einen Instantvektor reduzieren. Anschließend können Sie das Ergebnis des Reduzierungsausdrucks drucken, indem Sie stattdessen dessen Ref-ID verwenden. Wenn der Reduce-Ausdruck beispielsweise den Durchschnitt von A annimmt und die Referenz-ID B hat, würden Sie schreiben:
```
{{ index $values "B" }}
```
**Gibt den humanisierten Wert einer Abfrage aus**
Um den humanisierten Wert einer Sofortabfrage zu drucken, verwenden Sie die `humanize` Funktion:
```
{{ humanize (index $values "A").Value }}
```
Bei einer Sofortabfrage, die beispielsweise den Wert 81.2345 zurückgibt, wird Folgendes gedruckt:
```
81.234
```
Um den humanisierten Wert einer Bereichsabfrage zu drucken, müssen Sie ihn zunächst von einer Zeitreihe auf einen Instantvektor mit einem Reduce-Ausdruck reduzieren. Anschließend können Sie das Ergebnis des Reduce-Ausdrucks drucken, indem Sie stattdessen dessen Ref-ID verwenden. Wenn der Reduce-Ausdruck beispielsweise den Durchschnitt von A annimmt und die Referenz-ID B hat, würden Sie schreiben:
```
{{ humanize (index $values "B").Value }}
```
**Drucken Sie den Wert einer Abfrage als Prozentsatz**
Um den Wert einer Sofortabfrage als Prozentsatz zu drucken, verwenden Sie die `humanizePercentage` Funktion:
```
{{ humanizePercentage (index $values "A").Value }}
```
Diese Funktion erwartet, dass der Wert eine Dezimalzahl zwischen 0 und 1 ist. Wenn der Wert stattdessen eine Dezimalzahl zwischen 0 und 100 ist, können Sie ihn entweder in Ihrer Abfrage oder mithilfe eines mathematischen Ausdrucks durch 100 teilen. Wenn es sich bei der Abfrage um eine Bereichsabfrage handelt, müssen Sie sie zunächst mit einem Reduce-Ausdruck von einer Zeitreihe auf einen Instantvektor reduzieren.
**Legen Sie anhand des Werts einer Abfrage einen Schweregrad fest**
Verwenden Sie eine if-Anweisung und die Vergleichsfunktion „Größer als“, um anhand des Werts einer Abfrage einen Schweregrad festzulegen. Achten Sie darauf, Dezimalzahlen (`80.0`,, usw.) zu verwenden `50.0``0.0`, wenn Sie Vergleiche durchführen, `$values` da text/template Typenzwang nicht unterstützt wird. [Eine Liste aller unterstützten Vergleichsfunktionen finden Sie hier.](https://pkg.go.dev/text/template#hdr-Functions)
```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```
**Drucken Sie alle Etiketten aus einem klassischen Zustand**
Sie können diese Option nicht verwenden`$labels`, um Etiketten aus der Abfrage zu drucken, wenn Sie klassische Bedingungen verwenden, und müssen `$values` stattdessen verwenden. Der Grund dafür ist, dass bei klassischen Bedingungen diese Bezeichnungen verworfen werden, um eindimensionales Verhalten zu erzwingen (maximal eine Warnung pro Warnungsregel). Wenn die klassischen Bedingungen diese Beschriftungen nicht verwerfen würden, würden Abfragen, die viele Zeitreihen zurückgaben, dazu führen, dass Warnungen ständig zwischen Auslösen und Auflösen hin und her schwanken, da sich die Beschriftungen bei jeder Auswertung der Warnungsregel ändern würden.
Stattdessen enthält die `$values` Variable die reduzierten Werte aller Zeitreihen für alle ausgelösten Bedingungen. Wenn Sie beispielsweise eine Warnungsregel mit einer Abfrage A haben, die zwei Zeitreihen zurückgibt, und einer klassischen Bedingung B mit zwei Bedingungen, dann `$values` würde sie `B0``B1`, `B2` und enthalten`B3`. Wenn die klassische Bedingung B nur eine Bedingung hätte, `$values` würde sie nur `B0` UND enthalten`B1`.
Verwenden Sie die folgende Vorlage, um alle Beschriftungen aller Brennzeitreihen zu drucken (achten Sie darauf, den regulären Ausdruck durch die Ref-ID der klassischen Bedingung zu ersetzen`B`, falls diese anders ist):
```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```
Zum Beispiel würde eine klassische Bedingung für zwei Zeitreihen, die eine einzige Bedingung überschreiten, ausgegeben:
```
B0: instance=server1
B1: instance=server2
```
Wenn die klassische Bedingung zwei oder mehr Bedingungen hat und eine Zeitreihe mehrere Bedingungen gleichzeitig überschreitet, werden ihre Bezeichnungen für jede Bedingung, die überschritten wird, dupliziert:
```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```
Wenn Sie eindeutige Beschriftungen drucken müssen, sollten Sie in Betracht ziehen, Ihre Warnungsregeln stattdessen von eindimensional auf mehrdimensional zu ändern. Sie können dies tun, indem Sie Ihre klassische Bedingung durch Reduce-Ausdrücke und mathematische Ausdrücke ersetzen.
**Druckt alle Werte aus einer klassischen Bedingung**
Um alle Werte einer klassischen Bedingung zu drucken, nehmen Sie das vorherige Beispiel und `$v.Labels` ersetzen Sie es durch`$v.Value`:
```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```
Zum Beispiel würde eine klassische Bedingung für zwei Zeitreihen, die eine einzige Bedingung überschreiten, Folgendes ausgeben:
```
B0: 81.2345
B1: 84.5678
```
Wenn die klassische Bedingung zwei oder mehr Bedingungen hat und eine Zeitreihe mehrere Bedingungen gleichzeitig überschreitet, enthält `$values` sie die Werte aller Bedingungen:
```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```
## Variablen
Die folgenden Variablen stehen Ihnen bei der Erstellung von Vorlagen für Beschriftungen und Anmerkungen zur Verfügung:
### Die labels-Variable
Die `$labels` Variable enthält alle Labels aus der Abfrage. Angenommen, Sie haben eine Abfrage, die die CPU-Auslastung für alle Ihre Server zurückgibt, und Sie haben eine Warnungsregel, die ausgelöst wird, wenn einer Ihrer Server in den letzten 5 Minuten die CPU-Auslastung von 80% überschritten hat. Sie möchten der Warnung eine zusammenfassende Anmerkung hinzufügen, die Ihnen mitteilt, auf welchem Server eine hohe CPU-Auslastung herrscht. Mit der `$labels` Variablen können Sie eine Vorlage schreiben, die einen für Menschen lesbaren Satz druckt, wie zum Beispiel:
```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```
**Anmerkung**
Wenn Sie eine klassische Bedingung verwenden, enthält `$labels` sie keine Labels aus der Abfrage. Bei klassischen Bedingungen werden diese Bezeichnungen verworfen, um eindimensionales Verhalten zu erzwingen (höchstens eine Warnung pro Warnungsregel). Wenn Sie Beschriftungen aus der Abfrage in Ihrer Vorlage verwenden möchten, folgen Sie dem vorherigen Beispiel *Alle Beschriftungen aus einer klassischen Bedingung drucken*.
### Die Wertvariable
Die `$value` Variable ist eine Zeichenfolge, die die Bezeichnungen und Werte aller Sofortabfragen, Schwellenwerte, Reduktionsausdrücke und mathematische Ausdrücke sowie klassische Bedingungen in der Warnungsregel enthält. Sie enthält nicht die Ergebnisse von Bereichsabfragen, da diese zwischen 10 und 10.000 Zeilen oder Metriken zurückgeben können. Wenn dies der Fall wäre, könnte eine einzelne Warnung für besonders große Abfragen 10 Sekunden Speicher MBs beanspruchen, und Grafana würde sehr schnell der Speicher ausgehen.
Um die `$value` Variable in der Zusammenfassung zu drucken, würden Sie etwa Folgendes schreiben:
```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```
Und es würde ungefähr so aussehen:
```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```
`var='A'`Bezieht sich hier auf die Sofortabfrage mit der Referenz-ID A, `labels={instance=instance1}` bezieht sich auf die Labels und `value=81.234` bezieht sich auf die durchschnittliche CPU-Auslastung in den letzten 5 Minuten.
Wenn Sie nur einen Teil der Zeichenfolge statt der vollständigen Zeichenfolge drucken möchten, verwenden Sie die `$values` Variable. Sie enthält dieselben Informationen wie`$value`, aber in einer strukturierten Tabelle, und ist viel einfacher zu verwenden, als einen regulären Ausdruck zu schreiben, der nur dem gewünschten Text entspricht.
### Die Variablen „Werte“
Bei der `$values` Variablen handelt es sich um eine Tabelle, die die Bezeichnungen und Fließkommawerte aller Sofortabfragen und Ausdrücke enthält, die nach ihrer Referenz IDs indexiert sind.
Um den Wert der Sofortabfrage mit der Referenz-ID A zu drucken:
```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```
Bei einer Warnung mit den Beschriftungen `instance=server1` und einer Sofortabfrage mit dem Wert würde dies `81.2345` beispielsweise Folgendes ausgeben:
```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```
Wenn es sich bei der Abfrage in Ref ID A um eine Bereichsabfrage und nicht um eine Sofortabfrage handelt, fügen Sie einen Reduce-Ausdruck mit Ref ID B hinzu und ersetzen Sie ihn durch `(index $values "A")``(index $values "B")`:
```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```
## Funktionen
Bei der Erstellung von Vorlagen für Beschriftungen und Anmerkungen stehen Ihnen die folgenden Funktionen zur Verfügung:
**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.
```
{{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.
```
{{ externalURL }}
```
```
https://example.com/grafana
```
**GraphLink**
Die `graphLink` Funktion gibt den Pfad zur grafischen Ansicht [Erkunden Sie in Grafana-Version 10](v10-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.
```
{{ 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.
```
{{ humanize 1000.0 }}
```
```
1k
```
**humanisieren (1024)**
Das `humanize1024` funktioniert ähnlich wie, verwendet `humanize` aber 1024 statt 1000 als Basis.
```
{{ humanize1024 1024.0 }}
```
```
1ki
```
**HumanizeDuration**
Die `humanizeDuration` Funktion humanisiert eine Dauer in Sekunden.
```
{{ humanizeDuration 60.0 }}
```
```
1m 0s
```
**Prozentsatz humanisieren**
Die `humanizePercentage` Funktion humanisiert einen Verhältniswert zu einem Prozentsatz.
```
{{ humanizePercentage 0.2 }}
```
```
20%
```
**HumanizeTimestamp**
Die `humanizeTimestamp` Funktion humanisiert einen Unix-Zeitstempel.
```
{{ humanizeTimestamp 1577836800.0 }}
```
```
2020-01-01 00:00:00 +0000 UTC
```
**Spiel**
Die `match` Funktion gleicht den Text mit einem regulären Ausdrucksmuster ab.
```
{{ match "a.*" "abc" }}
```
```
true
```
**Pfad/Präfix**
Die `pathPrefix` Funktion gibt den Pfad des Grafana-Servers zurück.
```
{{ pathPrefix }}
```
```
/grafana
```
**TableLink**
Die `tableLink` Funktion gibt den Pfad zur Tabellenansicht [Erkunden Sie in Grafana-Version 10](v10-explore.md) für den angegebenen Ausdruck und die angegebene Datenquelle zurück.
```
{{ 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ß.
```
{{ title "hello, world!" }}
```
```
Hello, World!
```
**toLower**
Die `toLower` Funktion gibt den gesamten Text in Kleinbuchstaben zurück.
```
{{ toLower "Hello, world!" }}
```
```
hello, world!
```
**toUpper**
Die `toUpper` Funktion gibt den gesamten Text in Großbuchstaben zurück.
```
{{ toUpper "Hello, world!" }}
```
```
HELLO, WORLD!
```
**reReplaceAll**
Die `reReplaceAll` Funktion ersetzt Text, der dem regulären Ausdruck entspricht.
```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```
```
example.com:8080
```
# Über Warnungsregeln
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 der Dauer, über die die Bedingung erfüllt sein muss, damit sie ausgelöst wird.
Während Abfragen und Ausdrücke den auszuwertenden Datensatz auswählen, legt eine *Bedingung* den Schwellenwert fest, den die Daten erfüllen oder überschreiten müssen, 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](v10-alerting-explore-rules-types.md)
+ [Regeln für die Aufzeichnung](v10-alerting-explore-rule-recording.md)
+ [Anfragen und Bedingungen](v10-alerting-explore-rules-queries.md)
+ [Warnungsinstanzen](v10-alerting-rules-instances.md)
+ [Namespaces, Ordner und Gruppen](v10-alerting-rules-grouping.md)
+ [Evaluierung von Warnmeldungsregeln](v10-alerting-rules-evaluation.md)
+ [Stand und Zustand der Warnregeln](v10-alerting-explore-state.md)
+ [Vorlagen für Benachrichtigungen](v10-alerting-rules-notification-templates.md)
# Arten von Warnungsregeln
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. Erfahren Sie mehr über die einzelnen Warnungsregeltypen und deren Funktionsweise und entscheiden Sie, welcher für Ihren Anwendungsfall am besten geeignet ist.
## Von Grafana verwaltete Regeln
Von Grafana verwaltete Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Benachrichtigungen zu erstellen, die auf Daten aus jeder Ihrer vorhandenen Datenquellen reagieren können.
Sie unterstützen nicht nur mehrere Datenquellen, sondern können auch [Ausdrücke](v10-panels-query-xform-expressions.md) hinzufügen, um Ihre Daten zu transformieren und Warnbedingungen auszudrücken.
In Grafana verwaltete Benachrichtigungen:
+ Warnungsregeln werden in Grafana auf der Grundlage einer oder mehrerer Datenquellen erstellt.
+ Warnungsregeln werden von der Engine zur Bewertung von Alert-Regeln in Grafana ausgewertet.
+ Alerts werden mit dem internen Grafana-Alertmanager zugestellt.
**Anmerkung**
Sie können Benachrichtigungen auch so konfigurieren, dass sie mit einem externen Alertmanager zugestellt werden, oder Sie können sowohl interne als auch externe Alertmanager verwenden. Weitere Informationen finden Sie unter Einen externen Alertmanager [hinzufügen](v10-alerting-setup-alertmanager.md).
## Regeln für verwaltete Datenquellen
Um mit Datenquellen verwaltete Warnregeln 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.
Bei datenquellenverwalteten Warnmeldungen:
+ Warnungsregeln werden in der Datenquelle selbst erstellt und gespeichert.
+ Warnungsregeln können nur auf der Grundlage von Prometheus-Daten erstellt werden.
+ Die Auswertung und Bereitstellung von Warnregeln erfolgt aus Gründen der Hochverfügbarkeit und Fehlertoleranz auf mehrere Knoten verteilt.
## Wählen Sie einen Warnungsregeltyp
Beachten Sie bei der Auswahl des zu verwendenden Warnungsregeltyps den folgenden Vergleich zwischen von Grafana verwalteten Warnungsregeln und datenquellenverwalteten Warnungsregeln.
| Feature | Von Grafana verwaltete Warnungsregel | Von Loki/Mimir verwaltete Warnungsregel |
| --- | --- | --- |
| Erstellen Sie Warnregeln auf der Grundlage von Daten aus einer unserer unterstützten Datenquellen | Ja | Nein: Sie können nur Warnungsregeln erstellen, die auf Prometheus-Daten basieren. Für die Datenquelle muss die Ruler-API aktiviert sein. |
| Datenquellen mischen und abgleichen | Ja | Nein |
| Beinhaltet Unterstützung für Aufzeichnungsregeln | Nein | Ja |
| Fügen Sie Ausdrücke hinzu, um Ihre Daten zu transformieren und Warnbedingungen festzulegen | Ja | Nein |
| Verwenden Sie Bilder in Warnmeldungen | Ja | Nein |
| Skalierung | Sie sind ressourcenintensiver, hängen von der Datenbank ab und können mit vorübergehenden Fehlern behaftet sein. Sie lassen sich nur vertikal skalieren. | Speichern Sie Warnregeln in der Datenquelle selbst und ermöglichen Sie eine „unendliche“ Skalierung. Generieren und versenden Sie Warnmeldungen vom Speicherort Ihrer Daten aus. |
| Bewertung und Bereitstellung von Warnmeldungsregeln | Die Auswertung und Bereitstellung von Warnregeln erfolgt innerhalb von Grafana mit einem externen Alertmanager oder beidem. | Die Auswertung und Zustellung von Warnmeldungsregeln erfolgt verteilt, sodass es keine einzige Fehlerquelle gibt. |
# Regeln für die Aufzeichnung
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
*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 Abfrage dieser neuen Zeitreihe ist schneller, insbesondere bei Dashboards, da bei jeder Aktualisierung der Dashboards derselbe Ausdruck abgefragt wird.
Lesen Sie mehr über die [Aufnahmeregeln](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.
# Anfragen und Bedingungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 spielen Abfragen eine wichtige Rolle beim Abrufen und Transformieren von Daten aus unterstützten Datenquellen, zu denen Datenbanken wie MySQL und PostgreSQL, Zeitreihendatenbanken wie Prometheus, InfluxDB und Graphite sowie Dienste wie Amazon OpenSearch CloudWatch, Azure Monitor und Google Cloud Monitoring gehören.
Weitere Informationen zu unterstützten Datenquellen finden Sie unter. [Datenquellen und Grafana-Alerting](v10-alerting-overview-datasources.md)
Beim Ausführen einer Abfrage müssen Sie die Datenquelle definieren, die gewünschten Daten angeben, die abgerufen werden sollen, und die entsprechenden Filter oder Transformationen anwenden. Für die Erstellung dieser Abfragen werden Abfragesprachen oder Syntaxen verwendet, die für die gewählte Datenquelle spezifisch sind.
In Alerting definieren Sie eine Abfrage, um die Daten abzurufen, die Sie messen möchten, und eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.
Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, die die Daten auswählen, die Sie messen möchten.
Weitere Informationen zu Abfragen und Ausdrücken finden Sie unter[Daten abfragen und transformieren](v10-panels-query-xform.md).
## Datenquellenabfragen
Abfragen in Grafana können je nach verwendeter Datenquelle und Abfragesprache auf verschiedene Arten angewendet werden. Der Abfrage-Editor jeder Datenquelle bietet eine benutzerdefinierte Benutzeroberfläche, mit der Sie Abfragen schreiben können, die die einzigartigen Funktionen nutzen.
Aufgrund der Unterschiede zwischen den Abfragesprachen sieht jeder Abfrage-Editor für Datenquellen anders aus und funktioniert auch anders. Abhängig von Ihrer Datenquelle bietet der Abfrage-Editor möglicherweise Funktionen zur automatischen Vervollständigung, Metriknamen, Variablenvorschläge oder eine visuelle Oberfläche zur Abfrageerstellung.
Zu den gängigen Typen von Abfragekomponenten gehören:
**Metriken oder Datenfelder** — Geben Sie die spezifischen Metriken oder Datenfelder an, die Sie abrufen möchten, z. B. CPU-Auslastung, Netzwerkverkehr oder Sensorwerte.
**Zeitraum** — Definieren Sie den Zeitraum, für den Sie Daten abrufen möchten, z. B. die letzte Stunde, einen bestimmten Tag oder einen benutzerdefinierten Zeitraum.
**Filter** — Wenden Sie Filter an, um die Daten anhand bestimmter Kriterien einzugrenzen, z. B. das Filtern von Daten nach einem bestimmten Tag, Host oder einer bestimmten Anwendung.
**Aggregationen** — Führen Sie Aggregationen der Daten durch, um Kennzahlen wie Durchschnittswerte, Summen oder Zahlen über einen bestimmten Zeitraum zu berechnen.
**Gruppierung — Gruppieren** Sie die Daten nach bestimmten Dimensionen oder Tags, um aggregierte Ansichten oder Aufschlüsselungen zu erstellen.
**Anmerkung**
Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden [Sie hier](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) in den Grafana Labs-Foren.
## Ausdrucksabfragen
In Grafana wird ein Ausdruck verwendet, um Berechnungen, Transformationen oder Aggregationen an den abgefragten Daten der Datenquelle durchzuführen. Es ermöglicht Ihnen, benutzerdefinierte Metriken zu erstellen oder bestehende Metriken auf der Grundlage mathematischer Operationen, Funktionen oder logischer Ausdrücke zu ändern.
Mithilfe von Ausdrucksabfragen können Benutzer Aufgaben wie die Berechnung der prozentualen Änderung zwischen zwei Werten, die Anwendung von Funktionen wie logarithmischen oder trigonometrischen Funktionen, die Aggregation von Daten über bestimmte Zeitbereiche oder Dimensionen und die Implementierung bedingter Logik zur Behandlung verschiedener Szenarien ausführen.
In Alerting können Sie nur Ausdrücke für von Grafana verwaltete Warnungsregeln verwenden. Für jeden Ausdruck können Sie aus den Mathe-, Reduce- und Resampling-Ausdrücken wählen. Diese Regeln werden als multidimensionale Regeln bezeichnet, da sie für jede Serie eine separate Warnung generieren.
Sie können auch eine klassische Bedingung verwenden, bei der eine Warnungsregel erstellt wird, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.
**Anmerkung**
Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.
**Reduzieren**
Aggregiert Zeitreihenwerte im ausgewählten Zeitbereich zu einem einzigen Wert.
**Math (Mathematik)**
Führt Berechnungen functions/operations in freier Form mit Zeitreihen- und Zahlendaten durch. Kann zur Vorverarbeitung von Zeitreihendaten oder zur Definition einer Warnbedingung für Zahlendaten verwendet werden.
**Resampling**
Ordnet einen Zeitbereich einem neuen Satz von Zeitstempeln neu zu. Dies ist nützlich, wenn Zeitreihendaten aus verschiedenen Datenquellen verglichen werden, bei denen die Zeitstempel sonst nicht übereinstimmen würden.
**Threshold**
Überprüft, ob Zeitreihendaten der Schwellenwertbedingung entsprechen.
Mit dem Schwellenwertausdruck können Sie zwei Einzelwerte vergleichen. Er kehrt zurück`0`, wenn die Bedingung falsch ist und `1` wenn die Bedingung wahr ist. Die folgenden Schwellenwertfunktionen sind verfügbar:
+ Liegt über (x > y)
+ Liegt darunter (x < y)
+ Liegt darunter (x y1 UND x < y2)
+ < y1 AND x >Liegt außerhalb des Bereichs (x y2)
**Klassischer Zustand**
Überprüft, ob Zeitreihendaten der Warnbedingung entsprechen.
**Anmerkung**
Klassische Abfragen mit Bedingungsausdrücken erzeugen immer nur eine Warnungsinstanz, unabhängig davon, wie viele Zeitreihen die Bedingung erfüllen. Klassische Bedingungen existieren hauptsächlich aus Kompatibilitätsgründen und sollten nach Möglichkeit vermieden werden.
## Aggregationen
Grafana Alerting bietet die folgenden Aggregationsfunktionen, mit denen Sie Ihre Abfrage weiter verfeinern können.
Diese Funktionen sind nur für **Bedingungsausdrücke vom **Typ Reduce** und Classic** verfügbar.
| Funktion | Expression | Was macht es |
| --- | --- | --- |
| avg | Reduzieren//Klassisch | Zeigt den Durchschnitt der Werte an |
| min | Reduzieren//Klassisch | Zeigt den niedrigsten Wert an |
| max | Reduzieren//Klassisch | Zeigt den höchsten Wert an |
| sum | Reduzieren//Klassisch | Zeigt die Summe aller Werte an |
| count | Reduzieren//Klassisch | Zählt die Anzahl der Werte im Ergebnis |
| last | Reduzieren//Klassisch | Zeigt den letzten Wert an |
| median | Reduzieren//Klassisch | Zeigt den Medianwert an |
| diff | Classic | Zeigt den Unterschied zwischen dem neuesten und dem ältesten Wert an |
| diff\$1abs | Classic | Zeigt den absoluten Wert von diff an |
| percent\$1diff | Classic | Zeigt den prozentualen Wert der Differenz zwischen dem neuesten und dem ältesten Wert an |
| percent\$1diff\$1abs | Classic | Zeigt den absoluten Wert von percent\$1diff an |
| count\$1non\$1null | Classic | Zeigt die Anzahl der Werte in der Ergebnismenge an, die dies nicht sind null |
## Warnungsbedingung
Eine Warnbedingung ist die Abfrage oder der Ausdruck, der bestimmt, ob die Warnung ausgelöst wird oder nicht, je nachdem, welchen Wert sie liefert. Es kann nur eine Bedingung geben, die bestimmt, ob die Warnung ausgelöst wird.
Nachdem Sie Ihre and/or Abfrageausdrücke definiert haben, wählen Sie einen davon als Bedingung für die Warnungsregel aus.
Wenn die abgefragten Daten die definierte Bedingung erfüllen, löst Grafana die zugehörige Warnung aus, die so konfiguriert werden kann, dass Benachrichtigungen über verschiedene Kanäle wie E-Mail, Slack oder gesendet werden. PagerDuty Die Benachrichtigungen informieren Sie darüber, dass die Bedingung erfüllt ist, sodass Sie geeignete Maßnahmen ergreifen oder das zugrunde liegende Problem untersuchen können.
Standardmäßig wird der zuletzt hinzugefügte Ausdruck als Warnbedingung verwendet.
## Schwellenwert für die Wiederherstellung
Um das Geräusch flackernder Warnmeldungen zu reduzieren, können Sie einen Schwellenwert für die Wiederherstellung festlegen, der sich vom Schwellenwert für Warnmeldungen unterscheidet.
Flatternde Alerts treten auf, wenn eine Metrik über dem Schwellenwert liegt. Dies kann zu häufigen Statusänderungen führen, sodass zu viele Benachrichtigungen generiert werden.
Von Grafana verwaltete Warnregeln werden für ein bestimmtes Zeitintervall ausgewertet. Bei jeder Auswertung wird das Ergebnis der Abfrage mit dem in der Warnungsregel festgelegten Schwellenwert verglichen. Wenn der Wert einer Metrik über dem Schwellenwert liegt, wird eine Warnungsregel ausgelöst und eine Benachrichtigung gesendet. Wenn der Wert unter den Schwellenwert fällt und eine aktive Warnung für diese Metrik vorliegt, wird die Warnung behoben und eine weitere Benachrichtigung gesendet.
Es kann schwierig sein, eine Warnungsregel für eine verrauschte Metrik zu erstellen. Das heißt, wenn der Wert einer Metrik kontinuierlich einen Schwellenwert über- und unterschreitet. Dies wird als Flattern bezeichnet und führt zu einer Reihe von Benachrichtigungen über das Auslösen von Auslösen und zu einer fehlerhaften Statushistorie der Warnmeldungen.
Wenn Sie beispielsweise eine Latenzwarnung mit einem Schwellenwert von 1000 ms haben und die Zahl um 1000 schwankt (sagen wir 980 ->1010 -> 990 -> 1020 usw.), löst jede dieser Alarme eine Benachrichtigung aus.
Um dieses Problem zu lösen, können Sie einen (benutzerdefinierten) Wiederherstellungsschwellenwert festlegen, was im Grunde bedeutet, dass Sie zwei Schwellenwerte anstelle von einem haben. Eine Warnung wird ausgelöst, wenn der erste Schwellenwert überschritten wird, und sie wird erst behoben, wenn der zweite Schwellenwert überschritten wird.
Sie könnten beispielsweise einen Schwellenwert von 1000 ms und einen Wiederherstellungsschwellenwert von 900 ms festlegen. Auf diese Weise hört eine Warnregel erst auf, wenn sie unter 900 ms fällt, und das Flattern wird reduziert.
# Warnungsinstanzen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 wir nach der ersten Auswertung beobachten, sodass eine einzige Regel den Status jeder CPU melden kann.
# Namespaces, Ordner und Gruppen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 und Ordner**
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.
Ein Namespace enthält eine oder mehrere Gruppen. Die Regeln innerhalb einer Gruppe werden sequentiell in regelmäßigen Abständen ausgeführt. Das Standardintervall ist eine Minute. Sie können die Namespaces und Gruppen für Grafana Mimi- oder Loki-Regeln umbenennen und die Bewertungsintervalle für Gruppen bearbeiten.
**Gruppen**
Die Regeln innerhalb einer Gruppe werden nacheinander in regelmäßigen Intervallen ausgeführt, was bedeutet, dass keine Regeln gleichzeitig und in der Reihenfolge ihres Auftretens ausgewertet werden. Das Standardintervall ist eine Minute. Sie können Grafana Mimir- oder Loki-Regelnamespaces oder Loki-Regelnamespaces und -gruppen umbenennen und die Gruppenauswertungsintervalle bearbeiten.
**Tipp**
Wenn Sie möchten, dass Regeln gleichzeitig und mit unterschiedlichen Intervallen ausgewertet werden, sollten Sie erwägen, sie in verschiedenen Gruppen zu speichern.
**Anmerkung**
Von Grafana verwaltete Warnungsregeln werden gleichzeitig und nicht sequentiell ausgewertet.
# Evaluierung von Warnmeldungsregeln
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden sollte und wie schnell sie ihren Status ändern sollte.
Dazu müssen Sie sicherstellen, dass sich Ihre Warnungsregel in der richtigen Bewertungsgruppe befindet, und einen Wartezeitraum festlegen, der für Ihren Anwendungsfall am besten geeignet ist.
## Bewertungsgruppe
Jede Warnungsregel ist Teil einer Bewertungsgruppe. Jede Bewertungsgruppe enthält ein Bewertungsintervall, das bestimmt, wie oft die Warnungsregel überprüft wird.
**Von Datenquellen verwaltete** Warnungsregeln innerhalb derselben Gruppe werden nacheinander ausgewertet, während Warnungsregeln in verschiedenen Gruppen gleichzeitig ausgewertet werden können. Diese Funktion ist besonders nützlich, wenn Sie sicherstellen möchten, dass Aufzeichnungsregeln vor allen Warnungsregeln ausgewertet werden.
**Von Grafana verwaltete** Warnungsregeln werden unabhängig von der Warnungsregelgruppe gleichzeitig ausgewertet. Das Standardauswertungsintervall ist auf 10 Sekunden festgelegt, was bedeutet, dass von Grafana verwaltete Warnungsregeln alle 10 Sekunden bis zum nächsten 10-Sekunden-Fenster auf der Uhr ausgewertet werden, zum Beispiel 10:00:00, 10:00:10, 10:00:20 usw. Bei Bedarf können Sie auch Ihr eigenes Bewertungsintervall konfigurieren.
**Anmerkung**
Bewertungsgruppen und die Gruppierung von Warnmeldungen in Benachrichtigungsrichtlinien sind zwei verschiedene Dinge. Durch die Gruppierung nach Benachrichtigungsrichtlinien können mehrere Warnmeldungen mit denselben Labels in derselben Zeitnachricht gesendet werden.
## Ausstehender Zeitraum
Indem Sie einen Wartezeitraum festlegen, können Sie unnötige Benachrichtigungen bei vorübergehenden Problemen vermeiden.
In der Wartezeit wählen Sie den Zeitraum aus, in dem eine Warnungsregel gegen die Bedingung verstoßen kann, bis sie ausgelöst wird.
**Beispiel**
Stellen Sie sich vor, Sie haben ein Bewertungsintervall für die Warnungsregel auf alle 30 Sekunden und die Wartezeit auf 90 Sekunden festgelegt.
Die Auswertung erfolgt wie folgt:
[00:30] Erste Bewertung — Bedingung nicht erfüllt.
[01:00] Zweite Bewertung — Bedingung verletzt. Der Zähler für ausstehende Zahlungen wird gestartet. **Die Warnung beginnt ausstehend.**
[01:30] Dritte Bewertung — Bedingung verletzt. Ausstehender Zähler = 30 Sekunden. **Status „Ausstehend“.**
[02:00] Vierte Bewertung — Bedingung verletzt. **Zähler „Ausstehend“ = Status „60 Sekunden ausstehend“.**
[02:30] Fünfte Bewertung — Bedingung verletzt. Ausstehender Zähler = 90 Jahre. **Der Alarm wird ausgelöst**
Wenn die Warnungsregel eine Bedingung hat, die für einen bestimmten Zeitraum verletzt werden muss, bevor sie aktiv wird, ändert sich ihr Status wie folgt:
+ Wenn die Bedingung zum ersten Mal verletzt wird, wechselt die Regel in den Status „Ausstehend“.
+ Die Regel verbleibt im Status „ausstehend“, bis die Bedingung für den erforderlichen Zeitraum nicht eingehalten wurde (Wartezeit).
+ Sobald die erforderliche Zeit verstrichen ist, wechselt die Regel in den Status „Auslösung“.
+ Wenn die Bedingung während der Wartezeit nicht mehr verletzt wird, kehrt die Regel in ihren normalen Zustand zurück.
**Anmerkung**
Wenn Sie den Status „Ausstehend“ überspringen möchten, können Sie den Wartezeitraum einfach auf 0 setzen. Dadurch wird die Wartezeit praktisch übersprungen und Ihre Warnungsregel wird ausgelöst, sobald die Bedingung verletzt wird.
Wenn eine Warnungsregel ausgelöst wird, werden Warnungsinstanzen erzeugt, die dann an den Alertmanager gesendet werden.
# Stand und Zustand der Warnregeln
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 der Zustand der 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. |
**Letzten Status beibehalten**
Eine Warnungsregel kann so konfiguriert werden, dass der letzte Status beibehalten wird, wenn `NoData` der letzte `Error` Status erreicht wird. Dadurch wird sowohl verhindert, dass Warnmeldungen ausgelöst werden, als auch, dass sie behoben und erneut ausgelöst werden. Genau wie bei der normalen Evaluierung wird die Warnungsregel von `Pending` zu `Firing` nach Ablauf der Wartezeit umgestellt.
**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.
# Vorlagen für Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-manage-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.
# Alert-Manager
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Alerts generiert werden.
**Grafana Alarmmanager**
Grafana Alertmanager ist ein interner Alertmanager, der vorkonfiguriert ist und standardmäßig zur Auswahl steht.
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.
# Kontaktstellen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
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. Ein Kontaktpunkt könnte beispielsweise eine Pagerduty-Integration, eine Amazon SNS- und Slack-Integration oder eine Pagerduty-Integration, eine Slack-Integration und zwei Amazon SNS-Integrationen enthalten. Sie können auch eine Kontaktstelle 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.
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 [Kontaktpunkte konfigurieren](v10-alerting-configure-contactpoints.md) und[Benachrichtigungen anpassen](v10-alerting-manage-notifications.md).
# Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-explore-contacts.md), die festlegen, wohin Ihre Warnmeldungen gesendet werden sollen. Eine Kontaktstelle besteht aus einer oder mehreren Integrationen, die zur Übermittlung von Benachrichtigungen verwendet werden. Fügen Sie Benachrichtigungsvorlagen zu Kontaktpunkten hinzu, um sie wiederzuverwenden und die Nachrichtenübermittlung in Ihren Benachrichtigungen einheitlich zu gestalten.
Als Nächstes erstellen Sie eine Benachrichtigungsrichtlinie, bei der es sich um eine Reihe von Regeln handelt, die festlegen, 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.
## Alert-Manager
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 Standardrichtlinie bezeichnet wird. Es kann nur eine Standardrichtlinie geben, und die Standardrichtlinie 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 verschachtelte Richtlinie kann über eigene verschachtelte Richtlinien verfügen, die eine zusätzliche Zuordnung von Warnmeldungen ermöglichen. Ein Beispiel für eine verschachtelte Richtlinie könnte das Senden von Infrastrukturwarnungen an das Ops-Team sein, während eine untergeordnete Richtlinie Warnmeldungen 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 Standardrichtlinie. Wenn die Standardrichtlinie jedoch eine Warnung erhält, überprüft sie jede verschachtelte Richtlinie und sendet die Warnung an die erste verschachtelte Richtlinie, die der Warnung entspricht. Wenn die verschachtelte Richtlinie weitere verschachtelte Richtlinien enthält, kann sie versuchen, die Warnung mit einer ihrer verschachtelten Richtlinien abzugleichen. Wenn keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die Richtlinie selbst die entsprechende Richtlinie. Wenn keine verschachtelten Richtlinien vorhanden sind oder keine verschachtelten Richtlinien mit der Warnung übereinstimmen, ist die Standardrichtlinie die entsprechende Richtlinie.
Ausführlichere Informationen zu Benachrichtigungsrichtlinien finden Sie unter. [Richtlinien für Benachrichtigungen](v10-alerting-explore-notifications-policies-details.md)
## Vorlagen für Benachrichtigungen
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“.
Ausführlichere Informationen zum Anpassen von Benachrichtigungen finden Sie unter. [Benachrichtigungen anpassen](v10-alerting-manage-notifications.md)
## Stille
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.
Ausführlichere Informationen zur Verwendung von Stille finden Sie unter[Warnmeldungen stummschalten](v10-alerting-silences.md).
# Richtlinien für Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 bieten Ihnen eine flexible Möglichkeit, Benachrichtigungen an verschiedene Empfänger weiterzuleiten. Mithilfe von Label-Matchern können Sie die Zustellung von Warnmeldungen ändern, ohne jede einzelne Warnungsregel aktualisieren zu müssen.
In diesem Abschnitt erfahren Sie mehr darüber, wie Benachrichtigungsrichtlinien funktionieren und strukturiert sind, sodass Sie das Beste aus der Einrichtung Ihrer Benachrichtigungsrichtlinien herausholen können.
## Richtlinienbaum
Bei Benachrichtigungsrichtlinien handelt es sich *nicht* um eine Liste, sondern um eine Baumstruktur. Das bedeutet, dass jede Richtlinie untergeordnete Richtlinien haben kann usw. Das Stammverzeichnis der Benachrichtigungsrichtlinienstruktur wird als **Standardbenachrichtigungsrichtlinie** bezeichnet.
Jede Richtlinie besteht aus einer Reihe von Label-Matchern (0 oder mehr), die angeben, mit welchen Labels sie umgehen möchten oder nicht.
Weitere Informationen zum Label-Abgleich finden Sie unter[So funktioniert der Labelabgleich](v10-alerting-overview-labels-matching.md).
**Anmerkung**
Wenn Sie keine Label-Matcher für Ihre Benachrichtigungsrichtlinie konfiguriert haben, entspricht Ihre Benachrichtigungsrichtlinie *allen* Warnungsinstanzen. Dadurch können Richtlinien für Kinder möglicherweise nicht bewertet werden, es sei denn, Sie haben in der Benachrichtigungsrichtlinie die Option **Gleichgeschlechtsabgleich fortsetzen** aktiviert.
## Routing
Um zu bestimmen, welche Benachrichtigungsrichtlinie für welche Warnungsinstanzen zuständig ist, müssen Sie sich zunächst die vorhandenen Benachrichtigungsrichtlinien ansehen, beginnend mit der Standardbenachrichtigungsrichtlinie.
Wenn keine anderen Richtlinien als die Standardrichtlinie konfiguriert sind, verwaltet die Standardrichtlinie die Warnungsinstanz.
Wenn andere Richtlinien als die Standardrichtlinie definiert sind, werden diese Benachrichtigungsrichtlinien in der Reihenfolge bewertet, in der sie angezeigt werden.
Wenn eine Benachrichtigungsrichtlinie Label-Matcher hat, die mit den Bezeichnungen der Warnungsinstanz übereinstimmen, wird sie zu ihren untergeordneten Richtlinien übergehen und, falls vorhanden, weiterhin nach untergeordneten Richtlinien suchen, die möglicherweise Label-Matcher haben, die die Gruppe der Bezeichnungen weiter einschränken, usw., bis keine untergeordneten Richtlinien mehr gefunden wurden.
Wenn in einer Benachrichtigungsrichtlinie keine untergeordneten Richtlinien definiert sind oder wenn keine der untergeordneten Richtlinien Label-Matcher hat, die den Labels der Warnungsinstanz entsprechen, wird die übergeordnete Benachrichtigungsrichtlinie verwendet.
Sobald eine passende Richtlinie gefunden wurde, sucht das System nicht weiter nach anderen passenden Richtlinien. Wenn Sie weiterhin nach anderen Richtlinien suchen möchten, die möglicherweise übereinstimmen, aktivieren **Sie Weiter nach gleichgeordneten Richtlinien für** diese bestimmte Richtlinie abgleichen.
Wenn keine der Benachrichtigungsrichtlinien ausgewählt ist, wird schließlich die Standardbenachrichtigungsrichtlinie verwendet.
### Beispiel für Routing
Hier ist ein Beispiel für einen relativ einfachen Benachrichtigungsrichtlinienbaum und einige Warnungsinstanzen.
![\[Ein Bild zeigt eine Reihe von Benachrichtigungsrichtlinien in einer Baumstruktur und eine Reihe von Warnungsinstanzen mit unterschiedlichen Bezeichnungen, die den Richtlinien entsprechen.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/notification-routing.png)
Im Folgenden finden Sie eine Aufschlüsselung, wie diese Richtlinien ausgewählt werden:
**Pod stuck in CrashLoop** hat kein `severity` Label, sodass keine der untergeordneten Richtlinien übereinstimmt. Es hat ein `team=operations` Label, sodass die erste Richtlinie zugeordnet ist.
Die `team=security` Richtlinie wird nicht evaluiert, da wir bereits eine Übereinstimmung gefunden haben und **„Mit gleichgestellten Personen fortfahren**“ für diese Richtlinie nicht konfiguriert wurde.
**Festplattennutzung — 80%** haben sowohl ein als auch ein `severity` Label `team` und entsprechen einer untergeordneten Richtlinie des Betriebsteams.
**Unautorisierte Protokolleinträge** haben eine `team` Bezeichnung, stimmen aber nicht mit der ersten Richtlinie (`team=operations`) überein, da die Werte nicht identisch sind. Daher wird die Suche fortgesetzt und der `team=security` Richtlinie entspricht. Da es keine untergeordneten Richtlinien gibt, wird das zusätzliche `severity=high` Label ignoriert.
## Vererbung
Untergeordnete Richtlinien sind nicht nur ein nützliches Konzept für die Weiterleitung von Warnungsinstanzen, sondern übernehmen auch Eigenschaften von ihrer übergeordneten Richtlinie. Dies gilt auch für alle Richtlinien, bei denen es sich um untergeordnete Richtlinien der Standardbenachrichtigungsrichtlinie handelt.
Die folgenden Eigenschaften werden an untergeordnete Richtlinien vererbt:
+ Kontaktstelle
+ Gruppierungsoptionen
+ Zeitliche Optionen
+ Timings stummschalten
Jede dieser Eigenschaften kann durch eine individuelle Richtlinie überschrieben werden, falls Sie die geerbten Eigenschaften überschreiben möchten.
Wenn Sie eine Kontaktstelle aus der übergeordneten Richtlinie übernehmen möchten, lassen Sie das Feld leer. Um die vererbten Gruppierungsoptionen zu überschreiben, aktivieren Sie Gruppierung **überschreiben**. Um die geerbten Zeitoptionen zu überschreiben, aktivieren Sie die Option **Allgemeine Zeitangaben überschreiben**.
### Beispiel für Vererbung
Das folgende Beispiel zeigt, wie der Benachrichtigungsrichtlinienbaum aus unserem vorherigen Beispiel es den untergeordneten Richtlinien von ermöglicht, ihren Kontaktpunkt `team=operations` zu erben.
Auf diese Weise können wir vermeiden, dass dieselbe Kontaktstelle für jede Kinderrichtlinie mehrmals angegeben werden muss.
![\[Ein Bild, das eine Reihe von Benachrichtigungsrichtlinien in einer Baumstruktur zeigt, wobei einigen Richtlinien Kontaktstellen zugewiesen sind, einige Richtlinien für Kinder jedoch die Kontaktstellen ihrer Eltern erben, anstatt ihre eigenen zu definieren.\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/notification-inheritance.png)
## Zusätzliche Konfigurationsoptionen
### Gruppierung
Die Gruppierung ist eine wichtige Funktion von Grafana Alerting, da Sie damit relevante Benachrichtigungen zu einer kleineren Anzahl von Benachrichtigungen zusammenfassen können. Dies ist besonders wichtig, wenn Benachrichtigungen an Ersthelfer gesendet werden, z. B. an Techniker auf Abruf, bei denen der Erhalt vieler Benachrichtigungen in kurzer Zeit überwältigend sein kann und sich in einigen Fällen negativ auf die Fähigkeit eines Ersthelfers auswirken kann, auf einen Vorfall zu reagieren. Stellen Sie sich zum Beispiel einen großen Ausfall vor, bei dem viele Ihrer Systeme ausgefallen sind. In diesem Fall kann die Gruppierung den Unterschied zwischen dem Empfang eines Telefonanrufs und 100 Telefonanrufen ausmachen.
Mithilfe der Option Gruppieren nach in einer Benachrichtigungsrichtlinie legen Sie fest, wie Benachrichtigungen gruppiert werden. Standardmäßig gruppieren Benachrichtigungsrichtlinien in Grafana-Benachrichtigungen nach Warnungsregeln mithilfe der `grafana_folder` Bezeichnungen `alertname` und (da Warnungsnamen in mehreren Ordnern nicht eindeutig sind). Wenn Sie Benachrichtigungen nach etwas anderem als der Warnungsregel gruppieren möchten, ändern Sie die Gruppierung in eine andere Kombination von Bezeichnungen.
#### Deaktivieren Sie die Gruppierung
Wenn Sie jede Warnung als separate Benachrichtigung erhalten möchten, können Sie dies tun, indem Sie sie nach einem speziellen Label namens gruppieren. `...` Dies ist nützlich, wenn Ihre Benachrichtigungen an ein automatisiertes System und nicht an einen Ersthelfer gesendet werden.
#### Eine einzige Gruppe für alle Benachrichtigungen
Wenn Sie alle Benachrichtigungen zusammen in einer einzigen Benachrichtigung erhalten möchten, können Sie dies tun, indem Sie Group by leer lassen.
### Zeitliche Optionen
Die Zeitoptionen bestimmen, wie oft Benachrichtigungen für jede Gruppe von Benachrichtigungen gesendet werden. Es gibt drei Timer, über die Sie Bescheid wissen müssen: Gruppenwartezeit, Gruppenintervall und Wiederholungsintervall.
#### Wartezeit für Gruppen
Gruppenwartezeit ist die Zeit, die Grafana wartet, bevor die erste Benachrichtigung für eine neue Gruppe von Benachrichtigungen gesendet wird. Je länger die Gruppe wartet, desto mehr Zeit haben Sie, bis andere Benachrichtigungen eintreffen. Je kürzer die Wartezeit für Gruppen ist, desto früher wird die erste Benachrichtigung gesendet, es besteht jedoch die Gefahr, dass unvollständige Benachrichtigungen gesendet werden. Sie sollten immer eine Wartezeit für Gruppen wählen, die für Ihren Anwendungsfall am sinnvollsten ist.
**Die Standardeinstellung** beträgt 30 Sekunden
#### Gruppenintervall
Sobald die erste Benachrichtigung für eine neue Gruppe von Benachrichtigungen gesendet wurde, startet Grafana den Gruppenintervall-Timer. Dies ist die Zeit, die Grafana wartet, bevor sie Benachrichtigungen über Änderungen an die Gruppe sendet. Beispielsweise wurde der Gruppe möglicherweise gerade ein weiterer Auslösealarm hinzugefügt, während ein vorhandener Alarm möglicherweise behoben wurde. Wenn eine Warnung aufgrund einer Wartezeit in der Gruppe zu spät war, um in die erste Benachrichtigung aufgenommen zu werden, wird sie nach Ablauf des Gruppenintervalls in nachfolgende Benachrichtigungen aufgenommen. Nach Ablauf des Gruppenintervalls setzt Grafana den Gruppenintervall-Timer zurück. Dies wiederholt sich, bis keine Benachrichtigungen mehr in der Gruppe vorhanden sind. Danach wird die Gruppe gelöscht.
**Standard** 5 Minuten
#### Intervall wiederholen
Das Wiederholungsintervall bestimmt, wie oft Benachrichtigungen wiederholt werden, wenn sich die Gruppe seit der letzten Benachrichtigung nicht geändert hat. Sie können sich diese als Erinnerung daran vorstellen, dass einige Benachrichtigungen immer noch ausgelöst werden. Das Wiederholungsintervall steht in engem Zusammenhang mit dem Gruppenintervall. Das bedeutet, dass Ihr Wiederholungsintervall nicht nur größer oder gleich dem Gruppenintervall sein muss, sondern auch ein Vielfaches des Gruppenintervalls sein muss. Wenn das Wiederholungsintervall kein Vielfaches des Gruppenintervalls ist, wird es zu Eins gezwungen. Wenn Ihr Gruppenintervall beispielsweise 5 Minuten und Ihr Wiederholungsintervall 9 Minuten beträgt, wird das Wiederholungsintervall auf das nächste Vielfache von 5 aufgerundet, das 10 Minuten ist.
**Die Standardeinstellung** ist 4 Stunden
# Warnung bei hoher Verfügbarkeit
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Amazon Managed Grafana ist für Hochverfügbarkeit konfiguriert, einschließlich der Ausführung mehrerer Instances in mehreren Availability Zones für jeden Workspace, den Sie erstellen.
Grafana Alerting verwendet das Prometheus-Modell, bei dem die Bewertung von Warnregeln von der Zustellung von Benachrichtigungen getrennt wird. In diesem Modell erfolgt die Auswertung der Warnungsregeln im Alert-Generator und die Zustellung von Benachrichtigungen im Alert-Empfänger. In Grafana Alerting ist der Alert-Generator der Scheduler und der Empfänger der Alertmanager.
Bei Hochverfügbarkeitskonfigurationen werden alle Alert-Regeln auf allen Instanzen ausgewertet. Sie können sich die Auswertung von Warnungsregeln als Duplikat vorstellen. Auf diese Weise stellt Grafana Alerting sicher, dass, solange mindestens eine Grafana-Instanz funktioniert, die Warnungsregeln weiterhin ausgewertet und Benachrichtigungen für Alerts weiterhin gesendet werden. Sie werden diese Duplikation in der Statushistorie sehen. Dies ist eine gute Methode, um festzustellen, ob Sie Hochverfügbarkeit verwenden.
# Alerting einrichten
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
**Voraussetzungen**
Bevor Sie Benachrichtigungen einrichten, müssen Sie die folgenden Schritte ausführen.
+ Konfigurieren Sie Ihre [Datenquellen](AMG-data-sources.md).
+ Stellen Sie sicher, dass die von Ihnen gewählte Datenquelle mit [Grafana-Benachrichtigungen](v10-alerting-overview-datasources.md) kompatibel ist und von diesen unterstützt wird.
**Um Benachrichtigungen einzurichten**
1. Konfigurieren Sie [Warnungsregeln](v10-alerting-configure.md).
+ Erstellen Sie von Grafana verwaltete oder von Datenquellen verwaltete Warn- und Aufzeichnungsregeln.
1. [Kontaktpunkte konfigurieren.](v10-alerting-configure-contactpoints.md)
+ Überprüfen Sie die Standardkontaktstelle und aktualisieren Sie den Kontakt für Ihr System.
+ Fügen Sie optional neue Kontaktstellen und Integrationen hinzu.
1. Konfigurieren Sie [Benachrichtigungsrichtlinien](v10-alerting-explore-notifications-policies-details.md)
+ Überprüfen Sie die Standard-Benachrichtigungsrichtlinie und aktualisieren Sie sie für Ihr System.
+ Fügen Sie optional weitere verschachtelte Richtlinien hinzu.
+ Fügen Sie optional Labels und Label-Matcher hinzu, um die Weiterleitung von Warnmeldungen zu steuern.
In den folgenden Themen finden Sie weitere Informationen zu zusätzlichen Konfigurationsoptionen, einschließlich der Konfiguration externer Warnungsmanager und der Weiterleitung von von Grafana verwalteten Warnungen außerhalb von Grafana.
**Topics**
+ [Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen](v10-alerting-use-grafana-alerts.md)
+ [Einen externen Alertmanager hinzufügen](v10-alerting-setup-alertmanager.md)
+ [Bereitstellung von Grafana-Alerting-Ressourcen](v10-alerting-setup-provision.md)
# Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. [Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md) Um zur neuen Grafana-Benachrichtigung zu wechseln, müssen Sie sich für die Funktion anmelden. Einzelheiten zu den Unterschieden zwischen klassischen Dashboard-Benachrichtigungen und Grafana-Benachrichtigungen finden Sie unter. [Grafana-Benachrichtigungen im Vergleich zu älteren Dashboard-Benachrichtigungen](#v10-alerting-diff-old-new) GrafanaLabs hat angekündigt, dass klassische Dashboard-Benachrichtigungen in Version 11 entfernt werden.
Wenn Sie klassische Dashboard-Benachrichtigungen verwenden, zeigt Ihnen Amazon Managed Grafana eine Vorschau von Grafana-Benachrichtigungen, in der Sie Ihre aktualisierten Benachrichtigungen überprüfen und ändern können, bevor Sie das Upgrade abschließen.
## Vorschau von Grafana-Benachrichtigungen
Sie können vor der Migration eine Vorschau Ihrer Benachrichtigungen in Grafana-Benachrichtigungen anzeigen. In der Vorschau können Sie Änderungen an den Benachrichtigungen vornehmen, die sich auf die Migration auswirken.
**Um eine Vorschau Ihrer Grafana-Alerting-Migration anzuzeigen**
1. Melden Sie sich in Ihrem Grafana-Workspace an.
1. Wählen Sie im linken Menü **Alerting (Legacy)**, um Ihre aktuellen Benachrichtigungen anzuzeigen.
1. Wählen Sie im linken Menü **Alerting Upgrade**, um Ihre Benachrichtigungen in Grafana-Benachrichtigungen anzuzeigen.
In dieser Ansicht können Sie sehen, wie Ihre Benachrichtigungen nach der Migration aussehen werden.
**Anmerkung**
In dieser Ansicht können Sie auch Änderungen vornehmen, die sich auf Ihre Migration auswirken. Um alle von Ihnen vorgenommenen Änderungen rückgängig zu machen, wählen Sie oben rechts auf der **Upgrade-Seite die Option Upgrade zurücksetzen**.
Wenn Sie bereit sind, Ihre Benachrichtigungen zu aktualisieren, lesen Sie den nächsten Abschnitt.
## Migration zum Grafana-Warnsystem
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)
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.
## Grafana-Benachrichtigungen im Vergleich zu älteren Dashboard-Benachrichtigungen
Grafana-Benachrichtigungen wurden in Grafana 8 eingeführt und bieten mehrere Verbesserungen gegenüber älteren Dashboard-Benachrichtigungen.
### Mehrdimensionale Warnmeldungen
Sie können jetzt mit einer einzigen Warnregel Warnmeldungen erstellen, die Ihnen systemweite Transparenz bieten. Generieren Sie mehrere Warnungsinstanzen anhand einer einzigen Warnungsregel. Sie können beispielsweise eine Regel erstellen, um die Festplattennutzung mehrerer Mountpoints auf einem einzelnen Host zu überwachen. Die Evaluierungs-Engine gibt mehrere Zeitreihen aus einer einzigen Abfrage zurück, wobei jede Zeitreihe durch ihren Labelsatz identifiziert wird.
### Erstellen Sie Benachrichtigungen außerhalb von Dashboards
Im Gegensatz zu älteren Dashboard-Benachrichtigungen können Sie mit Grafana-Benachrichtigungen Abfragen und Ausdrücke erstellen, die Daten aus mehreren Quellen auf einzigartige Weise kombinieren. Sie können Dashboards und Panels weiterhin anhand ihrer ID mit Warnregeln verknüpfen und so schnell Fehler im beobachteten System beheben.
Da einheitliche Benachrichtigungen nicht mehr direkt mit Panel-Abfragen verknüpft sind, enthalten sie keine Bilder oder Abfragewerte in der Benachrichtigungs-E-Mail. Sie können benutzerdefinierte Benachrichtigungsvorlagen verwenden, um Abfragewerte anzuzeigen.
### Erstellen Sie Alarmregeln für Loki und Grafana Mimir
In Grafana Alerting können Sie die Alarmregeln von Loki und Grafana Mimir mithilfe derselben Benutzeroberfläche und API wie Ihre von Grafana verwalteten Benachrichtigungen verwalten.
### Benachrichtigungen aus Prometheus-kompatiblen Datenquellen anzeigen und danach suchen
Benachrichtigungen für Prometheus-kompatible Datenquellen sind jetzt im Abschnitt Grafana-Benachrichtigungen aufgeführt. Sie können in mehreren Datenquellen nach Labels suchen, um schnell relevante Benachrichtigungen zu finden.
### Spezielle Benachrichtigungen für Alarmstatus NoData und Fehler
Grafana Alerting führte ein neues Konzept der Alarmzustände ein. Wenn die Auswertung einer Warnregel den Status NoData oder Fehler ergibt, generiert Grafana Alerting spezielle Warnungen mit den folgenden Bezeichnungen:
+ `alertname`mit Wert DatasourceNoData oder DatasourceError abhängig vom Status.
+ `rulename`Name der Warnungsregel, zu der die spezielle Warnung gehört.
+ `datasource_uid`wird die UID der Datenquelle haben, die den Status verursacht hat.
+ Alle Bezeichnungen und Anmerkungen der ursprünglichen Warnungsregel
Sie können diese Benachrichtigungen genauso behandeln wie normale Benachrichtigungen, indem Sie eine Stille, eine Route zu einem Kontaktpunkt usw. hinzufügen.
**Anmerkung**
Wenn die Regel viele Datenquellen verwendet und eine oder mehrere keine Daten zurückgeben, wird die spezielle Warnung für jede Datenquelle erstellt, die den Warnstatus verursacht hat.
# Einen externen Alertmanager hinzufügen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
**Anmerkung**
Sie können Amazon Managed Service for Prometheus nicht als externen Alertmanager verwenden.
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.
Externe Alertmanager werden mithilfe der Grafana-Konfiguration im Grafana-Hauptnavigationsmenü als Datenquellen konfiguriert. 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.
**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.
**Um einen externen Alertmanager hinzuzufügen**
1. Wählen Sie im linken Hauptmenü **Verbindungen** aus.
1. Suchen Sie nach `Alertmanager`.
1. Wählen Sie die Schaltfläche **Neue Datenquelle erstellen**.
1. 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. **Wählen Sie** Speichern und testen.
# Bereitstellung von Grafana-Alerting-Ressourcen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-setup-provision-terraform.md)
+ [Bereitgestellte Alert-Ressourcen in Grafana anzeigen](v10-alerting-setup-provision-view.md)
# Erstellen und verwalten Sie Warnressourcen mit Terraform
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 das Programm 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 für die 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 ihn ** durch deine Slack-Webhook-URL (oder andere Kontaktpunktdetails).
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 Alert-Stack 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 Alert-Stack 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](v10-alerting-configure.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, in dem Sie Ihre Regeln speichern möchten.
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 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
# Warnmeldungen konfigurieren
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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**
+ [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Konfigurieren von mit Datenquellen verwalteten Warnungsregeln](v10-alerting-configure-datasourcemanaged.md)
+ [Aufzeichnungsregeln konfigurieren](v10-alerting-configure-recordingrules.md)
+ [Kontaktpunkte konfigurieren](v10-alerting-configure-contactpoints.md)
+ [Benachrichtigungsrichtlinien konfigurieren](v10-alerting-configure-notification-policies.md)
# Konfigurieren Sie die verwalteten Warnungsregeln von Grafana
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Regeln sind der flexibelste Warnregeltyp. Sie ermöglichen es Ihnen, Warnmeldungen zu erstellen, die auf Daten aus allen von uns unterstützten Datenquellen reagieren können. Neben der Unterstützung mehrerer Datenquellen können Sie auch Ausdrücke hinzufügen, um Ihre Daten zu transformieren und Warnbedingungen festzulegen. Die Verwendung von Bildern in Warnmeldungen wird ebenfalls unterstützt. Dies ist der einzige Regeltyp, der Warnmeldungen aus mehreren Datenquellen in einer einzigen Regeldefinition ermöglicht.
Als Ergebnis einer Warnungsregel (auch bekannt als multidimensionale Warnung) können mehrere Warnungsinstanzen erstellt werden.
Von Grafana verwaltete Warnungsregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind.
Wenn Sie eine in der Benutzeroberfläche erstellte Warnressource löschen, können Sie sie nicht mehr abrufen. Um eine Sicherungskopie Ihrer Konfiguration zu erstellen und gelöschte Alert-Ressourcen wiederherstellen zu können, erstellen Sie Ihre Alert-Ressourcen mit Terraform oder der Alerting API.
In den folgenden Verfahren gehen wir den Prozess der Erstellung Ihrer von Grafana verwalteten Warnregeln durch.
Um eine von Grafana verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Benachrichtigungen im Arbeitsbereich und folgen Sie diesen Schritten, um Ihnen zu helfen.
**Geben Sie den Namen der Warnungsregel**
1. Wählen Sie **Warnung** -> **Warnungsregeln** -> **\$1 Neue Warnungsregel**.
1. Geben Sie einen Namen ein, um Ihre Warnungsregel zu identifizieren.
Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.
Definieren Sie als Nächstes eine Abfrage, um die Daten abzurufen, die Sie messen möchten, sowie eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.
**Um die Abfrage und die Bedingung zu definieren**
1. Wählen Sie eine Datenquelle aus.
1. Geben Sie in der Dropdownliste **Optionen** einen [Zeitraum an](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Anmerkung**
Grafana Alerting unterstützt beispielsweise nur feste relative Zeitbereiche. `now-24hr: now`
Absolute Zeitbereiche: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` oder halbrelative Zeitbereiche: werden nicht unterstützt. `now/d to: now`
1. Fügen Sie eine Abfrage hinzu.
Um mehrere [Abfragen](v10-panels-query-xform.md#v10-panels-query-xform-add) hinzuzufügen, wählen Sie **Abfrage hinzufügen**.
Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Wenn Sie zu einer von einer Datenquelle verwalteten Warnungsregel wechseln möchten, klicken Sie auf Zu einer von einer **Datenquelle verwalteten Warnungsregel wechseln**.
1. [Fügen Sie einen oder mehrere Ausdrücke hinzu.](v10-panels-query-xform-expressions.md)
1. **Wählen Sie für jeden Ausdruck entweder **klassische Bedingung** aus, um eine einzelne Warnungsregel zu erstellen, oder wählen Sie aus den Optionen **Math**, **Reduce und Resample**, um für jede Serie eine separate Warnung zu generieren.**
**Anmerkung**
Wenn Sie Prometheus verwenden, können Sie einen Instant-Vektor und integrierte Funktionen verwenden, sodass Sie keine zusätzlichen Ausdrücke hinzufügen müssen.
1. Wählen Sie **Vorschau**, um zu überprüfen, ob der Ausdruck erfolgreich ist.
1. [Optional] Um einen Wiederherstellungsschwellenwert hinzuzufügen, aktivieren Sie die Option **Benutzerdefinierter Wiederherstellungsschwellenwert** und geben Sie einen Wert ein, ab dem Ihre Warnungsregel nicht mehr ausgelöst werden soll.
Sie können einer Abfrage nur einen Wiederherstellungsschwellenwert hinzufügen, und dieser muss die Warnbedingung sein.
1. Wählen Sie **In der Abfrage oder dem Ausdruck, den Sie als Warnbedingung** festlegen möchten, die Option Als Warnbedingung festlegen aus.
Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden sollte und wie schnell sie ihren Status ändern sollte.
Dazu müssen Sie sicherstellen, dass sich Ihre Warnungsregel in der richtigen Bewertungsgruppe befindet, und einen Wartezeitraum festlegen, der für Ihren Anwendungsfall am besten geeignet ist.
**So legen Sie das Verhalten bei der Auswertung von Warnungen fest**
1. Wählen Sie einen Ordner aus oder wählen Sie **\$1 Neuer Ordner**.
1. Wählen Sie eine Bewertungsgruppe aus oder klicken Sie auf **\$1 Neue Bewertungsgruppe**.
Wenn Sie eine neue Bewertungsgruppe erstellen, geben Sie das Intervall für die Gruppe an.
Alle Regeln innerhalb derselben Gruppe werden gleichzeitig über dasselbe Zeitintervall ausgewertet.
1. Geben Sie einen ausstehenden Zeitraum ein.
Der Wartezeitraum ist der Zeitraum, in dem eine Warnungsregel die Bedingung verletzen kann, bis sie ausgelöst wird.
Sobald eine Bedingung erfüllt ist, geht die Warnung in den Status **Ausstehend** über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den Status **Auslösung**, andernfalls kehrt sie in den Status **Normal** zurück.
1. Aktivieren Sie bei Bedarf die Benachrichtigungen mit Pausenwarnungen.
**Anmerkung**
Unterbrechen Sie die Auswertung der Warnungsregeln, um bei der Optimierung Ihrer Benachrichtigungen zu laute Warnmeldungen zu vermeiden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.
Sie können die Auswertung von Warnungsregeln pausieren, um zu verhindern, dass bei der Optimierung Ihrer Warnmeldungen laute Warnmeldungen ausgegeben werden. Durch das Anhalten wird die Auswertung der Warnungsregeln beendet und es werden keine Warnungsinstanzen erstellt. Dies unterscheidet sich von den Zeiten der Stummschaltung, die zwar verhindern, dass Benachrichtigungen zugestellt werden, aber dennoch die Auswertung von Warnungsregeln und die Erstellung von Warnungsinstanzen ermöglichen.
1. **Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung** das Warnverhalten bei fehlenden Daten.
Beachten Sie die Richtlinien weiter unten in diesem Abschnitt.
Fügen Sie Ihren Warnungsregeln Labels hinzu, um festzulegen, welche Benachrichtigungsrichtlinie Ihre Auslösewarnungen behandeln soll.
Alle Warnungsregeln und -instanzen, unabhängig von ihren Bezeichnungen, entsprechen der Standardbenachrichtigungsrichtlinie. Wenn es keine verschachtelten Richtlinien gibt oder keine verschachtelten Richtlinien den Bezeichnungen in der Warnungsregel oder Warnungsinstanz entsprechen, ist die Standardbenachrichtigungsrichtlinie die entsprechende Richtlinie.
**So konfigurieren Sie Benachrichtigungen**
1. Fügen Sie Labels hinzu, wenn Sie die Art und Weise ändern möchten, wie Ihre Benachrichtigungen weitergeleitet werden.
Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.
1. Zeigen Sie eine Vorschau Ihrer Einrichtung für das Routing Ihrer Alert-Instanz an.
Basierend auf den hinzugefügten Labels werden Warnungsinstanzen an die angezeigten Benachrichtigungsrichtlinien weitergeleitet.
Erweitern Sie jede Benachrichtigungsrichtlinie, um weitere Details anzuzeigen.
1. Wählen Sie **Details anzeigen, um Details** zur Weiterleitung von Benachrichtigungen und eine Vorschau anzuzeigen.
Fügen Sie [Anmerkungen](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) hinzu, um mehr Kontext zu der Warnung in Ihrer Warnmeldung bereitzustellen.
Anmerkungen fügen Metadaten hinzu, um weitere Informationen zur Warnung in Ihrer Warnmeldung bereitzustellen. Fügen Sie beispielsweise eine Anmerkung mit einer **Zusammenfassung** hinzu, um zu erfahren, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie aufgetreten ist.
**Um Anmerkungen hinzuzufügen**
1. [Optional] Fügen Sie eine Zusammenfassung hinzu.
Kurze Zusammenfassung dessen, was passiert ist und warum.
1. [Optional] Fügen Sie eine Beschreibung hinzu.
Beschreibung der Funktion der Warnungsregel.
1. [Optional] Fügen Sie eine Runbook-URL hinzu.
Webseite, auf der Sie Ihr Runbook für die Warnung aufbewahren
1. [Optional] Fügen Sie eine benutzerdefinierte Anmerkung hinzu
1. [Optional] Fügen Sie ein Dashboard und einen Panel-Link hinzu.
Verknüpft Benachrichtigungen mit Bedienfeldern in einem Dashboard.
1. Wählen Sie **Save rule** (Regel speichern).
**Ein- und mehrdimensionale Regel**
Für von Grafana verwaltete Benachrichtigungen können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen.
+ **Regel mit klassischer Bedingung**
Verwenden Sie den klassischen Bedingungsausdruck, um eine Regel zu erstellen, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Bei einer Abfrage, die mehrere Serien zurückgibt, verfolgt Grafana nicht den Alarmstatus jeder Serie. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind.
+ **Mehrdimensionale Regel**
Um für jede Serie eine separate Warnung zu generieren, erstellen Sie eine mehrdimensionale Regel. Verwenden Sie `Resample` Ausdrücke `Math``Reduce`, oder, um eine mehrdimensionale Regel zu erstellen. Beispiel:
+ 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](v10-alerting-overview-numeric.md)).
+ Fügen Sie einen `Math` Ausdruck mit der Bedingung für die Regel hinzu. Nicht erforderlich, falls eine Abfrage oder ein Reduce-Ausdruck bereits zurückgibt, `0` ob die Regel nicht ausgelöst werden soll, oder eine positive Zahl, wenn sie ausgelöst werden soll. Einige Beispiele: `$B > 70` ob es ausgelöst werden soll, falls der Wert von B größer als 70 query/expression ist. `$B < $C * 100`falls es ausgelöst werden sollte, wenn der Wert von B kleiner als der Wert von C multipliziert mit 100 ist. Wenn die Ergebnisse von Abfragen, die verglichen werden, mehrere Reihen enthalten, werden Reihen aus verschiedenen Abfragen abgeglichen, wenn sie dieselben Beschriftungen haben oder eine eine Teilmenge der anderen ist.
**Anmerkung**
Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden Sie unter [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert
**Konfigurieren Sie keine Daten und Fehlerbehandlung**
Konfigurieren Sie das Warnverhalten, wenn Ihre Warnungsregelauswertung keine Daten oder einen Fehler zurückgibt.
**Anmerkung**
Warnungsregeln, die so konfiguriert sind, dass sie ausgelöst werden, wenn eine Auswertung keine Daten oder einen Fehler zurückgibt, werden nur ausgelöst, wenn der gesamte Evaluierungszeitraum abgelaufen ist. Das bedeutet, dass die Warnungsregel nicht sofort ausgelöst wird, wenn die Bedingung der Warnungsregel verletzt wird, sondern wartet, bis die für das Feld **Für** festgelegte Zeit abgelaufen ist, und wird dann ausgelöst, wodurch Warngeräusche reduziert werden und vorübergehende Probleme mit der Datenverfügbarkeit möglich sind.
Wenn bei der Auswertung der Warnungsregel keine Daten zurückgegeben werden, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:
| Keine Daten | Description |
| --- | --- |
| Keine Daten | Erstellt eine neue Warnung DatasourceNoData mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. |
| Warnfunktion | Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird. |
| OK | Setzt den Status der Warnungsregel aufNormal. |
Wenn Ihre Auswertung einen Fehler ergibt, können Sie den Status Ihrer Warnungsregel so einstellen, dass er wie folgt aussieht:
| Fehler | Description |
| --- | --- |
| Fehler | Erstellt eine Warnungsinstanz DatasourceError mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. |
| Warnfunktion | Setzt den Status der Warnungsregel auf. Alerting Die Warnungsregel wartet, bis die im Feld Für festgelegte Zeit abgelaufen ist, bevor sie ausgelöst wird. |
| OK | Setzt den Status der Warnungsregel aufNormal. |
**Löst veraltete Warnungsinstanzen auf**
Eine Warnungsinstanz gilt als veraltet, wenn ihre Dimension oder Serie für zwei Bewertungsintervalle vollständig aus den Abfrageergebnissen verschwunden ist.
Veraltete Warnungsinstanzen im Status`Alerting`/`NoData`/`Error`werden automatisch als markiert, `Resolved` und die `grafana_state_reason` Anmerkung wird der Warnungsinstanz mit dem Grund hinzugefügt. `MissingSeries`
**Erstellen Sie Warnmeldungen aus Panels**
Erstellen Sie Benachrichtigungen aus einem beliebigen Panel-Typ. Das bedeutet, dass Sie die Abfragen im Panel wiederverwenden und darauf basierende Benachrichtigungen erstellen können.
1. Navigieren Sie im Bereich **Dashboards** zu einem Dashboard.
1. Wählen Sie in der oberen rechten Ecke des Panels die drei Punkte (Ellipsen) aus.
1. Wählen Sie im Dropdownmenü die Option **Mehr...** und wählen Sie dann **Neue Warnungsregel** aus.
Dadurch wird das Formular für Warnungsregeln geöffnet, in dem Sie Ihre Warnung auf der Grundlage der Abfrage des aktuellen Panels konfigurieren und erstellen können.
# Konfigurieren von mit Datenquellen verwalteten Warnungsregeln
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Warnregeln für eine externe Instanz von Grafana Mimir oder Loki, für die die Lineal-API aktiviert ist. Diese werden als datenquellenverwaltete Warnregeln bezeichnet.
**Anmerkung**
Warnungsregeln für eine externe Grafana Mimir- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden.
Wenn Sie eine in der Benutzeroberfläche erstellte Warnressource löschen, können Sie sie nicht mehr abrufen. Um eine Sicherungskopie Ihrer Konfiguration zu erstellen und gelöschte Alert-Ressourcen wiederherstellen zu können, erstellen Sie Ihre Alert-Ressourcen mit Terraform oder der Alerting API.
**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus- oder Loki-Datenquelle haben. Andernfalls können Sie keine verwalteten Alarmregeln von Grafana Mimir erstellen oder aktualisieren.
+ Aktivieren Sie für Grafana Mimir- und Loki-Datenquellen 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 Regelspeichertypen.
+ **Grafana Mimir** - benutze das `/prometheus` Präfix. Die Prometheus-Datenquelle unterstützt sowohl Grafana Mimir als auch Prometheus, und Grafana geht davon aus, dass sich sowohl die [Query-API als auch die Ruler-API unter derselben](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) URL befinden[.](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#ruler) 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-Benutzeroberfläche verwalten**.
In den folgenden Verfahren führen wir Sie durch den Prozess der Erstellung Ihrer durch eine Datenquelle verwalteten Warnregeln.
Um eine von einer Datenquelle verwaltete Warnungsregel zu erstellen, verwenden Sie den Ablauf zur Erstellung von Warnungen im Workspace und befolgen Sie die folgenden Schritte, um Ihnen zu helfen.
**So legen Sie den Namen der Warnungsregel fest**
1. Wählen Sie **Warnung** -> **Warnungsregeln** -> **\$1 Neue Warnungsregel**.
1. Geben Sie einen Namen ein, um Ihre Warnungsregel zu identifizieren.
Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird.
Definieren Sie eine Abfrage, um die Daten abzurufen, die Sie messen möchten, sowie eine Bedingung, die erfüllt sein muss, bevor eine Warnungsregel ausgelöst wird.
**Um eine Abfrage und eine Bedingung zu definieren**
1. Alle Alarmregeln werden standardmäßig von Grafana verwaltet. Um zu einer von einer Datenquelle verwalteten Warnregel zu **wechseln, wählen Sie Zu einer von einer Datenquelle verwalteten Warnungsregel** wechseln.
1. Wählen Sie eine Datenquelle aus der Dropdownliste aus.
Sie können auch „**Erweiterte Datenquellenauswahl öffnen**“ wählen, um weitere Optionen zu sehen, darunter das Hinzufügen einer Datenquelle (nur für Administratoren).
1. Geben Sie eine PromQL- oder LogQL-Abfrage ein.
1. **Wählen Sie Warnmeldungen in der Vorschau aus.**
Verwenden Sie die Auswertung von Warnungsregeln, um zu bestimmen, wie oft eine Warnungsregel ausgewertet werden soll und wie schnell sie ihren Status ändern sollte.
**So legen Sie das Verhalten bei der Auswertung von Warnungen fest**
1. Wählen Sie einen Namespace aus oder wählen Sie **\$1 Neuer Namespace**.
1. Wählen Sie eine Bewertungsgruppe aus oder wählen Sie **\$1 Neue Bewertungsgruppe**.
Wenn Sie eine neue Bewertungsgruppe erstellen, geben Sie das Intervall für die Gruppe an.
Alle Regeln innerhalb derselben Gruppe werden nacheinander über dasselbe Zeitintervall ausgewertet.
1. Geben Sie einen ausstehenden Zeitraum ein.
Der Wartezeitraum ist der Zeitraum, in dem eine Warnungsregel gegen die Bedingung verstoßen kann, bis sie ausgelöst wird.
Sobald eine Bedingung erfüllt ist, geht die Warnung in den `Pending` Status über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den `Firing` Status, andernfalls kehrt sie in den `Normal` Status zurück.
Fügen Sie Ihren Warnungsregeln Labels hinzu, um festzulegen, welche Benachrichtigungsrichtlinie Ihre Auslösewarnungen behandeln soll.
Alle Warnungsregeln und -instanzen, unabhängig von ihren Bezeichnungen, entsprechen der Standardbenachrichtigungsrichtlinie. Wenn es keine verschachtelten Richtlinien gibt oder keine verschachtelten Richtlinien den Bezeichnungen in der Warnungsregel oder Warnungsinstanz entsprechen, ist die Standardbenachrichtigungsrichtlinie die entsprechende Richtlinie.
**Konfigurieren von -Benachrichtigungen**
+ Fügen Sie Labels hinzu, wenn Sie die Art und Weise ändern möchten, wie Ihre Benachrichtigungen weitergeleitet werden.
Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.
Fügen Sie [Anmerkungen](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) hinzu, um in Ihren Warnmeldungen mehr Kontext zur Warnung bereitzustellen.
Anmerkungen fügen Metadaten hinzu, um mehr Informationen zur Warnung in Ihren Warnmeldungen bereitzustellen. Fügen Sie beispielsweise eine `Summary` Anmerkung hinzu, die Ihnen mitteilt, durch welchen Wert die Warnung ausgelöst wurde oder auf welchem Server sie ausgelöst wurde.
**Um Anmerkungen hinzuzufügen**
1. [Optional] Fügen Sie eine Zusammenfassung hinzu.
Kurze Zusammenfassung dessen, was passiert ist und warum.
1. [Optional] Fügen Sie eine Beschreibung hinzu.
Beschreibung der Funktion der Warnungsregel.
1. [Optional] Fügen Sie eine Runbook-URL hinzu.
Webseite, auf der Sie Ihr Runbook für die Warnung aufbewahren
1. [Optional] Fügen Sie eine benutzerdefinierte Anmerkung hinzu
1. [Optional] Fügen Sie ein Dashboard und einen Panel-Link hinzu.
Verknüpft Benachrichtigungen mit Bedienfeldern in einem Dashboard.
1. Wählen Sie **Save rule** (Regel speichern).
# Aufzeichnungsregeln konfigurieren
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
**Anmerkung**
Aufzeichnungsregeln werden als Instanzregeln ausgeführt und alle 10 Sekunden ausgeführt.
**Voraussetzungen**
+ Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus- oder Loki-Datenquelle haben. Sie werden Warnregeln in Ihrer Datenquelle 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 `/prometheus` Präfix. 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**.
**Um Aufzeichnungsregeln zu erstellen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü **Alerting, Alert-Regeln aus**.**
1. Wählen Sie **Neue Aufzeichnungsregel**.
1. Legen Sie den Namen der Regel fest.
Der Name der Aufzeichnungsregel muss ein Prometheus-Metrikname sein und darf keine Leerzeichen enthalten.
1. Abfrage definieren
+ Wählen Sie Ihre Loki- oder Prometheus-Datenquelle aus.
+ Geben Sie eine Abfrage ein.
1. Fügen Sie Namespace und Gruppe hinzu.
+ Wählen Sie in der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus oder fügen Sie einen neuen hinzu. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck.
+ Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus oder fügen Sie eine neue hinzu. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden nacheinander in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt.
1. Fügen Sie Beschriftungen hinzu.
+ Fügen Sie benutzerdefinierte Labels hinzu, indem Sie vorhandene Schlüssel-Wert-Paare aus der Drop-down-Liste auswählen, oder fügen Sie neue Labels hinzu, indem Sie den neuen Schlüssel oder Wert eingeben.
1. Wählen Sie **Regel speichern**, um die Regel zu speichern, oder **Regel speichern und beenden**, um die Regel zu speichern und zur Warnseite zurückzukehren.
# Kontaktpunkte konfigurieren
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
**Anmerkung**
Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktstellen für von Datenquellen verwaltete Benachrichtigungen sind schreibgeschützt.
## Mit Kontaktpunkten arbeiten
Die folgenden Verfahren zeigen, wie Sie eine Kontaktstelle hinzufügen, bearbeiten, löschen und testen.
**So fügen Sie einen Kontaktpunkt hinzu**
1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.
1. Wählen Sie **Kontaktstellen**.
1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt.
1. Wählen Sie auf der Registerkarte **Kontaktstellen** die Option **\$1 Kontaktstelle hinzufügen**.
1. Geben Sie einen **Namen** für die Kontaktstelle ein.
1. Wählen Sie unter **Integration** einen Typ aus und füllen Sie die Pflichtfelder auf der Grundlage dieses Typs 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. Um eine weitere Kontaktpunktintegration hinzuzufügen, wählen Sie **Kontaktpunktintegration hinzufügen** aus und wiederholen Sie die Schritte für jeden benötigten Kontaktpunkttyp.
1. Speichern Sie Ihre Änderungen.
**Um eine Kontaktstelle zu bearbeiten**
1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.
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 **Bearbeiten**.
1. Aktualisieren Sie die Kontaktstelle und speichern Sie dann Ihre Änderungen.
Sie können Kontaktpunkte löschen, die aufgrund einer Benachrichtigungsrichtlinie nicht verwendet werden.
**Um eine Kontaktstelle zu löschen**
1. Wählen Sie im Menü auf der linken Seite **Alerting**.
1. Wählen Sie **Kontaktstellen, um die Liste der vorhandenen Kontaktstellen** zu öffnen.
1. Wählen Sie unter **Kontaktstellen die Kontaktstelle** aus, die Sie löschen möchten, und wählen Sie dann **Mehr**, **Löschen** aus.
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.
Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie richtig konfiguriert ist.
**Um eine Testbenachrichtigung zu senden**
1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.
1. Wählen Sie **Kontaktstellen, um die Liste der vorhandenen Kontaktstellen** zu öffnen.
1. Wählen Sie unter **Kontaktstellen die Kontaktstelle** aus, die Sie testen möchten, und klicken Sie dann auf **Bearbeiten**. Bei Bedarf können Sie auch eine neue Kontaktstelle erstellen.
1. Wählen Sie **Test**, um den Dialog zum Testen der Kontaktstelle zu öffnen.
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.
## Konfigurieren Sie Kontaktpunkt-Integrationen
Konfigurieren Sie Kontaktpunktintegrationen in Grafana, um Ihren bevorzugten Kommunikationskanal für den Empfang von Benachrichtigungen auszuwählen, wenn Ihre Alarmregeln ausgelöst werden. Jede Integration hat ihre eigenen Konfigurationsoptionen und ihren eigenen Einrichtungsprozess. In den meisten Fällen beinhaltet dies die Bereitstellung eines API-Schlüssels oder einer Webhook-URL.
Nach der Konfiguration können Sie Integrationen als Teil Ihrer Kontaktstellen verwenden, um Benachrichtigungen zu erhalten, wenn sich der Status Ihrer Warnung ändert. In diesem Abschnitt behandeln wir anhand PagerDuty eines Beispiels die grundlegenden Schritte zur Konfiguration einer Integration, sodass Sie sofort Benachrichtigungen in Echtzeit erhalten und den Überblick über Ihre Überwachungsdaten behalten können.
**Liste der unterstützten Integrationen**
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` |
**Konfiguration PagerDuty für Warnmeldungen**
Für die Einrichtung PagerDuty müssen Sie einen Integrationsschlüssel angeben. Geben Sie die folgenden Details an.
| Einstellung | Description |
| --- | --- |
| Integrationsschlüssel | Integrationsschlüssel für PagerDuty |
| Schweregrad | Stufe für dynamische Benachrichtigungen. Der Standardwert ist critical. |
| Benutzerdefinierte Details | Zusätzliche Informationen zur Veranstaltung |
Das `CustomDetails` Feld ist ein Objekt, das beliebige Schlüssel-Wert-Paare enthält. Die benutzerdefinierten Details werden mit den standardmäßig verwendeten zusammengeführt.
Die Standardwerte für `CustomDetails` sind:
```
{
"firing": `{{ template "__text_alert_list" .Alerts.Firing }}`,
"resolved": `{{ template "__text_alert_list" .Alerts.Resolved }}`,
"num_firing": `{{ .Alerts.Firing | len }}`,
"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```
Im Fall von doppelten Schlüsseln überschreiben die benutzerdefinierten Details die Standarddaten.
# Benachrichtigungsrichtlinien konfigurieren
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Benachrichtigungen an Kontaktstellen weitergeleitet werden.
Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere verschachtelte Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Standardrichtlinie, kann auch bestimmten Warnbezeichnungen entsprechen.
Jede Warnung wird anhand der Standardrichtlinie und anschließend anhand der einzelnen verschachtelten Richtlinien bewertet.
Wenn Sie die `Continue matching subsequent sibling nodes` Option für eine verschachtelte 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 Standardrichtlinie regelt jede Warnung, die keiner verschachtelten Richtlinie entspricht.
Weitere Informationen zu Benachrichtigungsrichtlinien finden Sie unter. [Benachrichtigungen](v10-alerting-explore-notifications.md)
Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten.
**Um die Standard-Benachrichtigungsrichtlinie zu bearbeiten**
1. Wählen Sie im Menü auf der linken Seite **Alerting aus**.
1. Wählen Sie **Benachrichtigungsrichtlinien** aus.
1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ den Alertmanager aus, den Sie bearbeiten möchten.
1. **Wählen Sie im Abschnitt **Standardrichtlinie...**** , **Bearbeiten**.
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 aus, nach denen Benachrichtigungen gruppiert werden sollen. Wenn mehrere Warnungen für diese Richtlinie übereinstimmen, werden sie nach diesen Labels gruppiert. Pro Gruppe wird eine Benachrichtigung gesendet. Wenn das Feld leer ist (Standardeinstellung), werden alle Benachrichtigungen in einer einzigen Gruppe gesendet. Verwenden Sie ein spezielles Label, `...` um Benachrichtigungen nach allen Labels zu gruppieren (wodurch die Gruppierung effektiv deaktiviert wird).
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 Benachrichtigungsrichtlinie zu erstellen, müssen Sie ihrer Baumstruktur folgen. Neue Richtlinien, die am Stamm des Baums erstellt werden (die Standardrichtlinie), sind die Baumzweige. Jeder Zweig kann seine eigenen verschachtelten Richtlinien haben. Aus diesem Grund fügen Sie immer eine neue **verschachtelte** Richtlinie hinzu, entweder unter der Standardrichtlinie oder unter einer bereits verschachtelten Richtlinie.
**Um eine neue verschachtelte Richtlinie hinzuzufügen**
1. **Wählen Sie im Menü auf der linken Seite Alerting aus.**
1. Wählen Sie **Benachrichtigungsrichtlinien** aus.
1. **Wählen Sie im Drop-down-Menü „Alertmanager** auswählen“ den Alertmanager aus, den Sie bearbeiten möchten.
1. **Um eine spezifische Richtlinie der obersten Ebene hinzuzufügen, wechseln Sie zum Abschnitt Spezifisches Routing (entweder zur Standardrichtlinie oder zu einer anderen vorhandenen Richtlinie, zu der Sie eine neue verschachtelte Richtlinie hinzufügen möchten) und wählen Sie \$1 Neue verschachtelte Richtlinie aus.**
1. Fügen Sie im Abschnitt „Übereinstimmende Labels“ eine oder mehrere Regeln für übereinstimmende Warnungsbezeichnungen hinzu.
1. Wählen Sie in der Dropdownliste **Kontaktstelle** die Kontaktstelle aus, an die Benachrichtigungen gesendet werden sollen, wenn eine Warnung nur dieser bestimmten Richtlinie entspricht und keiner der verschachtelten Richtlinien.
1. Aktivieren Sie optional die Option Mit dem **Abgleich aufeinanderfolgender gleichgeordneter Knoten** fortfahren, um den Abgleich von gleichgeordneten Richtlinien auch dann fortzusetzen, wenn die Warnung mit der aktuellen Richtlinie übereinstimmt. Wenn diese Option aktiviert ist, können Sie mehr als eine Benachrichtigung für eine Warnung erhalten.
1. Aktivieren Sie optional **Gruppierung überschreiben**, um dieselbe Gruppierung wie in der Standardrichtlinie anzugeben. Wenn die Option nicht aktiviert ist, wird die Standardrichtliniengruppierung verwendet.
1. Aktivieren Sie optional die Option **Allgemeine Zeitangaben überschreiben, um** die in der Gruppenbenachrichtigungsrichtlinie konfigurierten Zeitoptionen außer Kraft zu setzen.
1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern.
**Um eine verschachtelte Richtlinie zu bearbeiten**
1. **Wählen Sie im Menü auf der linken Seite Alerting aus.**
1. Wählen Sie **Benachrichtigungsrichtlinien** aus.
1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und wählen Sie dann**...** , **Bearbeiten**.
1. Nehmen Sie alle Änderungen vor (wie beim Hinzufügen einer verschachtelten Richtlinie).
1. Speichern Sie Ihre Änderungen.
**Nach Richtlinien suchen**
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. Die Richtlinien, die diese Kontaktstelle verwenden, werden auf der Benutzeroberfläche hervorgehoben.
+ Um nach Label zu suchen, geben Sie einen gültigen Label-Matcher in das Eingabefeld **Search by Matchers** 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.
# Verwalte deine Benachrichtigungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sobald Sie Ihre Alarmregeln, Kontaktstellen und Benachrichtigungsrichtlinien eingerichtet haben, können Sie Grafana-Benachrichtigungen verwenden, um Ihre Benachrichtigungen in der Praxis zu verwalten.
**Topics**
+ [Benachrichtigungen anpassen](v10-alerting-manage-notifications.md)
+ [Kontaktstellen verwalten](v10-alerting-manage-contactpoints.md)
+ [Warnmeldungen stummschalten](v10-alerting-silences.md)
+ [Warnungsregeln anzeigen und filtern](v10-alerting-manage-rules-viewfilter.md)
+ [Timings stummschalten](v10-alerting-manage-muting.md)
+ [Status und Zustand der Warnungsregeln anzeigen](v10-alerting-manage-rulestate.md)
+ [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v10-alerting-manage-viewfiltergroups.md)
+ [Benachrichtigungsfehler anzeigen](v10-alerting-manage-viewnotificationerrors.md)
# Benachrichtigungen anpassen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Amazon SNS 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](v10-alerting-notifications-go-templating.md)
+ [Vorlagen für Benachrichtigungen erstellen](v10-alerting-create-templates.md)
+ [Verwenden von Benachrichtigungsvorlagen](#v10-alerting-use-notification-templates)
+ [Vorlage – Referenz](v10-alerting-template-reference.md)
# Verwendung der Template-Sprache von Go
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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](v10-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v10-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](#v10-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben:
```
{{ .Alerts }}
```
## Wiederholt die 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 sich auf die aktuelle Bezeichnung bezieht. `.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 }}
```
## Die Index-Funktionen
Verwenden Sie die `index` Funktion, um eine bestimmte Anmerkung oder ein bestimmtes Etikett zu drucken.
```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ 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, sodass 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 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, kann Grafana beide Vorlagen verwenden. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt.
```
{{ define "print_labels" }}
{{ end }}
```
## Vorlagen ausführen
Sie können eine definierte Vorlage innerhalb Ihrer Vorlage ausführen`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor verwenden, der an die Vorlage übergeben werden soll:
```
{{ 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 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.
1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage 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. Speichern Sie Ihre Änderungen.
`{{ 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. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.
1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage 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 späteren Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie möglicherweise erstellen.
1. Klicken Sie auf Speichern.
## Eine Vorschau der Benachrichtigungsvorlagen anzeigen
Sehen Sie sich eine Vorschau Ihrer Benachrichtigungsvorlagen an, bevor Sie sie in Ihren Kontaktstellen verwenden. Dies hilft Ihnen, das Ergebnis der von Ihnen erstellten Vorlage zu verstehen, und gibt Ihnen die Möglichkeit, etwaige Fehler zu beheben, bevor Sie die Vorlage speichern.
**Anmerkung**
Benachrichtigungsvorschauen sind nur für Grafana Alertmanager verfügbar.
**Um eine Vorschau Ihrer Benachrichtigungsvorlagen anzuzeigen**
1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“.
1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage hinzufügen** oder bearbeiten Sie eine vorhandene Vorlage.
1. Fügen Sie den Inhalt Ihrer Vorlage hinzu oder aktualisieren Sie sie.
Standarddaten werden bereitgestellt, und Sie können Warndaten sowie Warnungsinstanzen hinzufügen oder bearbeiten. Sie können Warndaten direkt im Payload-Datenfenster selbst hinzufügen oder auf **Warnungsinstanzen auswählen** oder **Benutzerdefinierte Benachrichtigungen hinzufügen** klicken.
1. [Optional] So fügen Sie Warnungsdaten aus vorhandenen Warnungsinstanzen hinzu:
1. **Wählen Sie „Warnungsinstanzen** auswählen“.
1. Bewegen Sie den Mauszeiger über die Warnungsinstanzen, um weitere Informationen zu jeder Warnungsinstanz anzuzeigen/
1. Wählen Sie **Bestätigen**, um die Warnungsinstanz zur Payload hinzuzufügen.
1. [Optional] Um Warnungsdaten mit dem Alert-Dateneditor hinzuzufügen, wählen Sie **Benutzerdefinierte Daten hinzufügen** aus:
1. Fügen Sie Anmerkungen und benutzerdefinierte Beschriftungen hinzu oder richten Sie ein Dashboard oder einen Bereich ein.
1. Aktiviere „Ausgelöst“ oder „Gelöst“, je nachdem, ob du deiner Benachrichtigung ausgelöste oder gelöste Warnmeldungen hinzufügen möchtest.
1. Wähle „**Warnungsdaten hinzufügen**“.
1. Wählen Sie **Vorschau aktualisieren**, um zu sehen, wie der Inhalt Ihrer Vorlage aussehen wird und welche Payload-Daten dazu gehören.
Wenn Ihre Vorlage Fehler enthält, werden diese in der Vorschau angezeigt und Sie können sie vor dem Speichern korrigieren.
1. Speichern Sie Ihre Änderungen.
## Erstellen Sie eine Vorlage für den Betreff der Nachricht
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. Führen Sie die Vorlage über das Titelfeld in Ihrer Kontaktpunktintegration aus.
```
{{ 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.
**Anmerkung**
Diese Vorlage ist nur für von Grafana verwaltete Benachrichtigungen vorgesehen. Um die Vorlage für von Datenquellen verwaltete Benachrichtigungen zu verwenden, löschen Sie die Verweise auf dashboardURL und silenceUrl. Weitere Informationen zur Konfiguration von Prometheus-Benachrichtigungen finden Sie in der [Prometheus-Dokumentation](https://prometheus.io/docs/alerting/latest/notifications/) zu Benachrichtigungen.
```
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. Führen Sie die Vorlage über das Textfeld in Ihrer Kontaktpunktintegration aus:
```
{{ 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 Registerkarte „**Kontaktstellen**“, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.
1. Wählen Sie **New (Neu)**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie auf das Symbol **Bearbeiten** klicken.
1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein Feld 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. Wählen Sie **Kontaktstelle speichern**.
# Vorlage – Referenz
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
**Warnung (Typ)**
Der Warnungstyp enthält die folgenden Daten.
| Name | Art | Description | Beispiel |
| --- | --- | --- | --- |
| Status | Zeichenfolge | `firing` oder `resolved`. | \$1\$1 .Status \$1\$1 |
| Labels | KeyValue | Eine Reihe von Bezeichnungen, die an die Warnung angehängt sind. | \$1\$1 .Labels \$1\$1 |
| Anmerkungen | KeyValue | Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. | \$1\$1 .Annotations \$1\$1 |
| Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen | \$1\$1 .Values \$1\$1 |
| StartsAt | Zeit.Zeit | Uhrzeit, zu der der Alarm ausgelöst wurde. | \$1\$1 .StartsAt \$1\$1 |
| 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. | \$1\$1 .EndsAt \$1\$1 |
| Generator-URL | Zeichenfolge | Ein Backlink zu Grafana oder einem externen Alertmanager. | \$1\$1 .GeneratorURL \$1\$1 |
| Silence-URL | Zeichenfolge | Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .SilenceURL\$1\$1 |
| Dashboard-URL | Zeichenfolge | Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .DashboardURL \$1\$1 |
| Panel-URL | Zeichenfolge | Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .PanelURL \$1\$1 |
| Fingerabdruck | Zeichenfolge | Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. | \$1\$1 .Fingerprint \$1\$1 |
| ValueString | Zeichenfolge | Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. | \$1\$1 .ValueString \$1\$1 |
**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 gibt an`firing`, ob mindestens ein Alarm ausgelöst wird, andernfalls`resolved`. | `{{ .Status }}` |
| Benachrichtigungen | `[]Alert` | Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung. | `There are {{ len .Alerts }} alerts` |
| Auslösewarnungen | `[]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 Namen | `{{ .Names }}` |
| Werte | | [] Zeichenfolge | Liste von Werten | `{{ .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).
# Kontaktstellen verwalten
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 der Listenansicht der **Kontaktpunkte** werden alle vorhandenen Kontaktstellen und Benachrichtigungsvorlagen aufgeführt.
Auf der Registerkarte **Kontaktstellen** können Sie:
+ Suchen Sie nach Namen und Typen von Kontaktstellen und Integrationen.
+ Sehen Sie sich alle vorhandenen Kontaktstellen und Integrationen an.
+ Sehen Sie sich an, für wie viele Benachrichtigungsrichtlinien jeder Kontaktpunkt verwendet wird, und navigieren Sie direkt zu den verknüpften Benachrichtigungsrichtlinien.
+ Sehen Sie sich den Status der Zustellungen von Benachrichtigungen an.
+ Exportieren Sie einzelne Kontaktpunkte oder alle Kontaktpunkte im JSON-, YAML- oder Terraform-Format.
+ Löschen Sie Kontaktpunkte, die nicht von einer Benachrichtigungsrichtlinie verwendet werden.
Auf der Registerkarte **Benachrichtigungsvorlagen** können Sie:
+ Bestehende Benachrichtigungsvorlagen anzeigen, bearbeiten, kopieren oder löschen.
# Warnmeldungen stummschalten
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Warnmeldungen unterdrücken, indem Sie sie stumm schalten.* 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.
**Anmerkung**
Um Warnmeldungen in regelmäßigen Zeitabständen zu unterdrücken, z. B. während regulärer Wartungsperioden, sollten Sie [Timings stummschalten](v10-alerting-manage-muting.md) eher die Option „Stummschalten“ verwenden.
**Um eine Stille hinzuzufügen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. **Wählen Sie Stille.**
1. **Wählen Sie einen Alertmanager aus dem Alertmanager-Drop-down-Menü aus.**
1. Wählen Sie **„**Stille erstellen“.
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.
1. Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt werden soll. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert.
1. Geben Sie in den Feldern **Bezeichnung** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Alle passenden Warnmeldungen (im Status „Auslösen“) werden im Feld **Betroffene Warnmeldungen angezeigt**.
1. Fügen Sie optional einen **Kommentar** hinzu, der die Stille beschreibt.
1. Wählen Sie **Absenden** aus.
**Um eine Stille zu bearbeiten**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille anzuzeigen.
1. Suchen Sie nach der Stille, die Sie bearbeiten möchten, und wählen Sie dann **Bearbeiten** (Stiftsymbol).
1. Nehmen Sie die gewünschten Änderungen vor und wählen Sie dann **Absenden**, um Ihre Änderungen zu speichern.
Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen.
**Um einen URL-Link zu einem Stilleformular zu erstellen**
Wenn Sie auf ein Silence-Formular verlinken, geben Sie die standardmäßigen passenden Labels sowie die Parameter für die Kommentarfunktion `matcher` und die `comment` Abfrageparameter an. Der `matcher` Parameter sollte das folgende Format haben, `[label][operator][value]` wobei der `operator` Parameter eines der folgenden sein kann: `=` (equals, not regex), (not equals, not regex), `!=` (equals, regex), `=~` (not equals, regex). `!~` Die URL kann viele `matcher` Abfrageparameter mit dem Schlüssel enthalten. Um beispielsweise einen Link zu einem Silence-Formular mit den passenden Bezeichnungen `severity=critical` `cluster!~europe-.*` und Kommentar zu erstellen`Silence critical EU alerts`, erstellen Sie eine URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.
Um einen Link zu einer neuen Silence-Seite für einen externen Alertmanager zu erstellen, fügen Sie einen `alertmanager` Abfrageparameter hinzu
**Um eine Stille zu entfernen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille 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.
# Warnungsregeln anzeigen und filtern
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Abschnitt **Grafana** listet Regeln auf, die von Grafana verwaltet werden. Warnregeln für Prometheus-kompatible Datenquellen sind ebenfalls hier aufgeführt. 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.
## Warnungsregeln 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ü **Alerting, Alert-Regeln aus**.** Standardmäßig wird die Listenansicht angezeigt.
1. In **Ansicht als** können Sie zwischen den Ansichten Gruppiert, Listen und Status wechseln, indem Sie die gewünschte Option auswählen.
1. Erweitern Sie die Regelzeile, um die Regelbezeichnungen, Anmerkungen, Datenquellen, die Regelabfragen und eine Liste der Warnungsinstanzen anzuzeigen, die sich aus der Regel ergeben.
Auf dieser Seite können Sie auch Kopien einer Warnungsregel erstellen, um bestehende Regeln wiederzuverwenden.
## Warnungsregeln exportieren
Sie können Regeln im Grafana-Arbeitsbereich nach YAML oder JSON exportieren.
+ Wählen Sie das Symbol **Regelgruppe exportieren** neben jeder Warnungsregelgruppe, um sie nach YAML, JSON oder Terraform zu exportieren.
+ Wählen Sie **Regeln exportieren**, um alle von Grafana verwalteten Warnungsregeln nach YAML, JSON oder Terraform zu exportieren.
+ Wählen Sie neben jeder einzelnen Warnungsregel innerhalb einer Gruppe die Option **Mehr**, **Export ändern** aus, um bereitgestellte Warnungsregeln zu bearbeiten und eine geänderte Version zu exportieren.
## Abfragedefinitionen für bereitgestellte Benachrichtigungen anzeigen
Zeigt schreibgeschützte Abfragedefinitionen für bereitgestellte Benachrichtigungen an. Prüfen Sie schnell, ob Ihre Warnungsregelabfragen korrekt sind, ohne in Ihrem As-Code-Repository nach Regeldefinitionen suchen zu müssen.
**Gruppierte Ansicht**
Die gruppierte Ansicht zeigt Grafana-Warnungsregeln 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 Warnmeldungen filtern
Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen**“ angezeigt werden, auf verschiedene Arten filtern.
**Um Warnungsregeln zu filtern**
1. **Wählen Sie unter Datenquellen** auswählen eine Datenquelle aus. Sie können Warnungsregeln sehen, die die ausgewählte Datenquelle abfragen.
1. Geben Sie im Feld **Nach Label suchen mithilfe von** Label-Selektoren Suchkriterien ein. Beispiel, `environment=production;region=~US|EU,severity!=warning`.
1. Wählen Sie **unter Benachrichtigungen nach Status filtern** den Warnstatus aus, den Sie sehen möchten. Sie können sich Warnregeln anzeigen lassen, die diesem Status entsprechen. Regeln, die anderen Bundesstaaten entsprechen, sind ausgeblendet.
# Timings stummschalten
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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.
## Stummschalten im Vergleich zu Stille
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. |
## Timing für Stummschaltung hinzufügen
Sie können in Ihrem Grafana-Arbeitsbereich Stummschaltungen erstellen.
**Um ein Timing für die Stummschaltung hinzuzufügen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte Timings **stummschalten**.
1. Wählen Sie in der Dropdownliste **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten.
1. Wählen Sie die Taste **\$1** Timing für Stummschaltung hinzufügen.
1. Füllen Sie das Formular aus, um ein [Zeitintervall](#v10-alerting-manage-muting-interval) zu erstellen, das mit Ihrem Timing für die Stummschaltung übereinstimmt.
1. Speichern Sie Ihre Stummschaltung.
## Hinzufügen eines Timings für die Stummschaltung zu einer Benachrichtigungsrichtlinie
Sobald Sie einen Zeitpunkt für die Stummschaltung festgelegt haben, verwenden Sie ihn, indem Sie ihn der Benachrichtigungsrichtlinie hinzufügen, die Sie in regelmäßigen Abständen stummschalten möchten.
**Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte **Benachrichtigungsrichtlinien** aus.
1. Wählen Sie die Benachrichtigungsrichtlinie aus, der Sie die Stummschaltung hinzufügen möchten, und wählen Sie**...** , **Bearbeiten**.
1. Wählen Sie in der Dropdownliste **für die Stummschaltung** die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten.
1. Speichern Sie Ihre Änderungen.
## Zeitintervalle
Ein Zeitintervall ist eine bestimmte Dauer, in der Warnmeldungen unterdrückt werden. Die Dauer besteht in der Regel aus einem bestimmten Zeitraum und den Tagen der Woche, des Monats oder des Jahres.
Die Optionen für das Supportzeitintervall sind:
+ **Zeitbereich** — Die Zeit inklusive Start- und Endzeit (in UTC, wenn kein Standort ausgewählt wurde, andernfalls Ortszeit).
+ **Standort** — Legt den Ort für das Timing fest. Der Zeitraum wird in Ortszeit für den Standort angezeigt.
+ **Wochentage** — Der Tag oder Bereich von Wochentagen. Beispiel, `monday:thursday`.
+ **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.
+ **Monate** — Die Monate des Jahres in numerischer oder vollständiger Kalendermonatsbezeichnung. Beispiel, `1, may:august`.
+ **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2024`.
Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Felder unterstützen auch Bereiche mithilfe von`:`. Beispiel, `monday:thursday`.
Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Damit ein Moment von einem kompletten Zeitintervall entspricht, müssen alle Felder übereinstimmen. Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten.
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`
# Status und Zustand der Warnungsregeln anzeigen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Anhand des Status und der Integrität von Warnungsregeln erhalten Sie mehrere wichtige Statusindikatoren für Ihre Benachrichtigungen.
Es gibt drei Komponenten:
+ [Status der Warnungsregel](#v10-alerting-manage-rulestate-state)
+ [Status der Warnungsinstanz](#v10-alerting-manage-rulestate-instance)
+ [Zustand der Warnmeldungsregel](#v10-alerting-manage-rulestate-health)
Obwohl sie miteinander verwandt sind, vermittelt jede Komponente subtil unterschiedliche Informationen.
**Um den Status und den Zustand Ihrer Warnungsregeln einzusehen**
1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Warnungsregeln**, um die Liste der vorhandenen Benachrichtigungen anzuzeigen.
1. Wählen Sie eine Warnungsregel aus, um deren Status und Zustand einzusehen.
## Status der Warnungsregel
Eine Warnungsregel kann sich in einem der folgenden Status befinden:
| Status | Description |
| --- | --- |
| Normal | Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den firing Status „pendingOder“. |
| Ausstehend | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istpending. |
| Wird gefeuert | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istfiring. |
**Anmerkung**
Warnmeldungen werden zuerst auf `pending` und dann `firing` übertragen. 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 pending weder noch istfiring. Alles funktioniert wie erwartet. |
| 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. |
| Keine Daten | Für das konfigurierte Zeitfenster wurden keine Daten empfangen. |
| Warnfunktion | Beim Versuch, eine Warnregel auszuwerten, ist ein Fehler aufgetreten. |
## Letzten Status beibehalten
Eine Warnungsregel kann so konfiguriert werden, dass der letzte Status beibehalten wird, wenn ein `NoData` oder `Error` -Zustand auftritt. Dadurch wird sowohl verhindert, dass Warnmeldungen ausgelöst werden, als auch, dass sie behoben und erneut ausgelöst werden. Genau wie bei der normalen Evaluierung wird die Warnungsregel von `pending` zu `firing` nach Ablauf der Wartezeit umgestellt.
## Zustand der Warnmeldungsregel
Eine Warnungsregel kann einen der folgenden Integritätsstatus haben.
| Status | Description |
| --- | --- |
| Ok | Keine Fehler bei der Auswertung der Warnungsregel. |
| Fehler | Bei der Auswertung der Warnungsregel ist ein Fehler aufgetreten. |
| NoData | Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde. |
| \$1Status\$1, KeepLast | Die Regel hätte einen anderen Status erhalten, wurde aber so konfiguriert, dass sie den letzten Status der Warnungsregel beibehält. |
## Besondere Warnmeldungen für NoData und Fehler
Wenn die Auswertung einer Warnungsregel den Status `NoData` oder ergibt`Error`, generiert Grafana-Alerting Warninstanzen mit den folgenden zusätzlichen Bezeichnungen.
| Label (Bezeichnung) | Description |
| --- | --- |
| Name der Warnung | Entweder DatasourceNoData oderDatasourceError, je nach Bundesland. |
| datasource\$1uid | Die UID der Datenquelle, die den Status verursacht hat. |
**Anmerkung**
Um die zusätzlichen Beschriftungen zu generieren, müssen Sie, wie im [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md) Thema beschrieben, `Error` in der Regel „Keine Daten“ `NoData` oder „Fehler behandeln“ auf oder in der Warnungsregel festlegen.
Sie können diese Benachrichtigungen auf die gleiche Weise behandeln wie normale Benachrichtigungen, einschließlich Hinzufügen von Stille, Weiterleitung an eine Kontaktstelle usw.
# Warnungsgruppen anzeigen und nach Warnungsgruppen filtern
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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 Standardrichtlinie 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. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.**
1. Wählen Sie **Gruppen, um bestehende Gruppen** anzuzeigen.
1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus.
1. Wählen Sie aus der Dropdownliste **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`
Sie können Warnungen nach Bezeichnung oder Status der Benachrichtigungen filtern.
**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 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.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. Wählen Sie im Menü auf der linken Seite **Benachrichtigungen und** dann **Kontaktstellen** aus.
Wenn eine Kontaktstelle ausfällt, werden Sie in einer Meldung in der rechten Ecke des Arbeitsbereichs darüber informiert, dass und wie viele Fehler vorliegen.
1. Wählen Sie eine Kontaktstelle aus, um die Details der Fehler für diese Kontaktstelle einzusehen.
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.