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. # Grafana-Warnung **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Grafana-Alerting bietet Ihnen robuste und umsetzbare Warnmeldungen, mit denen Sie sofort nach ihrem Auftreten über Probleme in den Systemen informiert werden können, wodurch Unterbrechungen Ihrer Dienste minimiert werden. Amazon Managed Grafana bietet Zugriff auf ein aktualisiertes Warnsystem, *Grafana Alerting, das Warninformationen* in einer einzigen, durchsuchbaren Ansicht zentralisiert. Es umfasst die folgenden Funktionen: + Erstellen und verwalten Sie Grafana-Benachrichtigungen in einer zentralen Ansicht. + Erstellen und verwalten Sie verwaltete Cortex- und Loki-Benachrichtigungen über eine einzige Oberfläche. Weitere Informationen finden Sie unter [Verwalte deine Alarmregeln](v9-alerting-managerules.md). + Zeigen Sie Warninformationen von Prometheus, Amazon Managed Service for Prometheus und anderen AlertManager-kompatiblen Datenquellen an. + Erstellen Sie mehrere Warnungsinstanzen anhand einer einzigen Warnungsregel. Weitere Informationen finden Sie unter [Ein- und mehrdimensionale Regeln](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule). + Verwalten Sie Ihre Alarmressourcen mit Terraform oder Provisioning. APIs Weitere Informationen finden Sie unter [Bereitstellung von Grafana-Alerting-Ressourcen](v9-alerting-setup-provision.md). Für bestehende Amazon Managed Grafana-Workspaces ist die Standardeinstellung der[Klassische Dashboard-Benachrichtigungen](old-alerts-overview.md). Um zu Grafana-Alerting zu migrieren, müssen Sie [zu Grafana-Alerting migrieren](alert-opt-in.md). Weitere Informationen zu Grafana-Benachrichtigungen finden Sie unter. [Was ist neu in Grafana-Alerting](alerts-whats-new.md) Die Grafana-Warnung besteht aus vier Hauptkomponenten: + [Warnregel](alert-rules.md) — Bewertungskriterien, die bestimmen, ob eine Warnung ausgelöst wird. Sie besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, über die die Bedingung erfüllt wird. + [Kontaktstelle](alert-contact-points.md) — Kanal für das Senden von Benachrichtigungen, wenn die Bedingungen einer Warnregel erfüllt sind. + [Benachrichtigungsrichtlinie](alert-notifications.md) — Eine Reihe von Zuordnungs- und Gruppierungskriterien, anhand derer die Häufigkeit von Benachrichtigungen bestimmt wird. + [Schweigen](alert-silences.md) — Datum und Abgleichskriterien, anhand derer Benachrichtigungen stummgeschaltet werden. Wenn die Grafana-Warnung aktiviert ist, können Sie: + [Erstellen Sie verwaltete Grafana-Alarmregeln](alert-rules.md#create-grafana-alert-rule) + [Erstellen Sie verwaltete Cortex- oder Loki-Alarmregeln](alert-rules.md#create-alert-rule) + [Sehen Sie sich bestehende Alarmregeln an und verwalten Sie ihren aktuellen Status](alert-rules.md#manage-alert-rules) + [Sehen Sie sich den Status und den Zustand der Alarmregeln an](alert-fundamentals.md#alerts-state) + [Fügen Sie eine Kontaktstelle für Alarme hinzu oder bearbeiten Sie sie](alert-contact-points.md#alert-working-contact-points) + [Benachrichtigungsrichtlinien hinzufügen oder bearbeiten](alert-notifications.md#alert-notifications-working) + [Stille hinzufügen oder bearbeiten](alert-silences.md) ## Einschränkungen + Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Amazon Managed Service für Prometheus-, Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Regeln aus anderen unterstützten Datenquellen abzurufen. + Warnregeln, die in Grafana und nicht in Prometheus definiert sind, senden mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Alerts anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für Alerts sendet, die in Prometheus Alertmanager erstellt wurden. **Anmerkung** Diese Einschränkung gilt nicht mehr für Amazon Managed Grafana-Arbeitsbereiche, die Grafana v10.4 und höher unterstützen. **Topics** + [ ## Einschränkungen ](#alert-limitations) + [ # Was ist neu in Grafana-Alerting ](alerts-whats-new.md) + [ # Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen ](alert-opt-in.md) + [ # Grundlagen der Alarmierung ](alert-fundamentals.md) + [ # Grafana-Alarmregeln erstellen und verwalten ](alert-rules.md) + [ # Warnungsgruppen ](alert-groups.md) + [ # Stummschalten von Warnmeldungen für Prometheus-Datenquellen ](alert-silences.md) + [ # Mit Kontaktstellen arbeiten ](alert-contact-points.md) + [ # Messaging-Vorlagen verwenden ](alert-message-templates.md) + [ # Mit Benachrichtigungsrichtlinien arbeiten ](alert-notifications.md) # Was ist neu in Grafana-Alerting **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Grafana-Alerting bietet mehrere Verbesserungen gegenüber klassischen Dashboard-Benachrichtigungen. ## Erstellen Sie mehrdimensionale Warnmeldungen Sie können jetzt eine einzige Warnregel erstellen, die Ihnen systemweite Transparenz bietet und aus einer einzigen Warnungsregel mehrere Warnungsinstanzen generiert. Sie können beispielsweise eine Regel erstellen, um die Festplattennutzung mehrerer Bereitstellungspunkte 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. **Anmerkung** Jede Warnungsinstanz wird auf das Alert-Kontingent angerechnet. Mehrdimensionale Regeln, die mehr Instanzen erstellen, als innerhalb des Warnungskontingents untergebracht werden können, werden nicht ausgewertet und geben einen Kontingentfehler zurück. Weitere Informationen finden Sie unter [Fehler beim Erreichen des Kontingents](alert-rules.md#rule-quota-reached). ## Erstellen Sie Warnmeldungen außerhalb von Dashboards Im Gegensatz zu klassischen 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 Cortex In Grafana-Benachrichtigungen können Sie Loki- und Cortex-Alarmregeln mit derselben Benutzeroberfläche und API wie Ihre von Grafana-verwalteten Benachrichtigungen verwalten. ## Benachrichtigungen von Amazon Managed Service für Prometheus und andere Prometheus-kompatible Datenquellen anzeigen und durchsuchen Benachrichtigungen für Amazon Managed Service for Prometheus und Prometheus-kompatible Datenquellen werden jetzt in der Warnungsoberfläche aufgeführt. Sie können in mehreren Datenquellen nach Labels suchen, um schnell relevante Warnmeldungen zu finden. ## Spezielle Benachrichtigungen für Alarmstatus NoData und Fehler Grafana-Alerting generiert spezielle Alerts mit den folgenden Bezeichnungen, wenn die Auswertung einer Warnregel den Status oder ergibt: `NoData` `Error` + `alertname`mit Wert `DatasourceNoData` oder `DatasourceError` abhängig vom Bundesstaat. + `rulename`mit dem Namen der Warnungsregel, zu der die spezielle Warnung gehört. + `datasource_uid`hat die UID der Datenquelle, die den Status verursacht hat. + Alle Beschriftungen und Anmerkungen der ursprünglichen Regel. Sie können diese Benachrichtigungen genauso behandeln wie normale Benachrichtigungen, z. B. indem Sie eine Stille oder eine Weiterleitung an eine Kontaktstelle hinzufügen. **Anmerkung** Wenn die Regel mehrere Datenquellen verwendet und eine oder mehrere keine Daten zurückgeben, wird die spezielle Warnung für jede Datenquelle erstellt, die den Warnstatus verursacht hat. # Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen Migration zu Grafana-Benachrichtigungen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Bestehende Workspaces oder Workspaces, die Grafana-Benachrichtigungen nicht verwenden, verwenden die klassischen Dashboard-Benachrichtigungen. Um zur neuen Grafana-Warnung zu migrieren, müssen Sie sich für die Funktion anmelden. Sie können Ihre Amazon Managed Grafana-Instance so konfigurieren, dass Grafana-Benachrichtigungen mithilfe der AWS-Managementkonsole, der oder der Amazon Managed Grafana-API verwendet werden. AWS CLI Einzelheiten zur Konfiguration von Amazon Managed Grafana, einschließlich der Aktivierung oder Deaktivierung von Grafana-Benachrichtigungen, finden Sie unter. [Konfigurieren Sie einen Amazon Managed Grafana-Arbeitsbereich](AMG-configure-workspace.md) **Anmerkung** Wenn Sie Grafana-Benachrichtigungen verwenden, senden Warnregeln, die in Grafana und nicht in Prometheus definiert sind, mehrere Benachrichtigungen an Ihre Kontaktstelle. Wenn Sie native Grafana-Benachrichtigungen verwenden, empfehlen wir, die klassische Dashboard-Warnung beizubehalten und die neue Grafana-Warnfunktion nicht zu aktivieren. Wenn Sie in Ihrer Prometheus-Datenquelle definierte Benachrichtigungen anzeigen möchten, empfehlen wir Ihnen, Grafana Alerting zu aktivieren, das nur eine einzige Benachrichtigung für in Prometheus Alertmanager erstellte Warnungen sendet. Diese Einschränkung wurde in Amazon Managed Grafana-Arbeitsbereichen, die Grafana v10.4 und höher unterstützen, aufgehoben. ## Migration zum Grafana-Warnsystem Wenn die Grafana-Warnung aktiviert ist, werden bestehende klassische Dashboard-Benachrichtigungen in ein Format migriert, das mit der Grafana-Warnung kompatibel ist. Auf der Seite „Benachrichtigungen“ Ihrer Grafana-Instanz können Sie die migrierten Benachrichtigungen zusammen mit neuen Benachrichtigungen anzeigen. Mit Grafana-Benachrichtigungen senden Ihre von Grafana verwalteten Alarmregeln mehrere Benachrichtigungen statt einer einzigen Warnung, wenn sie übereinstimmen. Der Lese- und Schreibzugriff auf klassische Dashboard-Benachrichtigungen und Grafana-Benachrichtigungen wird durch die Berechtigungen der Ordner geregelt, in denen sie gespeichert sind. Während der Migration werden die klassischen Dashboard-Warnungsberechtigungen wie folgt den neuen Regelberechtigungen zugeordnet: + Wenn das Dashboard der ursprünglichen Warnung über Berechtigungen verfügt, wird bei der Migration ein Ordner mit diesem Format erstellt`Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}`, der den Berechtigungen des ursprünglichen Dashboards entspricht (einschließlich der geerbten Berechtigungen aus dem Ordner). + Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard unter einem Ordner befindet, wird die Regel mit diesem Ordner verknüpft und erbt dessen Berechtigungen. + Wenn keine Dashboard-Berechtigungen vorhanden sind und sich das Dashboard im Ordner Allgemein befindet, wird die Regel mit dem Ordner Allgemeine Benachrichtigungen verknüpft, und die Regel erbt die Standardberechtigungen. **Anmerkung** Da es `NoData` in Grafana-Benachrichtigungen keine `Keep Last State` Option gibt, wird diese Option `NoData` bei der klassischen Regelmigration aktiviert. Die Option `Keep Last State` für die `Error` Handhabung wurde auf eine neue Option migriert. `Error` Um dem Verhalten der zu entsprechen`Keep Last State`, erstellt Amazon Managed Grafana in beiden Fällen während der Migration automatisch eine Stille für jede Alarmregel mit einer Dauer von einem Jahr. Benachrichtigungskanäle werden auf eine Alertmanager-Konfiguration mit den entsprechenden Routen und Empfängern migriert. Standardbenachrichtigungskanäle werden als Kontaktpunkte zur Standardroute hinzugefügt. Benachrichtigungskanäle, die keiner Dashboard-Warnung zugeordnet sind, führen zur `autogen-unlinked-channel-recv` Route. ### Einschränkungen + Das Grafana-Warnsystem kann Regeln aus allen verfügbaren Prometheus-, Loki- und Alertmanager-Datenquellen abrufen. Es ist möglicherweise nicht in der Lage, Warnregeln aus anderen unterstützten Datenquellen abzurufen. + Die Migration zwischen Grafana-Benachrichtigungen und den klassischen Dashboard-Benachrichtigungen kann zu Datenverlust für Funktionen führen, die in einem System unterstützt werden, im anderen jedoch nicht. **Anmerkung** Wenn Sie zurück zur klassischen Dashboard-Warnung migrieren, verlieren Sie alle Änderungen, die an der Warnungskonfiguration vorgenommen wurden, während Sie die Grafana-Warnung aktiviert hatten, einschließlich aller neuen Warnungsregeln, die erstellt wurden. # Grundlagen der Alarmierung **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Dieser Abschnitt enthält Informationen zu den grundlegenden Konzepten der Grafana-Warnung. ## Konzepte der Alarmierung In der folgenden Tabelle werden die wichtigsten Konzepte der Grafana-Warnung beschrieben. | Schlüsselkonzept oder Merkmal | Definition | | --- | --- | | Datenquellen für Warnmeldungen | Wählen Sie Datenquellen aus, aus denen Sie Metriken, Logs und Traces abfragen und visualisieren möchten. | | Scheduler | Wertet Ihre Warnungsregeln aus. Dabei handelt es sich um die Komponente, die regelmäßig Abfragen von Datenquellen ausführt. Sie gilt nur für von Grafana verwaltete Regeln. | | Alert-Manager | Verwaltet das Routing und die Gruppierung von Alert-Instanzen. | | Warnungsregel | Eine Reihe von Bewertungskriterien für den Zeitpunkt, an dem eine Warnregel ausgelöst werden soll. Eine Warnungsregel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und der Dauer, über die die Bedingung erfüllt wird. Eine Warnungsregel kann mehrere Warnungsinstanzen erzeugen. | | Warnungsinstanz | Eine Warnungsinstanz ist eine Instanz einer Warnungsregel. Eine eindimensionale Warnungsregel hat eine Warnungsinstanz. Eine mehrdimensionale Warnungsregel hat eine oder mehrere Warnungsinstanzen. Eine einzelne Warnungsregel, die mehreren Ergebnissen entspricht, z. B. CPU gegen 10 VMs, wird als mehrere (in diesem Fall 10) Warnungsinstanzen gezählt. Diese Zahl kann im Laufe der Zeit variieren. Beispielsweise enthält eine Warnungsregel, die die CPU-Auslastung für alle VMs in einem System überwacht, mehr Warnungsinstanzen als hinzugefügt VMs werden. Weitere Informationen über Kontingente für Warnungsinstanzen finden Sie unter. [Fehler beim Erreichen des Kontingents](alert-rules.md#rule-quota-reached) | | Warnungsgruppe | Der Alertmanager gruppiert Warnungsinstanzen standardmäßig anhand der Bezeichnungen für die Stammbenachrichtigungsrichtlinie. Dadurch werden die Deduplizierung und Gruppen von Warnungsinstanzen gesteuert, die an Kontaktstellen gesendet werden. | | Kontaktstelle | Definieren Sie, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird. | | Erstellung von Nachrichtenvorlagen | Erstellen Sie wiederverwendbare benutzerdefinierte Vorlagen und verwenden Sie sie in Kontaktpunkten. | | Benachrichtigungsrichtlinie | Regelwerk, das festlegt, wo, wann und wie die Benachrichtigungen gruppiert und an Kontaktstellen weitergeleitet werden. | | Labels und Label-Matcher | Mit Labels lassen sich Warnregeln eindeutig identifizieren. Sie verknüpfen Warnregeln mit Benachrichtigungsrichtlinien und Stummschaltungen und legen fest, welche Richtlinie sie behandeln soll und welche Warnregeln zum Schweigen gebracht werden sollen. | | Schweigen | Stoppt Benachrichtigungen von einer oder mehreren Warnungsinstanzen. Der Unterschied zwischen einer Stille und einer Stummschaltung besteht darin, dass eine Stille für ein bestimmtes Zeitfenster andauert, während die Stummschaltung nach einem wiederkehrenden Zeitplan erfolgt. Verwendet Label-Matcher, um Warnungsinstanzen zum Schweigen zu bringen. | | Timings stummschalten | Geben Sie ein Zeitintervall an, in dem keine neuen Benachrichtigungen generiert oder gesendet werden sollen. Sie können Warnmeldungen für wiederkehrende Zeiträume einfrieren, z. B. während eines Wartungszeitraums. Muss mit einer bestehenden Benachrichtigungsrichtlinie verknüpft sein. | ## Datenquellen warnen Von Grafana verwaltete Benachrichtigungen fragen die folgenden Backend-Datenquellen ab, für die Benachrichtigungen aktiviert sind. + Integrierte oder von Grafana entwickelte und verwaltete Datenquellen:`Alertmanager`,`Graphite`, `Prometheus` (einschließlich Amazon Managed Service for Prometheus),,,`Loki`,`InfluxDB`,`Amazon OpenSearch Service`,`Google Cloud Monitoring`,`Amazon CloudWatch`,`Azure Monitor`,,`MySQL`, `PostgreSQL` `MSSQL``OpenTSDB`, `Oracle` und. `Azure Monitor` ## Warnung bei numerischen Daten Numerische Daten, die nicht in einem Zeitreihenformat vorliegen, können direkt als Warnung angezeigt oder an serverseitige Ausdrücke ü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 mit Backend-Datenquellen unterstützt, die Tabellendaten abfragen, einschließlich SQL-Datenquellen wie MySQL, Postgres, MSSQL und Oracle. Eine Abfrage mit von Grafana verwalteten Warnungen oder serverseitigen Ausdrücken wird bei diesen Datenquellen als numerisch betrachtet: + Wenn die `Format AS` Option `Table` in der Datenquellenabfrage auf eingestellt ist. + Wenn die von der Abfrage an Grafana zurückgegebene Tabellenantwort nur eine numerische Spalte (z. B. int, double oder float) und optional zusätzliche Zeichenkettenspalten enthält. Wenn Zeichenkettenspalten vorhanden sind, werden diese Spalten zu Beschriftungen. Der Name der Spalte wird zum Labelnamen, und der Wert für jede Zeile wird zum Wert der entsprechenden Bezeichnung. Wenn mehrere Zeilen zurückgegeben werden, sollte jede Zeile anhand ihrer Beschriftungen eindeutig identifiziert werden. ### Beispiel Wenn Sie eine MySQL-Tabelle namens Diskspace haben, wie folgt. | 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. Eine Warnung, die pro Host und Festplatte ausgelöst wird, wenn weniger als 5% freier Speicherplatz zur Verfügung steht, könnte beispielsweise wie folgt aussehen. ``` 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, sind die Fälle, in denen der Wert ungleich Null ist, eine Warnung. Als Ergebnis werden drei Warnungsinstanzen erzeugt, wie in der folgenden Tabelle dargestellt. | Labels | Status | | --- | --- | | \$1host=WEB1, disk=/etc\$1 | Warnfunktion | | \$1Host=Web2, Festplatte=/var\$1 | Warnfunktion | | \$1host=WEB3, Festplatte=/var\$1 | Normal | ## Alert-Manager Grafana bietet integrierte Unterstützung für Prometheus Alertmanager. Der Alertmanager hilft sowohl bei der Gruppierung als auch bei der Verwaltung von Warnungsregeln und fügt den Alert-Engines eine zusätzliche Orchestrierungsebene hinzu. Standardmäßig werden Benachrichtigungen für von Grafana verwaltete Benachrichtigungen vom eingebetteten Alertmanager verarbeitet, der Teil des Kerns von Grafana ist. Sie können die Kontaktpunkte, Benachrichtigungsrichtlinien und Vorlagen des Alertmanagers über die Grafana-Alerting-Benutzeroberfläche konfigurieren, indem Sie die Option Grafana aus der Alertmanager-Dropdownliste auswählen. Grafana-Alerting unterstützt die externe Alertmanager-Konfiguration (weitere Informationen zu Alertmanager als externe Datenquelle finden Sie unter). [Stellen Sie eine Connect zu einer AlertManager-Datenquelle her](data-source-alertmanager.md) Wenn Sie einen externen Alertmanager hinzufügen, zeigt das Alertmanager-Drop-down-Menü eine Liste der verfügbaren externen Alertmanager-Datenquellen an. Wählen Sie eine Datenquelle aus, um Benachrichtigungen für eigenständige Cortex- oder Loki-Datenquellen zu erstellen und zu verwalten. ## Status und Zustand der Warnregeln Der Status und der Zustand der Warnregeln helfen Ihnen dabei, mehrere wichtige Statusindikatoren Ihrer Benachrichtigungen zu verstehen. Es gibt drei Hauptkomponenten: den Warnstatus, den Status der Warnregeln und den Zustand der Warnregeln. Obwohl sie miteinander verwandt sind, vermittelt jede Komponente leicht unterschiedliche Informationen. **Status der Warnmeldungsregel** + **Normal** — Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den `Firing` Status „`Pending`Oder“. + **Ausstehend** — Mindestens eine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen ist`Pending`. + **Wird ausgelöst** — Mindestens eine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen ist`Firing`. **Alarmstatus** + **Normal** — Die Bedingung für die Warnregel ist für jede Zeitreihe, die von der Evaluierungs-Engine zurückgegeben wird, **falsch**. + **Warnung** — Der Zustand der Warnregel ist für mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe **wahr**. Die Dauer, für die die Bedingung erfüllt sein muss, bevor eine Warnung ausgelöst wird, sofern sie gesetzt ist, erfüllt ist oder überschritten wurde. + **Ausstehend** — Die Bedingung der Warnregel ist für mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe **wahr**. Die Dauer, für die die Bedingung erfüllt sein muss, bevor eine Warnung ausgelöst wird, wurde, sofern sie gesetzt ist, nicht erfüllt. + **NoData**— Die Warnregel hat keine Zeitreihe zurückgegeben, alle Werte für die Zeitreihe sind Null oder alle Werte für die Zeitreihe sind Null. + **Fehler** — Fehler beim Versuch, eine Warnregel auszuwerten. **Integrität der Warnmeldungsregel** + **Ok** — Kein Fehler bei der Auswertung einer Warnregel. + **Fehler** — Fehler bei der Auswertung einer Warnregel. + **NoData**— Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde. # Grafana-Alarmregeln erstellen und verwalten Alarmregeln **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Eine Warnregel besteht aus einer Reihe von Bewertungskriterien, die bestimmen, ob eine Warnung ausgelöst wird. Die Regel besteht aus einer oder mehreren Abfragen und Ausdrücken, einer Bedingung, der Häufigkeit der Auswertung und optional der Dauer, über die die Bedingung erfüllt wird. Während Abfragen und Ausdrücke den Datensatz auswählen, der ausgewertet werden soll, legt eine Bedingung den Schwellenwert fest, den eine Warnung erfüllen oder überschreiten muss, um eine Warnung auszulösen. Ein Intervall gibt an, wie oft eine Warnregel ausgewertet wird. Die Dauer gibt, sofern konfiguriert, an, wie lange eine Bedingung erfüllt sein muss. Die Regeln können auch das Warnverhalten bei fehlenden Daten definieren. In den folgenden Abschnitten wird das Erstellen und Verwalten verschiedener Arten von Grafana-Warnregeln beschrieben. **Topics** + [ ## Von Cortex oder Loki verwaltete Warnungsregeln erstellen ](#create-alert-rule) + [ ## Von Cortex oder Loki verwaltete Aufzeichnungsregeln erstellen ](#create-alert-recording-rule) + [ ## Von Grafana verwaltete Alarmregeln erstellen ](#create-grafana-alert-rule) + [ ## Anmerkungen und Beschriftungen für Warnregeln ](#alert-rule-labels) + [ ## Verwaltung von Warnungsregeln ](#manage-alert-rules) + [ ## Cortex- oder Loki-Regelgruppen und Namespaces ](#alert-rule-groups) ## Von Cortex oder Loki verwaltete Warnungsregeln erstellen Mit Grafana können Sie Warnregeln für eine externe Cortex- oder Loki-Instanz erstellen. **Anmerkung** Cortex ist die Zeitreihendatenbank, die von Amazon Managed Service für Prometheus- und Prometheus-Datenquellen verwendet wird. **Voraussetzungen** + Stellen Sie sicher, dass Sie Schreibberechtigungen für die Prometheus-Datenquelle haben. Andernfalls sind Sie nicht in der Lage, verwaltete Cortex-Warnregeln zu erstellen oder zu aktualisieren. + Aktivieren Sie für Cortex- und Loki-Datenquellen die Ruler-API, indem Sie ihre jeweiligen Dienste konfigurieren. + **Loki** — Der `local` Regelspeichertyp, Standard für die Loki-Datenquelle, unterstützt nur das Anzeigen von Regeln. Um Regeln zu bearbeiten, konfigurieren Sie einen der anderen Speichertypen. + **Cortex** — Verwenden Sie das `/api/prom` Legacy-Präfix, nicht`/prometheus`. Die Prometheus-Datenquelle unterstützt sowohl Cortex 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 eine von Cortex oder Loki verwaltete Warnregel hinzuzufügen** 1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen. 1. **Wählen Sie Neue Warnungsregel.** 1. Fügen Sie in **Schritt 1** den Namen, den Typ und den Speicherort der Regel wie folgt hinzu: + Fügen Sie im **Feld Regelname** einen beschreibenden Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird. + Wählen Sie **in der Dropdownliste Regeltyp** die Option **Cortex/Loki** Managed Alert aus. + **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus. + Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](#alert-rule-groups). + Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt. 1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu. Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt. 1. Fügen Sie in **Schritt 3** Bedingungen hinzu. Geben Sie im Textfeld Für der Bedingung die Dauer an, für die die Bedingung erfüllt sein muss, bevor die Warnung ausgelöst wird. Wenn Sie angeben`5m`, müssen die Bedingungen fünf Minuten lang erfüllt sein, bevor die Warnung ausgelöst wird. **Anmerkung** Wenn eine Bedingung erfüllt ist, geht die Warnung in den `Pending` Status über. Wenn die Bedingung für die angegebene Dauer aktiv bleibt, wechselt die Warnung in den `Firing` Status. Wenn sie nicht mehr erfüllt ist, kehrt sie in den `Normal` Status zurück. 1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind. + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Anmerkungen und Beschriftungen für Warnregeln](#alert-rule-labels). + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu. + Fügen Sie benutzerdefinierte Labels hinzu. 1. Wählen Sie „**Warnmeldungen in der Vorschau anzeigen**“, um die Regel auszuwerten und zu sehen, welche Warnmeldungen sie ausgeben würde. Es wird eine Liste von Warnmeldungen mit Status und Wert der einzelnen Warnungen angezeigt. 1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren. ## Von Cortex oder Loki verwaltete Aufzeichnungsregeln erstellen Sie können Aufzeichnungsregeln für eine externe Cortex- oder Loki-Instanz erstellen und verwalten. Aufzeichnungsregeln berechnen häufig benötigte Ausdrücke oder rechenintensive Ausdrücke im Voraus und speichern das Ergebnis als neue Zeitreihe. Die Abfrage dieser neuen Zeitreihe ist schneller, insbesondere bei Dashboards, da bei jeder Aktualisierung der Dashboards derselbe Ausdruck abgefragt wird. **Voraussetzungen** Aktivieren Sie für Cortex- und Loki-Datenquellen die Ruler-API, indem Sie ihre jeweiligen Dienste konfigurieren. + **Loki** — Der `local` Regelspeichertyp, Standard für die Loki-Datenquelle, unterstützt nur das Anzeigen von Regeln. Um Regeln zu bearbeiten, konfigurieren Sie einen der anderen Speichertypen. + **Cortex** — Wenn Sie eine Grafana Prometheus-Datenquelle so konfigurieren, dass sie auf Cortex verweist, verwenden Sie das `/api/prom` Legacy-Präfix, nicht. `/prometheus` Die Prometheus-Datenquelle unterstützt sowohl Cortex 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 eine von Cortex oder Loki verwaltete Aufzeichnungsregel hinzuzufügen** 1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen. 1. **Wählen Sie Neue Warnungsregel.** 1. Fügen Sie in **Schritt 1** den Namen, den Typ und den Speicherort der Regel wie folgt hinzu. + Fügen Sie im **Feld Regelname** einen beschreibenden Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird. + Wählen Sie **in der Dropdownliste Regeltyp** die Option **Cortex/Loki** Managed Alert aus. + **Wählen Sie in der Dropdownliste Datenquelle** auswählen eine Prometheus- oder Loki-Datenquelle aus. + Wählen Sie aus der Dropdownliste **Namespace** einen vorhandenen Regel-Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Namespaces können eine oder mehrere Regelgruppen enthalten und haben nur einen organisatorischen Zweck. Weitere Informationen finden Sie unter [Cortex- oder Loki-Regelgruppen und Namespaces](#alert-rule-groups). + Wählen Sie in der Dropdownliste **Gruppe** eine bestehende Gruppe im ausgewählten Namespace aus. Andernfalls wählen Sie **Neu hinzufügen** und geben Sie einen Namen ein, um einen zu erstellen. Neu erstellte Regeln werden an das Ende der Gruppe angehängt. Regeln innerhalb einer Gruppe werden sequenziell in regelmäßigen Intervallen mit derselben Evaluierungszeit ausgeführt. 1. Fügen Sie in **Schritt 2** die auszuwertende Abfrage hinzu. Der Wert kann ein PromQL- oder LogQL-Ausdruck sein. Die Regel löst eine Warnung aus, wenn das Auswertungsergebnis mindestens eine Reihe mit einem Wert größer als 0 enthält. Für jede Serie wird eine Warnung erstellt. 1. Fügen Sie in **Schritt 3** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind. + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Anmerkungen und Beschriftungen für Warnregeln](#alert-rule-labels). + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu. + Fügen Sie benutzerdefinierte Labels hinzu. 1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren. ## Von Grafana verwaltete Alarmregeln erstellen Grafana ermöglicht es Ihnen, Warnregeln zu erstellen, die eine oder mehrere Datenquellen abfragen, die Ergebnisse reduzieren oder transformieren und miteinander vergleichen oder Schwellenwerte festlegen. Wenn diese bearbeitet werden, sendet Grafana Benachrichtigungen an die Kontaktstelle. **Anmerkung** Das Erstellen von von Grafana-verwalteten Warnungsregeln während der Verwendung von Grafana-Benachrichtigungen führt dazu, dass mehrere Benachrichtigungen gesendet werden, wenn die Regel erfüllt ist. Einige Anbieter von Kontaktstellen verfügen möglicherweise über konfigurierbare Optionen zum Deduplizieren der Benachrichtigungen. **So fügen Sie eine verwaltete Grafana-Regel hinzu** 1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** mit den vorhandenen **Alerts** zu öffnen. 1. **Wählen Sie Neue Warnungsregel.** 1. Fügen Sie in **Schritt 1** den Namen, den Typ und den Speicherort der Regel wie folgt hinzu: + Fügen Sie im **Feld Regelname** einen beschreibenden Namen hinzu. Dieser Name wird in der Liste der Warnungsregeln angezeigt. Es ist auch die `alertname` Bezeichnung für jede Warnungsinstanz, die anhand dieser Regel erstellt wird. + Wählen Sie **in der Dropdownliste Regeltyp** die Option **Grafana Managed** Alert aus. + Wählen Sie aus der Dropdownliste **Ordner** den Ordner aus, in dem Sie die Regel speichern möchten. Wenn Sie keinen Ordner auswählen, wird die Regel in dem `General` Ordner gespeichert. Um einen Ordner zu erstellen, wählen Sie das Drop-down-Menü aus und geben Sie einen neuen Ordnernamen ein. 1. Fügen Sie in **Schritt 2** die auszuwertenden Abfragen und Ausdrücke hinzu. + Behalten Sie den Standardnamen bei oder bewegen Sie den Mauszeiger darüber und wählen Sie das Bearbeitungssymbol, um den Namen zu ändern. + Wählen Sie für Abfragen eine Datenquelle aus der Dropdownliste aus. + Fügen Sie eine oder mehrere [Abfragen](panel-queries.md) oder Ausdrücke hinzu (Einzelheiten zu Ausdrücken finden Sie unter [Ausdrücke](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) in der *Grafana-Dokumentation*). + 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**, **Resample**, um separate Alerts für jede Serie zu generieren. Einzelheiten zu diesen Optionen finden Sie unter[Ein- und mehrdimensionale Regeln](#single-multi-rule). + Wählen Sie **Abfragen ausführen**, um zu überprüfen, ob die Abfrage erfolgreich ist. 1. Fügen Sie in **Schritt 3** Bedingungen hinzu. + Wählen Sie in der Dropdownliste **Bedingung** die Abfrage oder den Ausdruck aus, mit dem die Warnungsregel initiiert werden soll. + Geben **Sie für Alle auswerten** die Häufigkeit der Auswertung an. Muss ein Vielfaches von 10 Sekunden sein. Zum Beispiel `1m`, `30s`. + Geben Sie unter **Evaluieren für** die Dauer an, für die die Bedingung erfüllt sein muss, bevor eine Warnung ausgelöst wird. **Anmerkung** Wenn eine Bedingung verletzt wurde, geht die Warnung in den `Pending` Status über. Bleibt die Bedingung für die angegebene Dauer verletzt, wechselt die Warnung in den `Firing` Status. Wenn sie nicht mehr erfüllt ist, wird der `Normal` Status wieder hergestellt. + **Konfigurieren Sie unter Keine Daten konfigurieren und Fehlerbehandlung** das Warnverhalten bei fehlenden Daten. Beachten Sie die Richtlinien unter. [Es werden keine Daten- oder Fehlerfälle behandelt](#rule-no-data-error) + Wählen Sie „**Warnmeldungen in der Vorschau**“, um das Ergebnis der Ausführung der Abfrage in diesem Moment zu überprüfen. In der Vorschau sind keine Daten und keine Bedingungen für die Fehlerbehandlung enthalten. 1. Fügen Sie in **Schritt 4** zusätzliche Metadaten hinzu, die der Regel zugeordnet sind. + Fügen Sie eine Beschreibung und eine Zusammenfassung hinzu, um Warnmeldungen individuell anzupassen. Verwenden Sie die Richtlinien in[Anmerkungen und Beschriftungen für Warnregeln](#alert-rule-labels). + Fügen Sie die Runbook-URL, das Panel, das Dashboard und die Warnung IDs hinzu. + Fügen Sie benutzerdefinierte Labels hinzu. 1. Wählen Sie **Speichern**, um die Regel zu **speichern, oder Speichern und beenden**, um die Regel zu speichern und zur **Warnseite** zurückzukehren. ### Ein- und mehrdimensionale Regeln Für von Grafana verwaltete Warnungsregeln können Sie eine Regel mit einer klassischen Bedingung oder eine mehrdimensionale Regel erstellen. **Eindimensionale Regel (klassische Bedingung)** Verwenden Sie einen klassischen Bedingungsausdruck, um eine Regel zu erstellen, die eine einzelne Warnung auslöst, wenn ihre Bedingung erfüllt ist. Bei einer Abfrage, die mehrere Serien zurückgibt, verfolgt Grafana nicht den Alarmstatus jeder Serie. Infolgedessen sendet Grafana nur eine einzige Warnung, selbst wenn die Alarmbedingungen für mehrere Serien erfüllt sind. Weitere Informationen zum Formatieren von Ausdrücken finden Sie unter [Ausdrücke](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) in der *Grafana-Dokumentation*. **Mehrdimensionale Regel** Um für jede in der Abfrage zurückgegebene Serie eine separate Warnungsinstanz zu generieren, erstellen Sie eine multidimensionale Regel. **Anmerkung** Jede durch eine multidimensionale Regel generierte Warnungsinstanz wird auf Ihr Gesamtkontingent an Warnmeldungen angerechnet. Regeln werden nicht ausgewertet, wenn Sie Ihr Alert-Kontingent erreicht haben. Weitere Informationen zu Kontingenten für mehrdimensionale Regeln finden Sie unter[Fehler beim Erreichen des Kontingents](#rule-quota-reached). Um mehrere Instanzen aus einer einzigen Regel zu erstellen, verwenden Sie, oder `Resample` Ausdrücke `Math``Reduce`, um eine multidimensionale Regel zu erstellen. Beispielsweise ist Folgendes möglich: + Fügen Sie für jede Abfrage einen `Reduce` Ausdruck hinzu, um Werte im ausgewählten Zeitraum zu einem einzigen Wert zusammenzufassen. (Nicht erforderlich für [Regeln, die numerische Daten verwenden](alert-fundamentals.md#alert-numeric)). + Fügen Sie einen `Math` Ausdruck mit der Bedingung für die Regel hinzu. Dies ist nicht erforderlich, wenn eine Abfrage oder ein Reduce-Ausdruck bereits 0 zurückgibt, wenn die Regel keine Warnung auslösen soll, oder eine positive Zahl, wenn sie eine Warnung auslösen soll. Hier einige Beispiele: + `$B > 70`wenn sie eine Warnung auslösen soll, falls der Wert von B mehr als 70 query/expression ist. + `$B < $C * 100`falls es eine Warnung auslösen soll, wenn der Wert von B kleiner als der Wert von C multipliziert mit 100 ist. Wenn die Ergebnisse von Abfragen, die verglichen werden, mehrere Reihen enthalten, werden Reihen aus verschiedenen Abfragen abgeglichen, wenn sie dieselben Beschriftungen haben oder eine eine Teilmenge der anderen ist. **Anmerkung** Grafana unterstützt keine Warnabfragen mit Vorlagenvariablen. Weitere Informationen finden Sie auf der Community-Seite. [Vorlagenvariablen werden bei der Einrichtung von Alert in Warnungsabfragen nicht unterstützt](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514). **Überlegungen zur Leistung multidimensionaler Regeln** Jede Warnungsinstanz wird auf das Warnungskontingent angerechnet. Mehrdimensionale Regeln, die mehr Instanzen erstellen, als innerhalb des Warnungskontingents untergebracht werden können, werden nicht ausgewertet und geben einen Kontingentfehler zurück. Weitere Informationen finden Sie unter [Fehler beim Erreichen des Kontingents](#rule-quota-reached). Mehrdimensionale Benachrichtigungen können einen großen Einfluss auf die Leistung Ihres Grafana-Workspace sowie auf die Leistung Ihrer Datenquellen haben, da Grafana sie abfragt, um Ihre Warnungsregeln auszuwerten. Die folgenden Überlegungen können hilfreich sein, wenn Sie versuchen, die Leistung Ihres Überwachungssystems zu optimieren. + **Häufigkeit der Regelauswertung** — Die Eigenschaft „**Alle auswerten**“ einer Warnungsregel steuert die Häufigkeit der Regelauswertung. Wir empfehlen, die niedrigste akzeptable Evaluierungshäufigkeit zu verwenden. + **Kardinalität der Ergebnismenge** — Die Anzahl der Warnungsinstanzen, die Sie mit einer Regel erstellen, wirkt sich auf deren Leistung aus. Angenommen, Sie überwachen API-Antwortfehler für jeden API-Pfad auf jeder VM in Ihrer Flotte. Dieser Satz hat eine Kardinalität der Anzahl der Pfade multipliziert mit der Anzahl von. VMs Sie können die Kardinalität der Ergebnismenge reduzieren, indem Sie beispielsweise die Gesamtanzahl der Fehler pro VM statt pro Pfad pro VM überwachen. + **Komplexität der Abfrage** — Abfragen, die Datenquellen schnell verarbeiten und beantworten können, verbrauchen weniger Ressourcen. Diese Überlegung ist zwar weniger wichtig als die anderen oben aufgeführten Überlegungen, aber wenn Sie sie so weit wie möglich reduziert haben, könnte die Betrachtung der individuellen Abfrageleistung einen Unterschied machen. Sie sollten sich auch der Auswirkungen bewusst sein, die die Bewertung dieser Regeln auf die Leistung Ihrer Datenquellen hat. Warnabfragen machen häufig die überwiegende Mehrheit der Abfragen aus, die von Überwachungsdatenbanken verarbeitet werden. Daher wirken sich dieselben Auslastungsfaktoren, die sich auf die Grafana-Instanz auswirken, auch auf sie aus. ### Fehler beim Erreichen des Kontingents Es gibt ein Kontingent für die Anzahl der Warnungsinstanzen, die Sie in einem einzelnen Workspace haben können. Wenn Sie diese Anzahl erreichen, können Sie in diesem Workspace keine neuen Warnungsregeln mehr erstellen. Bei mehrdimensionalen Benachrichtigungen kann die Anzahl der Warnungsinstanzen im Laufe der Zeit variieren. Bei der Arbeit mit Warnungsinstanzen sollten Sie Folgendes beachten. + Wenn Sie nur eindimensionale Regeln erstellen, ist jede Regel eine einzelne Warnungsinstanz. Sie können in einem einzigen Workspace die gleiche Anzahl von Regeln erstellen wie Ihr Kontingent für Warnungsinstanzen, und nicht mehr. + Mehrdimensionale Regeln erzeugen mehrere Warnungsinstanzen, deren Anzahl jedoch erst bekannt ist, wenn sie ausgewertet wurden. Wenn Sie beispielsweise eine Warnungsregel erstellen, die die CPU-Auslastung Ihrer Amazon EC2 EC2-Instances verfolgt, gibt es bei der Erstellung möglicherweise 50 EC2-Instances (und somit 50 Alert-Instances). Wenn Sie jedoch eine Woche später 10 weitere EC2-Instances hinzufügen, umfasst die nächste Auswertung 60 Alert-Instances. Die Anzahl der Alert-Instances wird ausgewertet, wenn Sie eine multidimensionale Warnung erstellen, und Sie können keine erstellen, bei der Sie sofort Ihr Alert-Instance-Kontingent überschreiten. Da sich die Anzahl der Warnungsinstanzen ändern kann, wird Ihr Kontingent bei jeder Auswertung Ihrer Regeln überprüft. + Wenn Sie bei der Regelauswertung aufgrund einer Regel Ihr Kontingent für Warnungsinstanzen überschreiten, wird diese Regel erst evaluiert, wenn die Warnungsregel aktualisiert wird, sodass die Gesamtzahl der Warnungsinstanzen unter das Dienstkontingent fällt. In diesem Fall erhalten Sie eine Warnmeldung, die Sie darüber informiert, dass Ihr Kontingent erreicht wurde (die Benachrichtigung verwendet die Benachrichtigungsrichtlinie für die auszuwertende Regel). Die Benachrichtigung enthält eine `Error` Anmerkung mit dem Wert`QuotaReachedError`. + Eine Regel, die bewirkt, dass a `QuotaReachedError` nicht mehr ausgewertet wird. Die Auswertung wird nur dann wieder aufgenommen, wenn ein Update vorgenommen wird und die Auswertung nach dem Update selbst keine Ursache hat`QuotaReachedError`. Eine Regel, die nicht ausgewertet wird, zeigt in der Grafana-Konsole den Fehler **Kontingent erreicht** an. + Sie können die Anzahl der Warnungsinstanzen verringern, indem Sie Warnungsregeln entfernen oder indem Sie mehrdimensionale Warnungen bearbeiten, sodass weniger Warnungsinstanzen angezeigt werden (z. B. indem Sie eine Warnung bei Fehlern pro VM anstelle einer Warnung bei Fehlern pro API in einer VM haben). + Um die Evaluierungen fortzusetzen, aktualisieren Sie die Warnung und speichern Sie sie. Sie können es aktualisieren, um die Anzahl der Warnungsinstanzen zu verringern, oder wenn Sie andere Änderungen vorgenommen haben, um die Anzahl der Warnungsinstanzen zu verringern, können Sie es unverändert speichern. Wenn es wieder aufgenommen werden kann, ist es das auch. Wenn es ein anderes verursacht`QuotaReachedError`, können Sie es nicht speichern. + Wenn eine Warnung gespeichert wird und die Auswertung wieder aufgenommen wird, ohne das Warnungskontingent zu überschreiten, kann der Fehler **Kontingent erreicht** noch einige Zeit (bis zum Bewertungsintervall) in der Grafana-Konsole angezeigt werden. Die Auswertung der Warnungsregel wird jedoch gestartet und es werden Warnungen gesendet, wenn der Regelschwellenwert erreicht ist. + Einzelheiten zur Quote für Warnmeldungen sowie zu anderen Kontingenten finden Sie unter. [Amazon Managed Grafana-Servicekontingente](AMG_quotas.md) ### Es werden keine Daten- oder Fehlerfälle behandelt Wählen Sie Optionen für den Umgang mit Warnmeldungen, wenn keine Daten vorliegen oder Fehler auftreten. Die Optionen für den Umgang mit fehlenden Daten sind in der folgenden Tabelle aufgeführt. | Option „Keine Daten“ | Behavior | | --- | --- | | Keine Daten | Erstellen Sie eine Warnung `DatasourceNoData` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. | | Warnfunktion | Legen Sie den Status der Warnungsregel auf fest. `Alerting` | | OK | Stellen Sie den Status der Warnungsregel auf ein`Normal`. | Die Optionen für die Behandlung von Fehlerfällen sind in der folgenden Tabelle aufgeführt. | Fehler- oder Timeout-Option | Behavior | | --- | --- | | Warnfunktion | Setzen Sie den Status der Warnungsregel auf `Alerting` | | OK | Legen Sie den Status der Warnungsregel fest auf `Normal` | | Fehler | Erstellen Sie eine Warnung `DatasourceError` mit dem Namen und der UID der Warnungsregel sowie der UID der Datenquelle, die keine Daten zurückgegeben hat, als Beschriftungen. | ## Anmerkungen und Beschriftungen für Warnregeln Anmerkungen und Beschriftungen sind Schlüssel-Wert-Paare, die mit Warnmeldungen verknüpft sind, die aus der Warnungsregel, der Datenquellenantwort und dem Ergebnis der Auswertung von Warnmeldungsregeln stammen. Sie können direkt in Warnmeldungen oder in [Vorlagen](alert-message-templates.md) und [Vorlagenfunktionen](alert-message-templates.md#alert-template-functions) verwendet werden, um einen Benachrichtigungskontakt dynamisch zu erstellen. **Anmerkungen** Anmerkungen sind Schlüssel-Wert-Paare, die zusätzliche Informationen zu einer Warnung bereitstellen. Sie können die folgenden Anmerkungen verwenden:`description`,,, `summary``runbook_url`, `alertId` und. `dashboardUid` `panelId` Diese werden in Regel- und Warnungsdetails auf der Benutzeroberfläche angezeigt und können in Nachrichtenvorlagen für Kontaktstellen verwendet werden. **Labels** Labels sind Schlüssel-Wert-Paare, die Informationen zu einer Warnung enthalten. Die für eine Warnung festgelegte Bezeichnung wird während des gesamten Evaluierungs- und Benachrichtigungsprozesses generiert und erweitert. Sie werden auf folgende Weise verwendet. + Der vollständige Satz von Bezeichnungen für eine Warnung identifiziert diese Warnung in Grafana Alerts eindeutig. + [Der Alertmanager verwendet Labels, um Alerts für [Stummmeldungen und Warnungsgruppen in](alert-silences.md)[Benachrichtigungsrichtlinien zuzuordnen](alert-groups.md).](alert-notifications.md) + In der Benutzeroberfläche für Warnmeldungen werden Beschriftungen für jede Warnungsinstanz angezeigt, die durch die Auswertung dieser Regel generiert wurde. + Kontaktpunkte können auf Labels zugreifen, um dynamisch Benachrichtigungen zu generieren, die spezifische Informationen zu der Warnung enthalten, die zu einer Benachrichtigung führt. + Einer [Warnungsregel](#alert-rules) können Labels hinzugefügt werden. Diese manuell konfigurierten Labels können Vorlagenfunktionen verwenden und auf andere Labels verweisen. Beschriftungen, die hier zu einer Warnregel hinzugefügt wurden, haben im Falle einer Kollision zwischen Labels Vorrang. Die folgenden Vorlagenvariablen sind verfügbar, wenn Anmerkungen und Beschriftungen erweitert werden. | Name | Description | | --- | --- | | `$labels` | Die Beschriftungen aus der Abfrage oder Bedingung. Beispiel: `{{ $labels.instance }}` und `{{ $labels.job }}`. Dies ist nicht verfügbar, wenn die Regel eine klassische Bedingung verwendet. | | `$values` | Die Werte aller Reduce-Ausdrücke und mathematischen Ausdrücke, die für diese Warnungsregel ausgewertet wurden. Zum Beispiel`{{ $values.A }}`, `{{ $values.A.Labels }}` und `{{ $values.A.Value }}` wo `A` ist der `refID` des Ausdrucks. Dies ist nicht verfügbar, wenn die Regel eine klassische Bedingung verwendet | | `$value` | Die Wertzeichenfolge der Warnungsinstanz. Beispiel, `[ var='A' labels={instance=foo} value=10 ]`. | ## Verwaltung von Warnungsregeln Auf der Seite „**Benachrichtigungen**“ werden Warnregeln aufgeführt. Standardmäßig sind Regeln nach Datenquellentypen gruppiert. Der **Grafana-Abschnitt** listet Regeln auf, die von Grafana verwaltet werden, und der Abschnitt **Cortex/Loki** listet Regeln für Prometheus-kompatible Datenquellen auf. Sie können Warnregeln für Prometheus-kompatible Datenquellen anzeigen, sie jedoch nicht bearbeiten. ### Warnregeln anzeigen Mit Grafana-Benachrichtigungen können Sie alle Ihre Benachrichtigungen auf einer Seite anzeigen. **Um die Details der Benachrichtigungen anzuzeigen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** Standardmäßig werden Regeln in Gruppen nach Datenquellentyp angezeigt. Sie können die einzelnen Warnmeldungen auch anhand des aktuellen Status anzeigen (diese werden im folgenden Text ausführlicher beschrieben). 1. In „**Anzeigen als**“ können Sie zwischen der Gruppen- und der Statusansicht wechseln, indem Sie die von Ihnen bevorzugte Option auswählen. 1. Wählen Sie den Pfeil neben einer Zeile, um weitere Details zu dieser Zeile anzuzeigen. Zu den Details einer Regel gehören die Regelbezeichnungen, Anmerkungen, Datenquellen und Abfragen sowie eine Liste der Warnungsinstanzen, die sich aus der Regel ergeben. **Ansicht „Gruppe“** Die Gruppenansicht zeigt Grafana-Alarmregeln gruppiert nach Ordnern und Loki- oder Prometheus-Alarmregeln gruppiert nach \$1. `namespace` `group` Dies ist die Standardregellistenansicht, die für die Verwaltung von Regeln vorgesehen ist. Sie können jede Gruppe erweitern, um eine Liste der Regeln in dieser Gruppe anzuzeigen. Erweitern Sie eine Regel weiter, um ihre Details anzuzeigen. Sie können auch Aktionsschaltflächen und Warnmeldungen, die sich aus der Regel ergeben, erweitern, um deren Details anzuzeigen. **Ansicht „Status“** In der Statusansicht werden die Warnungsregeln nach Bundesland gruppiert angezeigt. Verwenden Sie diese Ansicht, um einen Überblick darüber zu erhalten, welche Regeln sich in welchem Status befinden. Jede Regel kann erweitert werden, um ihre Details anzuzeigen. Aktionsschaltflächen und alle durch diese Regel generierten Warnungen. Jede Warnung kann weiter erweitert werden, um ihre Details anzuzeigen. **Regeln für die Filterung von Warnmeldungen** Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen“ angezeigt werden, auf verschiedene** Arten filtern. + Sie können filtern, um die Regeln anzuzeigen, die eine bestimmte Datenquelle abfragen, indem **Sie Datenquellen auswählen** und dann eine Datenquelle auswählen, nach der gefiltert werden soll. + Sie können nach Bezeichnungen filtern, indem Sie unter Nach **Bezeichnung suchen die gewünschten** Suchkriterien auswählen. Einige Beispielkriterien umfassen`environment=production`,`region=~US|EU`,`severity!=warning`. + Sie können filtern, um die Regeln in einem bestimmten Status anzuzeigen, indem Sie **Benachrichtigungen nach Status filtern** und dann den Status auswählen, den Sie anzeigen möchten. ### Warnungsregeln bearbeiten oder löschen Von Grafana verwaltete Alarmregeln können nur von Benutzern mit Bearbeitungsberechtigungen für den Ordner bearbeitet oder gelöscht werden, in dem die Regeln gespeichert sind. Warnregeln für eine externe Cortex- oder Loki-Instanz können von Benutzern mit Editor- oder Admin-Rollen bearbeitet oder gelöscht werden. **Um eine Regel zu bearbeiten oder zu löschen** 1. Erweitern Sie eine Regel, bis Sie die Regelsteuerelemente für **Anzeigen**, **Bearbeiten** und **Löschen** sehen können. 1. Wählen Sie **Bearbeiten**, um die Seite „Regel erstellen“ zu öffnen. Nehmen Sie Aktualisierungen auf die gleiche Weise vor, wie Sie eine Regel erstellen. Einzelheiten finden Sie in den Anweisungen unter [Von Grafana verwaltete Alarmregeln erstellen](#create-grafana-alert-rule) oder[Von Cortex oder Loki verwaltete Warnungsregeln erstellen](#create-alert-rule). 1. Wählen Sie optional **Löschen**, um eine Regel zu löschen. ## Cortex- oder Loki-Regelgruppen und Namespaces Sie können Ihre Regeln organisieren. Regeln werden innerhalb von Regelgruppen erstellt, und Regelgruppen sind in Namespaces organisiert. Die Regeln innerhalb einer Regelgruppe werden nacheinander in regelmäßigen Abständen ausgeführt. Das Standardintervall ist eine Minute. Sie können Cortex- oder Loki-Namespaces und Regelgruppen umbenennen und die Bewertungsintervalle für Regelgruppen bearbeiten. **Um eine Regelgruppe oder einen Namespace zu bearbeiten** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. Navigieren Sie zu einer Regel innerhalb der Regelgruppe oder des Namespace, die Sie bearbeiten möchten. 1. Wählen Sie das Symbol **Bearbeiten** (Stift). 1. Nehmen Sie Änderungen an der Regelgruppe oder dem Namespace vor. **Anmerkung** Bei Namespaces können Sie nur den Namen bearbeiten. Bei Regelgruppen ändern Sie den Namen oder das Bewertungsintervall für Regeln in der Gruppe. Sie können beispielsweise festlegen`1m`, dass die Regeln einmal pro Minute oder `30s` einmal alle 30 Sekunden ausgewertet werden. 1. Wählen Sie **Änderungen speichern ** aus. # Warnungsgruppen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig sind die Warnungen nach den Labelschlüsseln für die Stammrichtlinie in gruppiert. [Mit Benachrichtigungsrichtlinien arbeiten](alert-notifications.md) Durch die Gruppierung allgemeiner Warnmeldungen in einer einzigen Warnungsgruppe wird verhindert, dass doppelte Warnmeldungen ausgelöst werden. **Um Warnungsgruppierungen anzuzeigen** 1. Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting** (Glockensymbol) und dann das Element **Alert-Gruppierung**, um die Seite mit den vorhandenen Gruppen zu öffnen. 1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus. Standardmäßig ist der Alertmanager ausgewählt. `Grafana` 1. Wählen Sie in der Dropdownliste „**Benutzerdefiniert gruppieren nach**“ eine Kombination von Bezeichnungen aus, um eine andere Gruppierung als die Standardgruppierung anzuzeigen. Sie können diese Ansicht verwenden, um Ihre Gruppierung von Benachrichtigungsrichtlinien zu debuggen oder zu überprüfen. Benachrichtigungen ohne Bezeichnungen, die in der Gruppierung der Stammrichtlinie oder der benutzerdefinierten Gruppierung angegeben wurden, werden einer Gruppe mit dem Header von hinzugefügt. `No grouping` **Warnungen filtern** Sie können die folgenden Filter verwenden, um Benachrichtigungen anzuzeigen, die bestimmten Kriterien entsprechen: + **Nach Label suchen** — Geben Sie im Feld **Suche** ein vorhandenes Label ein, um Benachrichtigungen anzuzeigen, die dem Label entsprechen. Zum Beispiel`environment=production`,`region=~US|EU`,`severity!=warning`. + **Benachrichtigungen nach Bundesland filtern** — Wählen Sie unter **Bundesstaaten** die Option „Aus“ `Active``Suppressed`, oder „`Unprocessed`Bundesländer“ aus, um die Benachrichtigungen in diesem Bundesstaat anzuzeigen. # Stummschalten von Warnmeldungen für Prometheus-Datenquellen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) *Für externe AlertManager-Datenquellen (einschließlich Amazon Managed Service für Prometheus) können Sie Warnmeldungen ausblenden, 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. Sie können Stummschaltungen für eine externe AlertManager-Datenquelle konfigurieren. **Anmerkung** Um Warnmeldungen in regelmäßigen Zeitintervallen (z. B. während regulärer Wartungsperioden) zu unterdrücken, verwenden Sie [Timings stummschalten](alert-notifications.md#alert-notification-muting) anstelle von Stummschaltungen. **Um eine Stille hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. [Wählen Sie **Stille**, um eine Seite mit den vorhandenen Kontaktstellen zu öffnen.](alert-contact-points.md) 1. **Wählen Sie den externen Alertmanager aus der Alertmanager-Dropdownliste aus.** 1. **Wählen Sie** „Neue Stille“ aus. 1. Wählen Sie unter Start und Ende von **Silence das Start- und Enddatum** aus, um anzugeben, wann die Stille in Kraft treten und wann sie enden soll. Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt werden soll. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert. 1. Geben Sie in den Feldern **Name** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Der Labelabgleich wird im Anschluss an dieses Verfahren ausführlicher erörtert. 1. Fügen Sie optional einen **Kommentar** hinzu oder ändern Sie den **Ersteller** so, dass er den Besitzer der Stille festlegt. **Label-Abgleich zur Unterdrückung von Alarmen** Wenn Sie eine Stille erstellen, erstellen Sie im Rahmen der Stille eine Reihe von *passenden Bezeichnungen*. Dabei handelt es sich um eine Reihe von Regeln für Bezeichnungen, die übereinstimmen müssen, damit die Warnung unterdrückt wird. Die passenden Beschriftungen bestehen aus drei Teilen: + **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen. + **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind: + `=`Wählen Sie Beschriftungen aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt. + `!=`Wählen Sie Beschriftungen aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert). + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen. + **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen. Eine Stille endet am angegebenen Enddatum, Sie können die Unterdrückung jedoch jederzeit manuell beenden. **Um eine Stille manuell zu beenden** 1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option „**Stille**“, um die Liste der vorhandenen Pausen anzuzeigen. 1. **Wählen Sie die Stille aus, die Sie beenden möchten, und wählen Sie „Stille aufheben“.** Dadurch wird die Unterdrückung von Alarmen beendet. **Anmerkung** Wenn Sie die Stummschaltung aufheben, wird die Unterdrückung von Alarmen beendet, als ob die Endzeit für die aktuelle Uhrzeit festgelegt wäre. Stille, die (automatisch oder manuell) beendet wurde, werden fünf Tage lang beibehalten und in der Liste aufgeführt. Sie können eine Stille nicht manuell aus der Liste entfernen. **Einen Link zum Formular zur Erstellung von Stille erstellen** Sie können eine URL zum Formular zur Erstellung von Stille erstellen, wobei die Details bereits ausgefüllt sind. Bediener können dies verwenden, um einen Alarm während eines Betriebsereignisses schnell zu unterdrücken. Wenn Sie einen Link zu einem Silence-Formular erstellen, verwenden Sie einen `matchers` Abfrageparameter, um die entsprechenden Bezeichnungen anzugeben, und einen `comment` Abfrageparameter, um einen Kommentar anzugeben. Der `matchers` Parameter erfordert einen oder mehrere Werte im Formular`[label][operator][value]`, getrennt durch Kommas. **Beispiel für eine URL** Verwenden Sie eine URL wie die folgende, um einen Link zu einem `cluster!~europe-.*` Silence-Formular mit passenden Bezeichnungen `severity=critical` und einem Kommentar`Silencing critical EU alerts`, der besagt, zu verlinken. *mygrafana*Ersetzen Sie durch den Hostnamen Ihrer Grafana-Instanz. ``` https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert ``` Um eine Verknüpfung zu einer neuen Silence-Seite für einen externen Alertmanager herzustellen, fügen Sie einen `alertmanager` Abfrageparameter mit dem Alertmanage-Datenquellennamen hinzu, z. B. `alertmanager=myAlertmanagerdatasource` # Mit Kontaktstellen arbeiten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Eine Kontaktstelle kann einen oder mehrere Kontaktpunkttypen haben, zum Beispiel Amazon Simple Notification Service oder Slack. Wenn eine Warnung ausgelöst wird, wird eine Benachrichtigung an alle Kontaktstellentypen gesendet, die für eine Kontaktstelle aufgeführt sind. Verwenden Sie diese Option optional, [Messaging-Vorlagen verwenden](alert-message-templates.md) um die Benachrichtigungen für die Kontaktpunkttypen anzupassen. **Anmerkung** Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktpunkte für Alertmanager-Benachrichtigungen sind schreibgeschützt. ## Mit Kontaktpunkten arbeiten In den folgenden Verfahren wird detailliert beschrieben, wie Kontaktpunkte hinzugefügt, bearbeitet, getestet und gelöscht werden. **Um eine Kontaktstelle hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie **Kontaktstellen** und dann Neue Kontaktstelle.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt. 1. Geben Sie einen **Namen** für die Kontaktstelle ein. 1. Wählen **Sie unter Kontaktstellentyp** einen Typ und die darauf basierenden Pflichtfelder aus. Wenn du dich beispielsweise für Slack entscheidest, gib die Slack-Kanäle und Benutzer ein, die kontaktiert werden sollen. 1. Falls für den von dir ausgewählten Kontaktpunkt verfügbar, wähle optional die **Optionalen Einstellungen, um zusätzliche Einstellungen** festzulegen. 1. Wählen Sie unter **Benachrichtigungseinstellungen** optional die Option **Gelöste Nachricht deaktivieren** aus, wenn Sie nicht benachrichtigt werden möchten, wenn eine Warnung behoben wird. 1. Wenn Ihre Kontaktstelle mehr Kontaktpunkttypen benötigt, können Sie „**Neuer Kontaktpunkttyp**“ auswählen und die Schritte für jeden benötigten Kontaktpunkttyp wiederholen. 1. Wählen Sie **Kontaktpunkt speichern**, um Ihre Änderungen zu speichern. **Um eine Kontaktstelle zu bearbeiten** 1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen zu sehen. 1. Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift). 1. Nehmen Sie alle erforderlichen Änderungen vor und wählen Sie dann **Kontaktstelle speichern**, um Ihre Änderungen zu speichern. Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie richtig konfiguriert ist. **Um eine Testbenachrichtigung zu senden** 1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen. 1. Wählen Sie die Kontaktstelle aus, die Sie testen möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift). 1. Wählen Sie das **Testsymbol** (Papierflugzeug). 1. Wählen Sie aus, ob Sie eine vordefinierte Testbenachrichtigung senden möchten, oder wählen Sie **Benutzerdefiniert**, um der Testbenachrichtigung Ihre eigenen benutzerdefinierten Anmerkungen und Beschriftungen hinzuzufügen. 1. Wählen Sie **Testbenachrichtigung senden**, um die Warnung mit den angegebenen Kontaktpunkten zu testen. Sie können Kontaktpunkte löschen, die nicht von einer Benachrichtigungsrichtlinie verwendet werden. **Um eine Kontaktstelle zu löschen** 1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen. 1. Wählen Sie die Kontaktstelle aus, die Sie löschen möchten, und wählen Sie dann das **Löschen-Symbol** (Mülleimer). 1. Wählen Sie im Bestätigungsdialogfeld **Ja, löschen** aus. **Anmerkung** Wenn der Kontaktpunkt von einer Benachrichtigungsrichtlinie verwendet wird, müssen Sie die Benachrichtigungsrichtlinie löschen oder sie so bearbeiten, dass sie einen anderen Kontaktpunkt verwendet, bevor Sie den Kontaktpunkt löschen. ## Liste der unterstützten Notifier | Name | Typ | | --- | --- | | Amazon SNS | sns | | OpsGenie | opsgenie | | Pager Duty | pagerduty | | Slack | slack | | VictorOps | victorops | # Messaging-Vorlagen verwenden **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) *Benachrichtigungen, die über gesendet werden, [Mit Kontaktstellen arbeiten](alert-contact-points.md) werden mithilfe von Nachrichtenvorlagen 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). Da die meisten Kontaktpunktfelder mit Vorlagen versehen werden können, können Sie wiederverwendbare benutzerdefinierte Vorlagen erstellen und diese in mehreren Kontaktpunkten verwenden. Das [Vorlagendaten](#alert-template-data) Thema listet Variablen auf, die für die Erstellung von Vorlagen verfügbar sind. **Verwenden von Vorlagen** Vorlagen werden verwendet, um eine Nachricht zu erstellen. Bei einer Slack-Warnmeldung kannst du beispielsweise den Titel und den Text in der Kontaktstelle festlegen. Das folgende Beispiel zeigt, wie Sie mithilfe von Standardvorlagen einen Titel erstellen, der die Anzahl der ausgelösten und gelösten Alarme sowie einen Text enthält, in dem die Benachrichtigungen und ihr Status aufgeführt sind. + **Titel:** ``` {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved ``` + **Hauptteil des Textes**: ``` {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }} {{end }} ``` Sie können Ihre eigenen benutzerdefinierten Vorlagen erstellen, wie im folgenden Beispiel. + **Titel**: ``` {{ template "slack.default.title" .}} ``` + **Hauptteil des Textes**: ``` {{ template "mymessage" .}} ``` Im Folgenden finden Sie eine Beispielvorlage. ``` {{ define "myalert" }} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ if gt (len .Annotations) 0 }} Annotations: {{ range .Annotations.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ end }} {{ if gt (len .SilenceURL ) 0 }} Silence alert: {{ .SilenceURL }} {{ end }} {{ if gt (len .DashboardURL ) 0 }} Go to dashboard: {{ .DashboardURL }} {{ end }} {{ end }} ``` Die folgenden Verfahren zeigen, wie Sie benutzerdefinierte Nachrichtenvorlagen erstellen, bearbeiten und löschen. **Um eine Nachrichtenvorlage zu erstellen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Kontaktstellen.** 1. Wählen Sie in der **Alertmanager-Dropdownliste** die Alertmanager-Instanz aus, für die Sie eine Nachrichtenvorlage erstellen möchten. Die Standardeinstellung ist der Grafana Alertmanager. 1. **Wählen Sie Vorlage hinzufügen.** 1. Fügen Sie einen beschreibenden **Namen** hinzu. 1. Fügen Sie den **Inhalt** für die Vorlage hinzu, zum Beispiel: ``` {{ define "mymessage" }} {{ range .Alerts }} [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}} {{ end }} {{ end }} ``` Das `define` Tag im Abschnitt Inhalt weist den Namen der Vorlage zu. Dieses Tag ist optional, und wenn es weggelassen wird, wird der Vorlagenname aus dem Feld **Name** abgeleitet. Wenn beide angegeben sind, empfiehlt es sich, sie gleich zu lassen. 1. Wählen Sie **Save template** (Vorlage speichern). **Anmerkung** HTML in Vorlagen für Warnmeldungen wird als Text gerendert, wobei Steuerzeichen maskiert werden. Das Rendern von HTML in der resultierenden Benachrichtigung wird von Grafana nicht unterstützt. **So bearbeiten Sie eine Nachrichtenvorlage** 1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option **Kontaktstellen aus, um die Liste der Kontaktstellen** zu öffnen. 1. Suchen Sie in der **Vorlagentabelle** nach der Vorlage, die Sie bearbeiten möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift). 1. Nehmen Sie Ihre Änderungen vor und wählen Sie dann **Vorlage speichern**. **So löschen Sie eine Nachrichtenvorlage** 1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option **Kontaktstellen** aus, um die Liste der Kontaktstellen zu öffnen. 1. Suchen Sie in der **Vorlagentabelle** nach der Vorlage, die Sie entfernen möchten, und wählen Sie dann das Symbol **Löschen** (Mülleimer). 1. Wähle **Ja, löschen,** um die Vorlage zu löschen. **Verschachtelte Vorlagen** Sie können Vorlagen in andere Vorlagen einbetten. Sie können beispielsweise ein Vorlagenfragment mit dem folgenden `define` Schlüsselwort 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 die 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. | **Beispiele für benutzerdefinierte Vorlagen** Hier finden Sie Beispiele für die Verwendung benutzerdefinierter Vorlagen. Vorlage zum Rendern einer einzelnen Warnung: ``` {{ define "myalert" }} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ if gt (len .Annotations) 0 }} Annotations: {{ range .Annotations.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ end }} {{ if gt (len .SilenceURL ) 0 }} Silence alert: {{ .SilenceURL }} {{ end }} {{ if gt (len .DashboardURL ) 0 }} Go to dashboard: {{ .DashboardURL }} {{ end }} {{ end }} ``` Vorlage zum Rendern der gesamten Benachrichtigung: ``` {{ define "mymessage" }} {{ if gt (len .Alerts.Firing) 0 }} {{ len .Alerts.Firing }} firing: {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }} {{ end }} {{ if gt (len .Alerts.Resolved) 0 }} {{ len .Alerts.Resolved }} resolved: {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }} {{ end }} {{ end }} ``` ## Vorlagendaten Die folgenden Daten werden an Nachrichtenvorlagen übergeben. | Name | Typ | Hinweise | | --- | --- | --- | | `Receiver` | Zeichenfolge | Name der Kontaktstelle, an die die Benachrichtigung gesendet wird. | | `Status` | Zeichenfolge | ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben. | | `Alerts` | Warnung | Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten). | | `GroupLabels` | KeyValue | Labels, nach denen diese Alerts gruppiert wurden. | | `CommonLabels` | KeyValue | Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. | | `CommonAnnotations` | KeyValue | Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. | | `ExternalURL` | Zeichenfolge | Backlink zu der Grafana, die die Benachrichtigung gesendet hat. Wenn Sie einen externen Alertmanager verwenden, verlinken Sie zurück zu diesem Alertmanager. | Der `Alerts` Typ stellt zwei Funktionen zum Filtern der zurückgegebenen Warnungen zur Verfügung. + `Alerts.Firing`— Gibt eine Liste von Auslösewarnungen zurück. + `Alerts.Resolved`— Gibt eine Liste der behobenen Alarme zurück. **Warnung (Typ)** Der Warnungstyp enthält die folgenden Daten. | Name | Typ | Hinweise | | --- | --- | --- | | Status | Zeichenfolge | `firing` oder `resolved`. | | Labels | KeyValue | Eine Reihe von Bezeichnungen, die an die Warnung angehängt sind. | | Anmerkungen | KeyValue | Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. | | StartsAt | Zeit.Zeit | Uhrzeit, zu der der Alarm ausgelöst wurde. | | EndsAt | Zeit. Zeit | Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt. | | Generator-URL | Zeichenfolge | Ein Backlink zu Grafana oder einem externen Alertmanager. | | Silence-URL | Zeichenfolge | Link zu Grafana Silence for mit vorgefüllten Beschriftungen für diese Warnung. Nur für von Grafana verwaltete Benachrichtigungen. | | Dashboard-URL | Zeichenfolge | Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | | Panel-URL | Zeichenfolge | Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | | Fingerabdruck | Zeichenfolge | Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. | | ValueString | Zeichenfolge | Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. | **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 | | --- | --- | --- | --- | | SortedPairs | | Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert | | | Remove | [] Zeichenfolge | KeyValue | Gibt eine Kopie der Key/Value Map ohne die angegebenen Schlüssel zurück. | | Namen | | [] Zeichenfolge | Liste der Labelnamen | | Werte | | [] Zeichenfolge | Liste der Labelwerte | ## Funktionen der Vorlage Mithilfe von Vorlagenfunktionen können Sie Beschriftungen und Anmerkungen verarbeiten, um dynamische Benachrichtigungen zu generieren. Die folgenden Funktionen sind verfügbar. | Name | Argumenttyp | Rückgabetyp | Description | | --- | --- | --- | --- | | `humanize` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format. | | `humanize1024` | Zahl oder Zeichenfolge | Zeichenfolge | Wie Humanize, verwendet aber 1024 statt 1000 als Basis. | | `humanizeDuration` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Dauer in Sekunden in ein besser lesbares Format. | | `humanizePercentage` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Verhältniswert in einen Bruchteil von 100. | | `humanizeTimestamp` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format. | | `title` | Zeichenfolge | Zeichenfolge | Strings.Title schreibt das erste Zeichen jedes Worts groß. | | `toUpper` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um. | | `toLower` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um. | | `match` | Muster, Text | boolesch | Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung. | | `reReplaceAll` | Muster, Ersatz, Text | Zeichenfolge | Regexp. ReplaceAllString Regexp-Substitution, nicht verankert. | | `graphLink` | string — JSON-Objekt mit Feldern und `expr` `datasource` | Zeichenfolge | Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. | | `tableLink` | string — JSON-Objekt mit `datasource` Feldern `expr` und | Zeichenfolge | Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. | | `args` | [] Schnittstelle \$1\$1 | map [string] Schnittstelle \$1\$1 | Konvertiert eine Liste von Objekten in eine Map mit Schlüsseln, zum Beispiel arg0, arg1. Verwenden Sie diese Funktion, um mehrere Argumente an Vorlagen zu übergeben. | | `externalURL` | nichts | Zeichenfolge | Gibt eine Zeichenfolge zurück, die die externe URL darstellt. | | `pathPrefix` | nichts | Zeichenfolge | Gibt den Pfad der externen URL zurück. | Die folgende Tabelle zeigt Beispiele für die Verwendung der einzelnen Funktionen. | Funktion | TemplateString | Input | Expected | | --- | --- | --- | --- | | humanisieren | \$1\$1value humanisieren\$1 | 1234567,0 | 1,235 M | | humanisieren Sie 1024 | \$1humanise1024 \$1value\$1 | 1048576,0 | 1 Minuten | | Dauer humanisieren | \$1humanizeDuration \$1value\$1 | 899,99 | 14 m 59 s | | Prozentsatz humanisieren | \$1HumanizePercentage \$1value\$1 | 0,1234567 | 12,35% | | Zeitstempel humanisieren | \$1HumanizeTimestamp \$1value\$1 | 1435065584,128 | 2015-06-23 13:19:44.128 \$10000 UTC | | Titel | \$1\$1wert \$1 Titel\$1 | ein B C | Ein Bb Cc | | toUpper | \$1\$1value \$1 toUpper\$1 | ein B C | EIN B C | | toLower | \$1\$1value \$1 toLower\$1 | ein B C | ein b c | | match | \$1entspricht „a\$1“ \$1labels.instance\$1 | aa | true | | reReplaceAll | \$1\$1 reReplaceAll „localhost :( .\$1)“ „meine.domain: \$11“ \$1labels.instance\$1\$1 | localhost: 3000 | meine.domain: 3000 | | GraphLink | \$1\$1GraphLink „\$1\$1" expr\$1“:\$1 "hoch\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :false, "range“ :true\$1] | | Link zur Tabelle | \$1\$1TableLink „\$1\$1" expr\$1“:\$1 "nach oben\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :true, "range“ :false\$1] | | args | \$1\$1definiere „x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1Vorlage „x“ (Argumente 1 „2")\$1\$1 | | 1 2 | | Externe URL | \$1externe URL\$1 | | http://localhost/path/prefix | | Pfad-Präfix | \$1Pfadpräfix\$1 | | /Pfad/Präfix | # Mit Benachrichtigungsrichtlinien arbeiten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 8.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Benachrichtigungsrichtlinien bestimmen, wie Warnmeldungen an Kontaktstellen weitergeleitet werden. Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere untergeordnete Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Stammrichtlinie, kann auch bestimmten Warnbezeichnungen entsprechen. Jede Warnung wird anhand der Stammrichtlinie und anschließend anhand jeder untergeordneten Richtlinie bewertet. Wenn Sie die `Continue matching subsequent sibling nodes` Option für eine bestimmte Richtlinie aktivieren, wird die Auswertung auch nach einer oder mehreren Übereinstimmungen fortgesetzt. Die Konfigurationseinstellungen und Kontaktpunktinformationen einer übergeordneten Richtlinie regeln das Verhalten einer Warnung, die keiner der untergeordneten Richtlinien entspricht. Eine Stammrichtlinie regelt jede Warnung, die keiner bestimmten Richtlinie entspricht. **Anmerkung** Sie können Benachrichtigungsrichtlinien für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Benachrichtigungsrichtlinien für Alertmanager-Benachrichtigungen sind schreibgeschützt. **Benachrichtigungen gruppieren** Durch die Gruppierung werden Warnmeldungen ähnlicher Art in einem einzigen Trichter kategorisiert. Auf diese Weise können Sie die Warnmeldungen bei größeren Ausfällen steuern, wenn viele Teile eines Systems gleichzeitig ausfallen und dadurch eine große Anzahl von Alarmen gleichzeitig ausgelöst wird. **Beispiel für eine Gruppierung** Angenommen, Sie haben 100 Dienste in verschiedenen Umgebungen mit einer Datenbank verbunden. Diese Dienste unterscheiden sich anhand der Bezeichnung`env=environmentname`. Es gibt eine Warnregel, mit der überwacht wird, ob Ihre Dienste die Datenbank erreichen können. Die Warnungsregel erstellt Warnungen mit dem Namen`alertname=DatabaseUnreachable`. Wenn eine Netzwerkpartition auftritt, bei der die Hälfte Ihrer Dienste die Datenbank nicht mehr erreichen kann, werden 50 verschiedene Warnungen ausgelöst. In diesem Fall möchten Sie eine einseitige Benachrichtigung (statt 50) mit einer Liste der betroffenen Umgebungen erhalten. Sie können die Gruppierung so konfigurieren `group_by: [alertname]` (ohne die `env` Bezeichnung zu verwenden, die für jeden Dienst unterschiedlich ist). Wenn diese Konfiguration eingerichtet ist, sendet Grafana eine einzige kompakte Benachrichtigung, die alle betroffenen Umgebungen für diese Warnregel enthält. **Spezielle Gruppen** Grafana hat zwei spezielle Gruppen. Die Standardgruppe `group_by: null` gruppiert *alle* Alarme in einer einzigen Gruppe. Sie können auch eine spezielle Bezeichnung verwenden, um Benachrichtigungen `...` nach allen Bezeichnungen zu gruppieren, wodurch die Gruppierung effektiv deaktiviert wird und jede Warnung in eine eigene Gruppe gesendet wird. ## Working with notifications Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten. **Um die Root-Benachrichtigungsrichtlinie zu bearbeiten** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. Wählen Sie im Bereich **Root-Richtlinie** das Symbol **Bearbeiten** (Stift) aus. 1. Aktualisieren **Sie unter Standardkontaktpunkt** die Kontaktstelle, an die Benachrichtigungen für Regeln gesendet werden sollen, wenn die Warnungsregeln keiner bestimmten Richtlinie entsprechen. 1. Wählen Sie unter **Gruppieren nach** die Labels (oder speziellen Gruppen) aus, nach denen Benachrichtigungen gruppiert werden sollen. 1. Wählen Sie **unter Zeitoptionen** eine der folgenden Optionen aus. + **Wartezeit für Gruppen** — Wartezeit bis zum Zwischenspeichern von Warnmeldungen derselben Gruppe, bevor eine erste Benachrichtigung gesendet wird. Standardmäßig ist ein Zeitraum von 30 Sekunden festgelegt. + **Gruppenintervall** — Minimales Zeitintervall zwischen zwei Benachrichtigungen für eine Gruppe. Der Standardwert ist 5 Minuten. + **Wiederholungsintervall** — Minimales Zeitintervall vor dem erneuten Senden einer Benachrichtigung, wenn der Gruppe keine neuen Benachrichtigungen hinzugefügt wurden. Die Standardeinstellung ist 4 Stunden. 1. Wählen Sie **Speichern**, um Ihre Änderungen zu speichern. **Um eine neue, spezifische Richtlinie auf oberster Ebene hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. **Wählen Sie im Abschnitt **Spezifisches Routing die Option Neue spezifische** Richtlinie aus.** 1. **Fügen Sie im Abschnitt Passende Labels** ein oder mehrere passende Warnungslabels hinzu. Weitere Informationen zum Abgleich von Bezeichnungen finden Sie weiter unten in diesem Thema. 1. Fügen **Sie unter Kontaktpunkt** die Kontaktstelle hinzu, an die Benachrichtigungen gesendet werden sollen, wenn die Warnung dieser speziellen Richtlinie entspricht. Verschachtelte Richtlinien haben Vorrang vor dieser Kontaktstelle. 1. Wählen Sie optional **Gruppierung überschreiben** aus, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet. 1. Wählen Sie optional **Allgemeine Zeitangaben außer Kraft setzen, um** die Zeitoptionen in der Gruppenbenachrichtigungsrichtlinie außer Kraft zu setzen. 1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern. **Um eine verschachtelte Richtlinie hinzuzufügen** 1. Erweitern Sie die spezifische Richtlinie, unter der Sie eine verschachtelte Richtlinie erstellen möchten. 1. Wählen Sie **Verschachtelte Richtlinie hinzufügen** und fügen Sie dann die Details hinzu (wie beim Hinzufügen einer spezifischen Richtlinie der obersten Ebene). 1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern. **Um eine bestimmte Richtlinie zu bearbeiten** 1. Wählen Sie auf der Seite „**Benachrichtigungen**“ die Option **Benachrichtigungsrichtlinien** aus, um die Seite mit den vorhandenen Richtlinien zu öffnen. 1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und klicken Sie dann auf das Symbol **Bearbeiten** (Stift). 1. Nehmen Sie alle Änderungen vor (z. B. beim Hinzufügen einer spezifischen Richtlinie auf oberster Ebene). 1. Wählen Sie **Richtlinie speichern**. **So funktioniert der Labelabgleich** Eine Richtlinie entspricht einer Warnung, wenn die Bezeichnungen der Warnung mit allen in der Richtlinie angegebenen *übereinstimmenden Labels* übereinstimmen. + **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen. + **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind: + `=`Wählen Sie Beschriftungen aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt. + `!=`Wählen Sie Beschriftungen aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert). + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen. + **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen. ## Timings stummschalten Eine Stummschaltung ist ein wiederkehrendes Zeitintervall, in dem keine neuen Benachrichtigungen für eine Richtlinie generiert oder gesendet werden. Verwenden Sie sie, um zu verhindern, dass Warnmeldungen für einen bestimmten und sich wiederholenden Zeitraum ausgelöst werden, z. B. während eines regulären Wartungszeitraums. Ähnlich wie bei Stummschaltungen verhindern auch Stummschaltungen nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern auch nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Sie verhindern lediglich, dass Benachrichtigungen erstellt werden. Sie können von Grafana verwaltete Stummschaltezeiten sowie Stummschaltezeiten für eine externe Alertmanager-Datenquelle konfigurieren. **Stummschaltungen im Vergleich zu Stummschaltungen** In der folgenden Tabelle werden die Unterschiede zwischen Stummschaltezeiten und Stummschaltungen hervorgehoben. | Timing stummschalten | 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 sie stummgeschaltet werden soll oder nicht | **Um ein Timing zum Stummschalten zu erstellen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. **Wählen Sie im Bereich **Timings für die Stummschaltung die Schaltfläche Timing** für Stummschaltung hinzufügen aus.** 1. Wählen Sie das Zeitintervall aus, für das die Stummschaltung gelten soll. 1. Wählen Sie „**Senden**“, um die Stummschaltung festzulegen. **Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen** 1. Wählen Sie die Benachrichtigungsrichtlinie aus, zu der Sie die Stummschaltung hinzufügen möchten, und klicken Sie auf die Schaltfläche **Bearbeiten**. 1. Wählen Sie in der Dropdownliste **für** die Dauer der Stummschaltung die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten. Wählen Sie die Schaltfläche Richtlinie **speichern**. **Zeitintervalle** Ein Zeitintervall ist eine Definition für einen Zeitbereich. Wenn während dieses Intervalls eine Warnung ausgelöst wird, wird sie unterdrückt. Bereiche werden unterstützt mit `:` (zum Beispiel`monday:thursday`). Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten. Ein Zeitintervall besteht aus mehreren Feldern (Details in der folgenden Liste), die alle übereinstimmen müssen, damit die Alerts unterdrückt werden. Wenn Sie beispielsweise Wochentage `monday:friday` und einen Zeitraum von 8:00 bis 9:00 Uhr angeben, werden Benachrichtigungen von Montag bis Freitag von 8 bis 9 Uhr unterdrückt, aber nicht beispielsweise von 8 bis 9 Uhr am Samstag. + **Zeitraum** — Die Tageszeit, zu der Benachrichtigungen unterdrückt werden sollen. Besteht aus zwei Unterfeldern: **Startzeit** und **Endzeit.** Ein Beispiel für die Zeit ist`14:30`. Die Uhrzeit wird in 24-Stunden-Notation in UTC angegeben. + **Wochentage** — Die Wochentage. Dabei kann es sich um einen einzelnen Tag handeln`monday`, z. B. um einen Bereich`monday:friday`, oder um eine durch Kommas getrennte Liste von Tagen, z. B. `monday, tuesday, wednesday` + **Monate** — Die Monate, die ausgewählt werden sollen. Sie können Monate mit numerischen Bezeichnungen oder mit dem vollständigen Monatsnamen angeben, `1` oder `january` beide geben Januar an. Sie können einen einzelnen Monat, einen Bereich von Monaten oder eine durch Kommas getrennte Liste von Monaten angeben. + **Tage des Monats** — Die Daten innerhalb eines Monats. Die Werte können im Bereich von `1` - liegen`31`. Negative Werte geben die Tage des Monats in umgekehrter Reihenfolge an, `-1` stellen also den letzten Tag des Monats dar. Tage des Monats können als einzelner Tag, als Bereich von Tagen oder als durch Kommas getrennte Liste von Tagen angegeben werden.