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. # Verwalte deine Warnmeldungen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Die Entscheidung, wie, wann und wohin Ihre Warnmeldungen gesendet werden sollen, ist ein wichtiger Bestandteil der Einrichtung Ihres Warnsystems. Diese Entscheidungen wirken sich direkt auf Ihre Fähigkeit aus, Probleme schnell zu lösen und nichts Wichtiges zu verpassen. Definieren Sie als ersten Schritt Ihre *Kontaktstellen* und an wen Sie Ihre Warnmeldungen senden möchten. Bei einer Kontaktstelle kann es sich um eine Reihe von Zielen für passende Benachrichtigungen handeln. Fügen Sie Benachrichtigungsvorlagen zu Kontaktpunkten hinzu, um sie wiederzuverwenden und die Nachrichtenübermittlung in Ihren Benachrichtigungen einheitlich zu gestalten. Erstellen Sie als Nächstes eine *Benachrichtigungsrichtlinie*. Dabei handelt es sich um eine Reihe von Regeln dafür, wo, wann und wie Ihre Benachrichtigungen an Kontaktstellen weitergeleitet werden. In einer Benachrichtigungsrichtlinie definieren Sie, wohin Ihre Warnmeldungen gesendet werden sollen, indem Sie eine der von Ihnen erstellten Kontaktstellen auswählen. Fügen Sie Ihrer Benachrichtigungsrichtlinie Zeiten für die Stummschaltung hinzu. Eine *Stummschaltung* ist ein wiederkehrendes Zeitintervall, in dem du nicht möchtest, dass Benachrichtigungen versendet werden. Wenn eine Warnungsregel ausgewertet wird, sendet die Warnmeldungsinstanz Warninstanzen an den Alertmanager — eine Warnungsregel kann mehrere einzelne *Warnungsinstanzen* auslösen. Der Alertmanager empfängt diese Warnungsinstanzen und kümmert sich dann um die Stummschaltung, gruppiert Alarme und sendet Benachrichtigungen an Ihre Kontaktstellen, wie in der Benachrichtigungsrichtlinie definiert. **Topics** + [Alert-Manager](v9-alerting-managenotifications-alertmanager.md) + [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md) + [Mit Benachrichtigungsrichtlinien arbeiten](v9-alerting-notification-policies.md) + [Benachrichtigungen anpassen](v9-alerting-notifications.md) + [Stummschalten von Warnmeldungen für Prometheus-Datenquellen](v9-alerting-silences.md) + [Timings stummschalten](v9-alerting-notification-muting.md) + [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v9-alerting-viewfiltergroups.md) + [Benachrichtigungsfehler anzeigen](v9-alerting-viewnotificationerrors.md) # Alert-Manager **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Mit Alertmanager können Sie Warnmeldungen schnell und effizient verwalten und darauf reagieren. Er empfängt Benachrichtigungen, kümmert sich um Stummschaltung, Sperrung, Gruppierung und Weiterleitung, indem er Benachrichtigungen über den Kanal Ihrer Wahl versendet, z. B. E-Mail oder Slack. In Grafana können Sie den Grafana Alertmanager oder einen externen Alertmanager verwenden. Sie können auch mehrere Alertmanager ausführen. Ihre Entscheidung hängt von Ihrer Einrichtung ab und davon, wo Ihre Benachrichtigungen generiert werden. **Grafana Alarmmanager** Grafana Alertmanager ist ein interner Alertmanager, der vorkonfiguriert ist und standardmäßig ausgewählt werden kann, wenn Sie Grafana vor Ort oder als Open Source ausführen. Der Grafana Alertmanager kann Benachrichtigungen von Grafana empfangen, aber er kann keine Benachrichtigungen von außerhalb von Grafana empfangen, z. B. von Mimir oder Loki. **Anmerkung** Inhibitionsregeln werden im Grafana Alertmanager nicht unterstützt. **Externer Alertmanager** Wenn Sie einen einzigen Alertmanager verwenden möchten, um alle Ihre Grafana-, Loki-, Mimir- und Prometheus-Benachrichtigungen zu erhalten, können Sie Grafana so einrichten, dass ein externer Alertmanager verwendet wird. Dieser externe Alertmanager kann in Grafana selbst konfiguriert und verwaltet werden. Hier sind zwei Beispiele dafür, wann Sie vielleicht Ihren eigenen externen Alertmanager konfigurieren und Ihre Benachrichtigungen anstelle des Grafana-Alertmanagers dorthin senden möchten: 1. Sie haben bereits Alertmanager vor Ort in Ihrer eigenen Cloud-Infrastruktur, die Sie eingerichtet haben und weiterhin verwenden möchten, da Sie über andere Alert-Generatoren wie Prometheus verfügen. 1. Sie möchten sowohl Prometheus vor Ort als auch gehostetes Grafana verwenden, um Benachrichtigungen an denselben Alertmanager zu senden, der in Ihrer Cloud-Infrastruktur ausgeführt wird. Alertmanager sind im Drop-down-Menü auf den Seiten Alerting Contact Points und Notification Policies sichtbar. Wenn Sie Ihre Datenquelle bereitstellen, setzen Sie die Markierung `handleGrafanaManagedAlerts` im `jsonData` Feld auf, um von Grafana verwaltete Benachrichtigungen an diesen Alertmanager `true` zu senden. # Mit Kontaktstellen arbeiten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnung ausgelöst wird. Eine Kontaktstelle kann über eine oder mehrere Kontaktpunktintegrationen verfügen, z. B. Amazon Simple Notification Service oder Slack. Wenn eine Warnung ausgelöst wird, wird eine Benachrichtigung an alle Kontaktpunkt-Integrationen gesendet, die für eine Kontaktstelle aufgeführt sind. Verwenden Sie optional [Benachrichtigungsvorlagen](v9-alerting-create-templates.md), um die Benachrichtigungen an die Kontaktpunkttypen anzupassen. **Anmerkung** Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktpunkte für Alertmanager-Benachrichtigungen sind schreibgeschützt. ## Mit Kontaktpunkten arbeiten In den folgenden Verfahren wird detailliert beschrieben, wie Kontaktpunkte hinzugefügt, bearbeitet, getestet und gelöscht werden. **Um eine Kontaktstelle hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.** 1. **Wählen Sie **Kontaktpunkte** und dann Kontaktstelle hinzufügen.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt. 1. Geben Sie einen **Namen** für die Kontaktstelle ein. 1. Wählen **Sie unter Kontaktpunktintegration** einen Typ und die darauf basierenden Pflichtfelder aus. Wenn du dich beispielsweise für Slack entscheidest, gib die Slack-Kanäle und Benutzer ein, die kontaktiert werden sollen. 1. Falls für den von dir ausgewählten Kontaktpunkt verfügbar, wähle die gewünschten **optionalen Einstellungen, um zusätzliche Einstellungen** festzulegen. 1. Wählen Sie unter **Benachrichtigungseinstellungen** optional die Option **Gelöste Nachricht deaktivieren** aus, wenn Sie nicht benachrichtigt werden möchten, wenn eine Warnung behoben wird. 1. Wenn Ihre Kontaktstelle mehr Kontaktpunkttypen benötigt, können Sie **Kontaktpunktintegration hinzufügen** auswählen und die Schritte für jeden benötigten Kontaktpunkttyp wiederholen. 1. Wählen Sie **Kontaktpunkt speichern**, um Ihre Änderungen zu speichern. **Um eine Kontaktstelle zu bearbeiten** 1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen zu sehen. 1. Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift). 1. Nehmen Sie alle erforderlichen Änderungen vor und wählen Sie dann **Kontaktstelle speichern**, um Ihre Änderungen zu speichern. Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie ordnungsgemäß konfiguriert ist. **Um eine Testbenachrichtigung zu senden** 1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen. 1. Wählen Sie die Kontaktstelle aus, die Sie testen möchten, und wählen Sie dann das **Bearbeiten-Symbol** (Stift). 1. Wählen Sie das **Testsymbol** (Papierflugzeug). 1. Wählen Sie aus, ob Sie eine vordefinierte Testbenachrichtigung senden möchten, oder wählen Sie **Benutzerdefiniert**, um der Testbenachrichtigung Ihre eigenen benutzerdefinierten Anmerkungen und Beschriftungen hinzuzufügen. 1. Wählen Sie **Testbenachrichtigung senden**, um die Warnung mit den angegebenen Kontaktpunkten zu testen. Sie können Kontaktpunkte löschen, die nicht von einer Benachrichtigungsrichtlinie verwendet werden. **Um eine Kontaktstelle zu löschen** 1. Wählen Sie **Kontaktstellen**, um die Liste der vorhandenen Kontaktstellen zu öffnen. 1. Wählen Sie die Kontaktstelle aus, die Sie löschen möchten, und wählen Sie dann das **Löschen-Symbol** (Mülleimer). 1. Wählen Sie im Bestätigungsdialogfeld **Ja, löschen** aus. **Anmerkung** Wenn der Kontaktpunkt von einer Benachrichtigungsrichtlinie verwendet wird, müssen Sie die Benachrichtigungsrichtlinie löschen oder sie so bearbeiten, dass sie einen anderen Kontaktpunkt verwendet, bevor Sie den Kontaktpunkt löschen. ## Liste der unterstützten Notifier | Name | Typ | | --- | --- | | Amazon SNS | sns | | OpsGenie | opsgenie | | Pager Duty | pagerduty | | Slack | slack | | VictorOps | victorops | # Mit Benachrichtigungsrichtlinien arbeiten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Benachrichtigungsrichtlinien bestimmen, wie Warnmeldungen an Kontaktstellen weitergeleitet werden. Richtlinien haben eine Baumstruktur, wobei jede Richtlinie eine oder mehrere untergeordnete Richtlinien haben kann. Jede Richtlinie, mit Ausnahme der Stammrichtlinie, kann auch bestimmten Warnmeldungsbezeichnungen entsprechen. Jede Warnung wird anhand der Stammrichtlinie und anschließend anhand jeder untergeordneten Richtlinie bewertet. Wenn Sie die `Continue matching subsequent sibling nodes` Option für eine bestimmte Richtlinie aktivieren, wird die Auswertung auch nach einer oder mehreren Übereinstimmungen fortgesetzt. Die Konfigurationseinstellungen und Kontaktpunktinformationen einer übergeordneten Richtlinie regeln das Verhalten einer Warnung, die keiner der untergeordneten Richtlinien entspricht. Eine Stammrichtlinie regelt jede Warnung, die keiner bestimmten Richtlinie entspricht. **Anmerkung** Sie können Benachrichtigungsrichtlinien für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Benachrichtigungsrichtlinien für Alertmanager-Benachrichtigungen sind schreibgeschützt. **Benachrichtigungen gruppieren** Durch die Gruppierung werden Warnmeldungen ähnlicher Art in einem einzigen Trichter kategorisiert. Auf diese Weise können Sie die Warnmeldungen bei größeren Ausfällen steuern, wenn viele Teile eines Systems gleichzeitig ausfallen und dadurch eine große Anzahl von Alarmen gleichzeitig ausgelöst wird. **Beispiel für eine Gruppierung** Angenommen, Sie haben 100 Dienste in verschiedenen Umgebungen mit einer Datenbank verbunden. Diese Dienste unterscheiden sich anhand der Bezeichnung`env=environmentname`. Es gibt eine Warnregel, mit der überwacht wird, ob Ihre Dienste die Datenbank erreichen können. Die Warnungsregel erstellt Warnungen mit dem Namen`alertname=DatabaseUnreachable`. Wenn eine Netzwerkpartition auftritt, bei der die Hälfte Ihrer Dienste die Datenbank nicht mehr erreichen kann, werden 50 verschiedene Warnungen ausgelöst. In diesem Fall möchten Sie eine einseitige Benachrichtigung (statt 50) mit einer Liste der betroffenen Umgebungen erhalten. Sie können die Gruppierung so konfigurieren `group_by: [alertname]` (ohne die `env` Bezeichnung zu verwenden, die für jeden Dienst unterschiedlich ist). Wenn diese Konfiguration eingerichtet ist, sendet Grafana eine einzige kompakte Benachrichtigung, die alle betroffenen Umgebungen für diese Warnregel enthält. **Spezielle Gruppen** Grafana hat zwei spezielle Gruppen. Die Standardgruppe `group_by: null` gruppiert *alle* Alarme in einer einzigen Gruppe. Sie können auch eine spezielle Bezeichnung verwenden, um Benachrichtigungen `...` nach allen Bezeichnungen zu gruppieren, wodurch die Gruppierung effektiv deaktiviert wird und jede Warnung in eine eigene Gruppe gesendet wird. ## Working with notifications Die folgenden Verfahren zeigen Ihnen, wie Sie Benachrichtigungsrichtlinien erstellen und verwalten. **Um die Root-Benachrichtigungsrichtlinie zu bearbeiten** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien aus.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. Wählen Sie im Bereich **Root-Richtlinie** das Symbol **Bearbeiten** (Stift) aus. 1. Aktualisieren **Sie unter Standardkontaktpunkt** die Kontaktstelle, an die Benachrichtigungen für Regeln gesendet werden sollen, wenn die Warnungsregeln keiner bestimmten Richtlinie entsprechen. 1. Wählen Sie unter **Gruppieren nach** die Labels (oder speziellen Gruppen) aus, nach denen Benachrichtigungen gruppiert werden sollen. 1. Wählen Sie **unter Zeitoptionen** eine der folgenden Optionen aus. + **Wartezeit für Gruppen** — Wartezeit bis zum Zwischenspeichern von Warnmeldungen derselben Gruppe, bevor eine erste Benachrichtigung gesendet wird. Standardmäßig ist ein Zeitraum von 30 Sekunden festgelegt. + **Gruppenintervall** — Minimales Zeitintervall zwischen zwei Benachrichtigungen für eine Gruppe. Der Standardwert ist 5 Minuten. + **Wiederholungsintervall** — Minimales Zeitintervall vor dem erneuten Senden einer Benachrichtigung, wenn der Gruppe keine neuen Benachrichtigungen hinzugefügt wurden. Die Standardeinstellung ist 4 Stunden. 1. Wählen Sie **Speichern**, um Ihre Änderungen zu speichern. **Um eine neue, spezifische Richtlinie auf oberster Ebene hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien aus.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. **Wählen Sie im Abschnitt **Spezifisches Routing die Option Neue spezifische** Richtlinie aus.** 1. **Fügen Sie im Abschnitt Passende Labels** ein oder mehrere passende Warnungslabels hinzu. Weitere Informationen zum Abgleich von Bezeichnungen finden Sie weiter unten in diesem Thema. 1. Fügen **Sie unter Kontaktpunkt** die Kontaktstelle hinzu, an die Benachrichtigungen gesendet werden sollen, wenn die Warnung dieser speziellen Richtlinie entspricht. Verschachtelte Richtlinien haben Vorrang vor dieser Kontaktstelle. 1. Aktivieren Sie optional die Option Mit dem **Abgleich aufeinanderfolgender gleichgeordneter Knoten** fortfahren, um den Abgleich von Richtlinien für gleichgeordnete Knoten auch dann fortzusetzen, wenn die Warnung mit der aktuellen Richtlinie übereinstimmt. Wenn diese Richtlinie aktiviert ist, können Sie mehr als eine Benachrichtigung für dieselbe Warnung erhalten. 1. Wählen Sie optional **Gruppierung überschreiben**, um eine Gruppierung anzugeben, die sich von der Stammrichtlinie unterscheidet. 1. Wählen Sie optional **Allgemeine Zeitangaben außer Kraft setzen, um** die Zeitoptionen in der Gruppenbenachrichtigungsrichtlinie außer Kraft zu setzen. 1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern. **Um eine verschachtelte Richtlinie hinzuzufügen** 1. Erweitern Sie die spezifische Richtlinie, unter der Sie eine verschachtelte Richtlinie erstellen möchten. 1. Wählen Sie **Verschachtelte Richtlinie hinzufügen** und fügen Sie dann die Details hinzu (wie beim Hinzufügen einer spezifischen Richtlinie der obersten Ebene). 1. Wählen Sie **Richtlinie speichern** aus, um Ihre Änderungen zu speichern. **Um eine bestimmte Richtlinie zu bearbeiten** 1. Wählen Sie auf der Seite „**Benachrichtigungen**“ die Option **Benachrichtigungsrichtlinien** aus, um die Seite mit den vorhandenen Richtlinien zu öffnen. 1. Wählen Sie die Richtlinie aus, die Sie bearbeiten möchten, und klicken Sie dann auf das Symbol **Bearbeiten** (Stift). 1. Nehmen Sie alle Änderungen vor (z. B. beim Hinzufügen einer spezifischen Richtlinie auf oberster Ebene). 1. Wählen Sie **Richtlinie speichern**. **Auf der Suche nach Richtlinien** Sie können im Richtlinienbaum nach *Label-Matchern* oder *Kontaktstellen* suchen. + Um nach Kontaktstelle zu suchen, geben Sie einen vollständigen oder vollständigen Namen einer Kontaktstelle in das Feld **Nach Kontaktstelle suchen** ein. + Um nach Label zu suchen, geben Sie einen gültigen Label-Matcher in das Feld **Nach Label suchen** ein. Es können mehrere Matcher eingegeben werden, getrennt durch ein Komma. Eine gültige Matcher-Eingabe könnte beispielsweise sein. `severity=high, region=~EMEA|NA` **Anmerkung** Bei der Suche nach Bezeichnungen werden alle übereinstimmenden Richtlinien exakt übereinstimmen. Partielle Übereinstimmungen und Übereinstimmungen im Regex-Stil werden nicht unterstützt. **So funktioniert der Labelabgleich** Eine Richtlinie entspricht einer Warnung, wenn die Bezeichnungen der Warnung mit allen in der Richtlinie angegebenen *übereinstimmenden Labels* übereinstimmen. + **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen. + **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind: + `=`Wählen Sie Beschriftungen aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt. + `!=`Wählen Sie Beschriftungen aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert). + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen. + **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen. # Benachrichtigungen anpassen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Passen Sie Ihre Benachrichtigungen mit Vorlagen für Benachrichtigungen an. Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und das Format der Nachricht in Ihren Benachrichtigungen zu ändern. Benachrichtigungsvorlagen sind nicht an bestimmte Kontaktpunkt-Integrationen wie E-Mail oder Slack gebunden. Sie können sich jedoch dafür entscheiden, separate Benachrichtigungsvorlagen für verschiedene Kontaktpunkt-Integrationen zu erstellen. Sie können Benachrichtigungsvorlagen verwenden, um: + Informationen in der Benachrichtigung hinzufügen, entfernen oder neu anordnen, einschließlich Zusammenfassung, Beschreibung, Beschriftungen und Anmerkungen, Werten und Links + Formatieren Sie Text fett und kursiv und fügen Sie Zeilenumbrüche hinzu oder entfernen Sie sie Sie können Benachrichtigungsvorlagen nicht verwenden, um: + Ändern Sie das Design von Benachrichtigungen in Instant-Messaging-Diensten wie Slack und Microsoft Teams **Topics** + [Verwendung der Template-Sprache von Go](v9-alerting-notifications-go-templating.md) + [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md) + [Vorlage – Referenz](v9-alerting-template-reference.md) # Verwendung der Template-Sprache von Go **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) [Sie schreiben Benachrichtigungsvorlagen in der Vorlagensprache von Go, Text/Vorlage.](https://pkg.go.dev/text/template) Dieser Abschnitt bietet einen Überblick über die Vorlagensprache von Go und das Schreiben von Vorlagen in Text/Vorlage. ## Punkt Darin text/template befindet sich ein spezieller Cursor namens Punkt, der als geschrieben wird`.`. Sie können sich diesen Cursor als eine Variable vorstellen, deren Wert sich ändert, je nachdem, wo in der Vorlage er verwendet wird. Beispielsweise `.` bezieht sich eine Benachrichtigungsvorlage zu Beginn auf das `ExtendedData` Objekt, das eine Reihe von Feldern enthält`Alerts`, darunter `Status``GroupLabels`,`CommonLabels`, `CommonAnnotations` und`ExternalURL`. Punkt kann sich jedoch auf etwas anderes beziehen, wenn es in einer Liste verwendet wird, wenn `range` es in einer Liste verwendet wird, wenn es innerhalb einer verwendet wird oder wenn Feature-Vorlagen geschrieben werden`with`, die in anderen Vorlagen verwendet werden sollen. Beispiele dafür finden Sie in [Vorlagen für Benachrichtigungen erstellen](v9-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v9-alerting-template-reference.md). ## Tags öffnen und schließen In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}` ## Print (Ausgabe) Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können den Wert eines Punkts, ein Punktfeld, das Ergebnis einer Funktion und den Wert einer [Variablen](#v9-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben: ``` {{ .Alerts }} ``` ## Iterieren Sie über Warnmeldungen Um nur die Beschriftungen jeder Warnung und nicht alle Informationen über die Warnung zu drucken, können Sie a verwenden, um die Warnungen in `range` folgenden Schritten zu iterieren: `ExtendedData` ``` {{ range .Alerts }} {{ .Labels }} {{ end }} ``` Innerhalb des Bereichs bezieht sich der Punkt nicht mehr auf`ExtendedData`, sondern auf eine`Alert`. Sie können `{{ .Labels }}` es verwenden, um die Beschriftungen der einzelnen Warnmeldungen zu drucken. Das funktioniert, weil `{{ range .Alerts }}` sich der Punkt so ändert, dass er sich auf die aktuelle Warnung in der Liste der Benachrichtigungen bezieht. Wenn der Bereich abgeschlossen ist, wird der Punkt auf den Wert zurückgesetzt, den er vor dem Beginn des Bereichs hatte. In diesem Beispiel ist das`ExtendedData`: ``` {{ range .Alerts }} {{ .Labels }} {{ end }} {{/* does not work, .Labels does not exist here */}} {{ .Labels }} {{/* works, cursor was reset */}} {{ .Status }} ``` ## Iterieren Sie über Anmerkungen und Beschriftungen Lassen Sie uns eine Vorlage schreiben, um die Beschriftungen jeder Warnung in dem Format zu drucken`The name of the label is $name, and the value is $value`, in dem sie den Namen `$name` und den Wert jedes Labels `$value` enthalten. Verwenden Sie wie im vorherigen Beispiel einen Bereich, um über die Warnungen zu iterieren, sodass der Punkt auf die aktuelle Warnung in der Liste der Warnungen verweist, und verwenden Sie dann einen zweiten Bereich für die sortierten Beschriftungen, sodass der Punkt ein zweites Mal aktualisiert wird, sodass er auf das aktuelle Label verweist. `.Alerts` Verwenden Sie innerhalb des zweiten Bereichs `.Name` und`.Value`, um den Namen und den Wert jedes Labels zu drucken: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} The name of the label is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ range .Annotations.SortedPairs }} The name of the annotation is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ end }} ``` ## Wenn Aussagen Sie können if-Anweisungen in Vorlagen verwenden. Um beispielsweise zu drucken, `There are no alerts` wenn keine Warnmeldungen enthalten sind, würden `.Alerts` Sie Folgendes schreiben: ``` {{ if .Alerts }} There are alerts {{ else }} There are no alerts {{ end }} ``` ## Mit With ähnelt if-Anweisungen, `with` aktualisiert jedoch im Gegensatz zu if-Anweisungen den Punkt so, dass er auf den Wert von with verweist: ``` {{ with .Alerts }} There are {{ len . }} alert(s) {{ else }} There are no alerts {{ end }} ``` ## Variablen Variablen in text/template müssen innerhalb der Vorlage erstellt werden. Um beispielsweise eine Variable zu erstellen, die `$variable` mit dem aktuellen Wert von Punkt aufgerufen wird, würden Sie Folgendes schreiben: ``` {{ $variable := . }} ``` Sie können `$variable` innerhalb eines Bereichs oder verwenden `with` und es bezieht sich auf den Wert von Punkt zu dem Zeitpunkt, als die Variable definiert wurde, und nicht auf den aktuellen Wert von Punkt. Sie können beispielsweise keine Vorlage schreiben, die den zweiten `{{ .Labels }}` Bereich verwendet, da sich Punkt hier auf das aktuelle Label bezieht, nicht auf die aktuelle Warnung: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* does not work because in the second range . is a label not an alert */}} There are {{ len .Labels }} {{ end }} {{ end }} ``` Sie können dies beheben, indem Sie eine Variable definieren, die `$alert` im ersten Bereich und vor dem zweiten Bereich aufgerufen wird: ``` {{ range .Alerts }} {{ $alert := . }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* works because $alert refers to the value of dot inside the first range */}} There are {{ len $alert.Labels }} {{ end }} {{ end }} ``` ## Bereich mit Index Sie können den Index jeder Warnung innerhalb eines Bereichs abrufen, indem Sie Index- und Wertvariablen am Anfang des Bereichs definieren: ``` {{ $num_alerts := len .Alerts }} {{ range $index, $alert := .Alerts }} This is alert {{ $index }} out of {{ $num_alerts }} {{ end }} ``` ## Definieren Sie Vorlagen Sie können Vorlagen definieren, die in anderen Vorlagen verwendet werden können, indem Sie `define` den Namen der Vorlage in doppelten Anführungszeichen verwenden. Sie sollten keine Vorlagen mit demselben Namen wie andere Vorlagen definieren, einschließlich Standardvorlagen wie `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Wenn eine Vorlage mit demselben Namen wie eine Standardvorlage oder eine Vorlage in einer anderen Benachrichtigungsvorlage erstellt wurde, verwendet Grafana möglicherweise eine der beiden Vorlagen. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt. ``` {{ define "print_labels" }} {{ end }} ``` ## Vorlagen einbetten Sie können eine definierte Vorlage in Ihre Vorlage einbetten`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor, der an die Vorlage übergeben werden soll, verwenden: ``` {{ template "print_labels" . }} ``` ## Übergeben Sie Daten an Vorlagen Innerhalb einer Vorlage bezieht sich der Punkt auf den Wert, der an die Vorlage übergeben wird. Wenn einer Vorlage beispielsweise eine Liste mit Auslösewarnungen übergeben wird, bezieht sich Punkt auf diese Liste von Auslösewarnungen: ``` {{ template "print_alerts" .Alerts }} ``` Wenn der Vorlage die sortierten Labels für eine Warnung übergeben werden, bezieht sich Punkt auf die Liste der sortierten Labels: ``` {{ template "print_labels" .SortedLabels }} ``` Dies ist nützlich, wenn Sie wiederverwendbare Vorlagen schreiben. Um beispielsweise alle Benachrichtigungen zu drucken, könnten Sie Folgendes schreiben: ``` {{ template "print_alerts" .Alerts }} ``` Um dann nur die Feuermeldungen auszudrucken, könnten Sie Folgendes schreiben: ``` {{ template "print_alerts" .Alerts.Firing }} ``` Das funktioniert, weil es sich bei beiden `.Alerts` um Listen von Warnmeldungen `.Alerts.Firing` handelt. ``` {{ define "print_alerts" }} {{ range . }} {{ template "print_labels" .SortedLabels }} {{ end }} {{ end }} ``` ## Kommentare Sie können Kommentare hinzufügen mit `{{/*` und`*/}}`: ``` {{/* This is a comment */}} ``` Um zu verhindern, dass Kommentare Zeilenumbrüche hinzufügen, verwende: ``` {{- /* This is a comment with no leading or trailing line breaks */ -}} ``` ## Einrückung Sie können Einzüge, sowohl Tabulatoren als auch Leerzeichen, und Zeilenumbrüche verwenden, um die Lesbarkeit von Vorlagen zu verbessern: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Einrückungen in der Vorlage werden jedoch auch im Text vorhanden sein. Als nächstes werden wir sehen, wie man es entfernt. ## Entferne Leerzeichen und Zeilenumbrüche Wird text/template verwendet `{{-` und dient `-}}` zum Entfernen von führenden und nachfolgenden Leerzeichen und Zeilenumbrüchen. Wenn Sie beispielsweise Einrückungen und Zeilenumbrüche verwenden, um eine Vorlage lesbarer zu machen: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Der Einzug und die Zeilenumbrüche werden auch im Text vorhanden sein: ``` alertname = "Test" grafana_folder = "Test alerts" ``` Sie können den Einzug und die Zeilenumbrüche aus dem Text entfernen, indem Sie `}}` zu `-}}` Beginn jedes Bereichs wechseln: ``` {{ range .Alerts -}} {{ range .Labels.SortedPairs -}} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Der Einzug und die Zeilenumbrüche in der Vorlage fehlen jetzt im Text: ``` alertname = "Test" grafana_folder = "Test alerts" ``` # Vorlagen für Benachrichtigungen erstellen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Erstellen Sie wiederverwendbare Benachrichtigungsvorlagen, die Sie an Ihre Kontaktstellen senden können. Sie können Ihrer Benachrichtigungsvorlage eine oder mehrere Vorlagen hinzufügen. Der Name Ihrer Benachrichtigungsvorlage muss eindeutig sein. Sie können nicht zwei Vorlagen mit demselben Namen in derselben Benachrichtigungsvorlage oder in verschiedenen Benachrichtigungsvorlagen haben. Vermeiden Sie es, Vorlagen mit demselben Namen wie Standardvorlagen zu definieren, z. B.: `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Auf der Registerkarte Kontaktstellen finden Sie eine Liste Ihrer Benachrichtigungsvorlagen. ## Vorlagen für Benachrichtigungen erstellen **Um eine Benachrichtigungsvorlage zu erstellen** 1. Klicken Sie auf **Vorlage hinzufügen**. 1. Wählen Sie einen Namen für die Benachrichtigungsvorlage, z. `email.subject` B. 1. Schreiben Sie den Inhalt der Vorlage in das Inhaltsfeld. Beispiel: ``` {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Klicken Sie auf Speichern. `{{ define "email.subject" }}`(wo `email.subject` ist der Name Ihrer Vorlage) und `{{ end }}` wird automatisch am Anfang und Ende des Inhalts hinzugefügt. **Um eine Benachrichtigungsvorlage zu erstellen, die mehr als eine Vorlage enthält:** 1. Klicken Sie auf **Vorlage hinzufügen**. 1. Geben Sie einen Namen für die gesamte Benachrichtigungsvorlage ein. Beispiel, `email`. 1. Schreiben Sie jede Vorlage in das Feld Inhalt, einschließlich `{{ define "name-of-template" }}` und `{{ end }}` am Anfang und Ende jeder Vorlage. Sie können für jede Vorlage in der Benachrichtigungsvorlage aussagekräftige Namen verwenden, z. B. `email.subject` oder`email.message`. Verwenden Sie in diesem Fall nicht den Namen der Benachrichtigungsvorlage, den Sie oben eingegeben haben. In den folgenden Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie erstellen könnten. 1. Klicken Sie auf Speichern. ## Eine Vorlage für den Betreff einer E-Mail erstellen Erstellen Sie eine Vorlage für den Betreff einer E-Mail, die die Anzahl der ausgelösten und gelösten Benachrichtigungen enthält, wie in diesem Beispiel: ``` 1 firing alerts, 0 resolved alerts ``` **Um eine Vorlage für den Betreff einer E-Mail zu erstellen** 1. Erstellen Sie eine Vorlage namens `email.subject` mit dem folgenden Inhalt: ``` {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Betreff** mit dem `template` Schlüsselwort einfügen. ``` {{ template "email.subject" . }} ``` ## Erstellen Sie eine Vorlage für die Nachricht einer E-Mail Erstellen Sie eine Vorlage für die Nachricht einer E-Mail, die eine Zusammenfassung aller ausgelösten und gelösten Alarme enthält, wie in diesem Beispiel: ``` There are 2 firing alerts, and 1 resolved alerts Firing alerts: - alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1 - alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2 Resolved alerts: - alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0 ``` **Um eine Vorlage für die Nachricht einer E-Mail zu erstellen** 1. Erstellen Sie eine Benachrichtigungsvorlage `email` mit zwei Vorlagen im Inhalt: `email.message_alert` und`email.message`. Die `email.message_alert` Vorlage wird verwendet, um die Bezeichnungen und Werte für jede ausgelöste und behobene Warnung zu drucken, wobei die `email.message` Vorlage die Struktur der E-Mail enthält. ``` {{- define "email.message_alert" -}} {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s) {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }} {{- end -}} {{ define "email.message" }} There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts {{ if .Alerts.Firing -}} Firing alerts: {{- range .Alerts.Firing }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ if .Alerts.Resolved -}} Resolved alerts: {{- range .Alerts.Resolved }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Textfeld** mit dem `template` Schlüsselwort einfügen. ``` {{ template "email.message" . }} ``` ## Eine Vorlage für den Titel einer Slack-Nachricht erstellen Erstelle eine Vorlage für den Titel einer Slack-Nachricht, die die Anzahl der ausgelösten und gelösten Alerts enthält, wie im folgenden Beispiel: ``` 1 firing alerts, 0 resolved alerts ``` **Um eine Vorlage für den Titel einer Slack-Nachricht zu erstellen** 1. Erstelle eine Vorlage namens `slack.title` mit dem folgenden Inhalt: ``` {{ define "slack.title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Titelfeld** mit dem `template` Schlüsselwort einfügen. ``` {{ template "slack.title" . }} ``` ## Eine Vorlage für den Inhalt einer Slack-Nachricht erstellen Erstelle eine Vorlage für den Inhalt einer Slack-Nachricht, die eine Beschreibung aller ausgelösten und gelösten Alerts enthält, einschließlich ihrer Labels, Anmerkungen und Dashboard-URL: ``` 1 firing alerts: [firing] Test1 Labels: - alertname: Test1 - grafana_folder: GrafanaCloud Annotations: - description: This is a test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 1 resolved alerts: [firing] Test2 Labels: - alertname: Test2 - grafana_folder: GrafanaCloud Annotations: - description: This is another test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 ``` **Um eine Vorlage für den Inhalt einer Slack-Nachricht zu erstellen** 1. Erstelle ein Template namens `slack` mit zwei Templates im Inhalt: `slack.print_alert` und`slack.message`. Die `slack.print_alert` Vorlage wird zum Drucken der Beschriftungen, Anmerkungen und der Dashboard-URL verwendet, während die `slack.message` Vorlage die Struktur der Benachrichtigung enthält. ``` {{ define "slack.print_alert" -}} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ if .Annotations -}} Annotations: {{ range .Annotations.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ end -}} {{ if .DashboardURL -}} Go to dashboard: {{ .DashboardURL }} {{- end }} {{- end }} {{ define "slack.message" -}} {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts: {{ range .Alerts.Firing }} {{ template "slack.print_alert" . }} {{ end -}} {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts: {{ range .Alerts.Resolved }} {{ template "slack.print_alert" .}} {{ end -}} {{ end }} {{- end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Textkörper mit dem Schlüsselwort einfügen**. `template` ``` {{ template "slack.message" . }} ``` ## Template sowohl für E-Mail als auch für Slack mit gemeinsam genutzten Vorlagen Anstatt separate Benachrichtigungsvorlagen für jeden Kontaktpunkt wie E-Mail und Slack zu erstellen, kannst du dieselbe Vorlage gemeinsam nutzen. Wenn du beispielsweise eine E-Mail mit diesem Betreff und eine Slack-Nachricht mit diesem Titel senden möchtest`1 firing alerts, 0 resolved alerts`, kannst du eine gemeinsame Vorlage erstellen. **Um eine gemeinsame Vorlage zu erstellen** 1. Erstellen Sie eine Vorlage namens `common.subject_title` mit dem folgenden Inhalt: ``` {{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Führen Sie für E-Mails die Vorlage im Betreff-Feld Ihrer E-Mail-Kontaktpunkt-Integration aus: ``` {{ template "common.subject_title" . }} ``` 1. Für Slack führe die Vorlage im Titelfeld deiner Slack-Kontaktpunkt-Integration aus: ``` {{ template "common.subject_title" . }} ``` ## Verwenden von Benachrichtigungsvorlagen Verwenden Sie Vorlagen in Kontaktpunkten, um Ihre Benachrichtigungen zu personalisieren. **Um eine Vorlage beim Erstellen einer Kontaktstelle zu verwenden** 1. Wählen Sie im Menü **„Benachrichtigungen**“ die Option **Kontaktstellen** aus, um eine Liste der vorhandenen Kontaktstellen anzuzeigen. 1. Wählen Sie **Kontaktstelle hinzufügen**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie neben der Kontaktstelle, die Sie **bearbeiten** möchten, auf das Symbol Bearbeiten (Stift) klicken. 1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein oder mehrere Felder ein, z. B. **Nachricht** oder **Betreff**. Um eine Vorlage einzugeben, verwenden Sie das Formular `{{ template "template_name" . }}` und *template\$1name* ersetzen Sie es durch den Namen der Vorlage, die Sie verwenden möchten. 1. Klicken Sie auf **Kontaktstelle speichern**. # Vorlage – Referenz **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen. ## Vorlagendaten Die folgenden Daten werden an Nachrichtenvorlagen übergeben. | Name | Typ | Hinweise | | --- | --- | --- | | `Receiver` | Zeichenfolge | Name der Kontaktstelle, an die die Benachrichtigung gesendet wird. | | `Status` | Zeichenfolge | wird ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben. | | `Alerts` | Warnung | Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten). | | `GroupLabels` | KeyValue | Labels, nach denen diese Alerts gruppiert wurden. | | `CommonLabels` | KeyValue | Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. | | `CommonAnnotations` | KeyValue | Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. | | `ExternalURL` | Zeichenfolge | Backlink zu der Grafana, die die Benachrichtigung gesendet hat. Wenn Sie einen externen Alertmanager verwenden, verlinken Sie zurück zu diesem Alertmanager. | Der `Alerts` Typ stellt zwei Funktionen zum Filtern der zurückgegebenen Warnungen zur Verfügung. + `Alerts.Firing`— Gibt eine Liste von Auslösewarnungen zurück. + `Alerts.Resolved`— Gibt eine Liste der behobenen Alarme zurück. **Warnung (Typ)** Der Warnungstyp enthält die folgenden Daten. | Name | Typ | Hinweise | | --- | --- | --- | | Status | Zeichenfolge | `firing` oder `resolved`. | | Labels | KeyValue | Eine Reihe von Bezeichnungen, die der Warnung beigefügt sind. | | Anmerkungen | KeyValue | Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. | | Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen | | StartsAt | Zeit.Zeit | Uhrzeit, zu der der Alarm ausgelöst wurde. | | EndsAt | Zeit. Zeit | Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt. | | Generator-URL | Zeichenfolge | Ein Backlink zu Grafana oder einem externen Alertmanager. | | Silence-URL | Zeichenfolge | Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen. | | Dashboard-URL | Zeichenfolge | Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | | Panel-URL | Zeichenfolge | Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | | Fingerabdruck | Zeichenfolge | Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. | | ValueString | Zeichenfolge | Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. | **ExtendedData** Das ExtendedData Objekt enthält die folgenden Eigenschaften. | Name | Art | Description | Beispiel | | --- | --- | --- | --- | | Empfänger | `string` | Der Name der Kontaktstelle, die die Benachrichtigung sendet. | `{{ .Receiver }}` | | Status | `string` | Der Status ist `firing if at least one alert is firing, otherwise resolved.` | `{{ .Status }}` | | Benachrichtigungen | `[]Alert` | Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung. | `There are {{ len .Alerts }} alerts` | | Feuerwarnungen | `[]Alert` | Liste aller Feuerwarnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Firing }} firing alerts` | | Behobene Warnungen | `[]Alert` | Liste aller gelösten Warnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Resolved }} resolved alerts` | | GroupLabels | `KeyValue` | Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren. | `{{ .GroupLabels }}` | | CommonLabels | `KeyValue` | Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonLabels }}` | | CommonAnnotations | `KeyValue` | Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonAnnotations }}` | | Externe URL | `string` | Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat. | `{{ .ExternalURL }}` | **KeyValue Typ** Der `KeyValue` Typ besteht aus einer Reihe von key/value Zeichenkettenpaaren, die Beschriftungen und Anmerkungen darstellen. Neben dem direkten Zugriff auf die als `KeyValue` gespeicherten Daten gibt es auch Methoden zum Sortieren, Entfernen und Transformieren der Daten. | Name | Argumente | Rückgabewert | Hinweise | Beispiel | | --- | --- | --- | --- | --- | | SortedPairs | | Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert | | `{{ .Annotations.SortedPairs }}` | | Remove | [] Zeichenfolge | KeyValue | Gibt eine Kopie der Key/Value Map ohne die angegebenen Schlüssel zurück. | `{{ .Annotations.Remove "summary" }}` | | Namen | | [] Zeichenfolge | Liste der Labelnamen | `{{ .Names }}` | | Werte | | [] Zeichenfolge | Liste der Labelwerte | `{{ .Values }}` | **Time (Zeit)** Die Zeit stammt aus dem [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)Go-Paket. Sie können eine Uhrzeit in verschiedenen Formaten drucken. Um beispielsweise die Uhrzeit zu drucken, zu der eine Warnung ausgelöst wurde`Monday, 1st January 2022 at 10:00AM`, in diesem Format schreiben Sie die folgende Vorlage: ``` {{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }} ``` Eine Referenz für das Zeitformat von Go finden Sie [hier](https://pkg.go.dev/time#pkg-constants). ## Funktionen der Vorlage Mithilfe von Vorlagenfunktionen können Sie Beschriftungen und Anmerkungen verarbeiten, um dynamische Benachrichtigungen zu generieren. Die folgenden Funktionen sind verfügbar. | Name | Argumenttyp | Rückgabetyp | Description | | --- | --- | --- | --- | | `humanize` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format. | | `humanize1024` | Zahl oder Zeichenfolge | Zeichenfolge | Wie Humanize, verwendet aber 1024 statt 1000 als Basis. | | `humanizeDuration` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert eine Dauer in Sekunden in ein besser lesbares Format. | | `humanizePercentage` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Verhältniswert in einen Bruchteil von 100. | | `humanizeTimestamp` | Zahl oder Zeichenfolge | Zeichenfolge | Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format. | | `title` | Zeichenfolge | Zeichenfolge | Strings.Title schreibt das erste Zeichen jedes Worts groß. | | `toUpper` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um. | | `toLower` | Zeichenfolge | Zeichenfolge | Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um. | | `match` | Muster, Text | Boolesch | Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung. | | `reReplaceAll` | Muster, Ersatz, Text | Zeichenfolge | Regexp. ReplaceAllString Regexp-Substitution, nicht verankert. | | `graphLink` | string — JSON-Objekt mit Feldern und `expr` `datasource` | Zeichenfolge | Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. | | `tableLink` | string — JSON-Objekt mit `expr` und `datasource` -Feldern | Zeichenfolge | Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. | | `args` | [] Schnittstelle \$1\$1 | map [string] Schnittstelle \$1\$1 | Konvertiert eine Liste von Objekten in eine Map mit Schlüsseln, zum Beispiel arg0, arg1. Verwenden Sie diese Funktion, um mehrere Argumente an Vorlagen zu übergeben. | | `externalURL` | nichts | Zeichenfolge | Gibt eine Zeichenfolge zurück, die die externe URL darstellt. | | `pathPrefix` | nichts | Zeichenfolge | Gibt den Pfad der externen URL zurück. | Die folgende Tabelle zeigt Beispiele für die Verwendung der einzelnen Funktionen. | Funktion | TemplateString | Input | Expected | | --- | --- | --- | --- | | humanisieren | \$1\$1value humanisieren\$1 | 1234567,0 | 1,235 M | | humanisieren Sie 1024 | \$1humanise1024 \$1value\$1 | 1048576,0 | 1 Minuten | | Dauer humanisieren | \$1humanizeDuration \$1value\$1 | 899,99 | 14 m 59 s | | Prozentsatz humanisieren | \$1HumanizePercentage \$1value\$1 | 0,1234567 | 12,35% | | Zeitstempel humanisieren | \$1HumanizeTimestamp \$1value\$1 | 1435065584,128 | 2015-06-23 13:19:44.128 \$10000 UTC | | Titel | \$1\$1wert \$1 Titel\$1 | ein B C | Ein Bb Cc | | toUpper | \$1\$1value \$1 toUpper\$1 | ein B C | EIN B C | | toLower | \$1\$1value \$1 toLower\$1 | ein B C | ein b c | | match | \$1entspricht „a\$1“ \$1labels.instance\$1 | aa | true | | reReplaceAll | \$1\$1 reReplaceAll „localhost :( .\$1)“ „meine.domain: \$11“ \$1labels.instance\$1\$1 | localhost: 3000 | meine.domain: 3000 | | GraphLink | \$1\$1GraphLink „\$1\$1" expr\$1“:\$1 "hoch\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :false, "range“ :true\$1] | | Link zur Tabelle | \$1\$1TableLink „\$1\$1" expr\$1“:\$1 "nach oben\$1“,\$1 "Datenquelle\$1“:\$1 "gdev-prometheus\$1"\$1“\$1\$1 | | /erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, \$1"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :true, "range“ :false\$1] | | args | \$1\$1definiere „x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1Vorlage „x“ (Argumente 1 „2")\$1\$1 | | 1 2 | | Externe URL | \$1externe URL\$1 | | http://localhost/path/prefix | | Pfad-Präfix | \$1Pfadpräfix\$1 | | /Pfad/Präfix | # Stummschalten von Warnmeldungen für Prometheus-Datenquellen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) *Für externe Alert Manager-Datenquellen (einschließlich Amazon Managed Service for Prometheus) können Sie Warnmeldungen mit einer Stille unterdrücken.* Eine Stille verhindert nur, dass Benachrichtigungen erstellt werden: Stummschaltungen verhindern nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Wenn Sie eine Warnung stummschalten, geben Sie ein Zeitfenster an, in dem sie unterdrückt werden soll. Sie können Stummschaltungen für eine externe AlertManager-Datenquelle konfigurieren. **Anmerkung** Um Warnmeldungen in regelmäßigen Zeitintervallen oder für andere Datenquellen (z. B. während regulärer Wartungsperioden) zu unterdrücken, verwenden Sie [Timings stummschalten](v9-alerting-notification-muting.md) anstelle von Stummschaltungen. **Um eine Stille hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Warnsymbol** (Glocke), um die Warnseite zu öffnen.** 1. Wählen Sie **Stille**, um eine Seite mit einer vorhandenen Liste zu öffnen. [Mit Kontaktstellen arbeiten](v9-alerting-contact-points.md) 1. **Wählen Sie den externen Alertmanager aus der Dropdown-Liste Alertmanager aus.** 1. **Wählen** Sie Stille hinzufügen aus. 1. Wählen Sie das Start- und Enddatum **unter Start und Ende der Stille** aus, um anzugeben, wann die Stille in Kraft treten und wann sie enden soll. Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt wird. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert. 1. Geben Sie in den Feldern **Name** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Der Labelabgleich wird im Anschluss an dieses Verfahren ausführlicher erörtert. 1. Fügen Sie optional einen **Kommentar** hinzu oder ändern Sie den **Ersteller** so, dass er den Besitzer der Stille festlegt. 1. Wählen Sie „**Erstellen**“, um die Stille zu erzeugen. Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen. **Labelabgleich für die Unterdrückung von Alarmen** Wenn Sie eine Stille erstellen, erstellen Sie im Rahmen der Stille eine Reihe von *passenden Bezeichnungen*. Dabei handelt es sich um eine Reihe von Regeln für Bezeichnungen, die übereinstimmen müssen, damit die Warnung unterdrückt wird. Die passenden Beschriftungen bestehen aus drei Teilen: + **Bezeichnung** — Der Name der Bezeichnung, der zugeordnet werden soll. Er muss exakt mit dem Labelnamen der Warnung übereinstimmen. + **Operator** — Der Operator, der verwendet wird, um den Labelwert mit dem passenden Labelwert zu vergleichen. Die verfügbaren Operatoren sind: + `=`Wählen Sie Labels aus, deren Wert genau mit der angegebenen Zeichenfolge übereinstimmt. + `!=`Wählen Sie Labels aus, deren Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. + `=~`Wählen Sie Labels aus, deren Wert mit dem regex-interpretierten Wert der angegebenen Zeichenfolge übereinstimmt (die angegebene Zeichenfolge wird als regulärer Ausdruck interpretiert). + `!=`Wählen Sie Beschriftungen aus, die nicht mit dem angegebenen regulären Ausdruck übereinstimmen. + **Wert** — Der Wert, dem der Labelwert zugeordnet werden soll. Er kann je nach ausgewähltem Operator als Zeichenfolge oder als regulärer Ausdruck übereinstimmen. Eine Stille endet am angegebenen Enddatum, Sie können die Unterdrückung jedoch jederzeit manuell beenden. **Um eine Stille manuell zu beenden** 1. Wählen Sie auf der Seite **„Benachrichtigungen**“ die Option „**Stille**“, um die Liste der vorhandenen Pausen anzuzeigen. 1. **Wählen Sie die Stille aus, die Sie beenden möchten, und wählen Sie Stille aufheben.** Dadurch wird die Unterdrückung von Alarmen beendet. **Anmerkung** Durch das Aufheben der Stummschaltung wird die Unterdrückung von Alarmen beendet, als ob die Endzeit für die aktuelle Uhrzeit festgelegt wäre. Stille, die (automatisch oder manuell) beendet wurde, werden fünf Tage lang beibehalten und in der Liste aufgeführt. Sie können eine Stille nicht manuell aus der Liste entfernen. **Einen Link zum Formular zur Erstellung von Stille erstellen** Sie können eine URL zum Formular zur Erstellung von Stille erstellen, wobei die Details bereits ausgefüllt sind. Bediener können dies verwenden, um einen Alarm während eines Betriebsereignisses schnell zu unterdrücken. Wenn Sie einen Link zu einem Silence-Formular erstellen, verwenden Sie einen `matchers` Abfrageparameter, um die entsprechenden Bezeichnungen anzugeben, und einen `comment` Abfrageparameter, um einen Kommentar anzugeben. Der `matchers` Parameter erfordert einen oder mehrere Werte im Formular`[label][operator][value]`, getrennt durch Kommas. **Beispiel-URL** Verwenden Sie eine URL wie die folgende, um einen Link zu einem `cluster!~europe-.*` Silence-Formular mit passenden Bezeichnungen `severity=critical` und einem Kommentar`Silencing critical EU alerts`, der besagt, zu verlinken. *mygrafana*Ersetzen Sie durch den Hostnamen Ihrer Grafana-Instanz. ``` https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert ``` Um eine Verknüpfung zu einer neuen Silence-Seite für einen externen Alertmanager herzustellen, fügen Sie einen `alertmanager` Abfrageparameter mit dem Alertmanage-Datenquellennamen hinzu, z. B. `alertmanager=myAlertmanagerdatasource` # Timings stummschalten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Eine Stummschaltung ist ein wiederkehrendes Zeitintervall, in dem keine neuen Benachrichtigungen für eine Richtlinie generiert oder gesendet werden. Verwenden Sie sie, um zu verhindern, dass Warnmeldungen für einen bestimmten und sich wiederholenden Zeitraum ausgelöst werden, z. B. während eines regulären Wartungszeitraums. Ähnlich wie bei Stummschaltungen verhindern auch Stummschaltungen nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern auch nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Sie verhindern lediglich, dass Benachrichtigungen erstellt werden. Sie können von Grafana verwaltete Stummschaltezeiten sowie Stummschaltezeiten für eine externe Alertmanager-Datenquelle konfigurieren. **Stummschaltungen im Vergleich zu Stummschaltungen** In der folgenden Tabelle werden die Unterschiede zwischen Stummschaltezeiten und Stummschaltungen hervorgehoben. | Timing stummschalten | Stumm | | --- | --- | | Verwendet Zeitintervalldefinitionen, die sich wiederholen können. | Hat eine feste Start- und Endzeit. | | Wird erstellt und dann zu den Benachrichtigungsrichtlinien hinzugefügt. | Verwendet Labels, um mit einer Warnung abzugleichen, um zu bestimmen, ob stummgeschaltet werden soll oder nicht. | | Funktioniert mit Grafana-Alerting und externen Alertmanagern. | Funktioniert nur mit externen Alertmanagern. | **Um ein Timing zur Stummschaltung zu erstellen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü das **Alerting (Glockensymbol), um die Alerting-Seite** zu öffnen.** 1. **Wählen Sie Benachrichtigungsrichtlinien.** 1. Wählen Sie im Drop-down-Menü **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. **Wählen Sie im Bereich **Timings für die Stummschaltung die Schaltfläche Timing** für Stummschaltung hinzufügen aus.** 1. Wählen Sie das Zeitintervall aus, für das die Stummschaltung gelten soll. 1. Wählen Sie „**Senden**“, um die Dauer der Stummschaltung zu erstellen. **Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen** 1. Wählen Sie die Benachrichtigungsrichtlinie aus, zu der Sie die Stummschaltung hinzufügen möchten, und klicken Sie auf die Schaltfläche **Bearbeiten**. 1. Wählen Sie in der Dropdownliste **für** die Dauer der Stummschaltung die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten. Wählen Sie die Schaltfläche Richtlinie **speichern**. **Zeitintervalle** Ein Zeitintervall ist eine Definition für einen Zeitbereich. Wenn während dieses Intervalls eine Warnung ausgelöst wird, wird sie unterdrückt. Bereiche werden unterstützt mit `:` (zum Beispiel`monday:thursday`). Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten. Ein Zeitintervall besteht aus mehreren Feldern (Details in der folgenden Liste), die alle übereinstimmen müssen, damit die Alerts unterdrückt werden. Wenn Sie beispielsweise Wochentage und einen Zeitraum zwischen 8:00 `monday:friday` und 9:00 Uhr angeben, werden Benachrichtigungen von Montag bis Freitag von 8 bis 9 Uhr unterdrückt, am Samstag jedoch nicht von 8 bis 9 Uhr. + **Zeitraum — Die Tageszeit, zu** der Benachrichtigungen unterdrückt werden sollen. Besteht aus zwei Unterfeldern: **Startzeit** und **Endzeit.** Ein Beispiel für die Zeit ist`14:30`. Die Uhrzeit wird in 24-Stunden-Notation in UTC angegeben. + **Wochentage** — Die Wochentage. Dabei kann es sich um einen einzelnen Tag handeln`monday`, z. B. um einen Bereich`monday:friday`, oder um eine durch Kommas getrennte Liste von Tagen, z. B. `monday, tuesday, wednesday` + **Monate** — Die Monate, die ausgewählt werden sollen. Sie können Monate mit numerischen Bezeichnungen oder mit dem vollständigen Monatsnamen angeben, `1` oder `january` beide geben Januar an. Sie können einen einzelnen Monat, einen Bereich von Monaten oder eine durch Kommas getrennte Liste von Monaten angeben. + **Tage des Monats** — Die Daten innerhalb eines Monats. Die Werte können im Bereich von `1` - liegen`31`. Negative Werte geben die Tage des Monats in umgekehrter Reihenfolge an, `-1` stellen also den letzten Tag des Monats dar. Tage des Monats können als einzelner Tag, als Bereich von Tagen oder als durch Kommas getrennte Liste von Tagen angegeben werden. + **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2025`. Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Wenn Sie also Jahre auf festlegen`2023:2025, 2027`, gilt dies für die Jahre 2023, 2024, 2025 und 2027 (aber nicht 2026). Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Ein Zeitpunkt muss allen Feldern entsprechen, um einem vollständigen Zeitintervall zu entsprechen. Wenn Sie eine genaue Dauer angeben möchten, geben Sie alle für diese Dauer erforderlichen Optionen an. Wenn Sie beispielsweise ein Zeitintervall für den ersten Montag des Monats, für März, Juni, September und Dezember, zwischen 12:00 und 24:00 Uhr UTC erstellen möchten, könnte Ihre Zeitintervallspezifikation wie folgt lauten: + Zeitbereich: + Startzeit: `12:00` + Endzeit: `24:00` + Wochentage: `monday` + Monate: `3, 6, 9, 12` + Tage des Monats: `1:7` # Warnungsgruppen anzeigen und nach Warnungsgruppen filtern **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig werden Warnungsregeln in Benachrichtigungsrichtlinien nach den Labelschlüsseln für die Stammrichtlinie gruppiert. Durch die Gruppierung allgemeiner Warnungsregeln in einer einzigen Warnungsgruppe wird verhindert, dass doppelte Warnungsregeln ausgelöst werden. Sie können Warnungsgruppen anzeigen und auch nach Warnungsregeln filtern, die bestimmten Kriterien entsprechen. **Um Warnungsgruppen anzuzeigen** 1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen. 1. Klicken Sie auf **Warnungsgruppen, um die Seite mit den vorhandenen Gruppen** zu öffnen. 1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus. 1. Wählen Sie im Drop-down-Menü „**Benutzerdefiniert gruppieren nach“ eine Kombination von** Bezeichnungen aus, um eine andere Gruppierung als die Standardgruppierung anzuzeigen. Dies ist nützlich, um Ihre Gruppierung von Benachrichtigungsrichtlinien zu debuggen und zu überprüfen. Wenn eine Warnung keine Bezeichnungen enthält, die entweder in der Gruppierung der Stammrichtlinie oder in der benutzerdefinierten Gruppierung angegeben wurden, wird die Warnung einer Catch-All-Gruppe mit dem Header von hinzugefügt. `No grouping` **Um nach Label zu filtern** + Geben Sie **unter Suchen** ein vorhandenes Label ein, um Benachrichtigungen anzuzeigen, die dem Label entsprechen. Beispiel, `environment=production,region=~US|EU,severity!=warning`. **Um nach Bundesland zu filtern** + Wählen Sie unter **Staaten den** Status Aktiv, Unterdrückt oder Nicht verarbeitet aus, um Benachrichtigungen anzuzeigen, die Ihrem ausgewählten Status entsprechen. Alle anderen Benachrichtigungen sind ausgeblendet. # Benachrichtigungsfehler anzeigen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 9.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Sehen Sie sich Benachrichtigungsfehler an und erfahren Sie, warum sie nicht gesendet oder empfangen wurden. **Anmerkung** Diese Funktion wird nur für Grafana Alertmanager unterstützt. **Um Benachrichtigungsfehler anzuzeigen** 1. Klicken Sie im Grafana-Menü auf das **Warnsymbol** (Glocke), um die Warnseite mit den vorhandenen Benachrichtigungen zu öffnen. 1. Wählen Sie **Kontaktstellen**, um eine Liste der vorhandenen Kontaktstellen anzuzeigen. Wenn eine Kontaktstelle ausfällt, wird der Benutzer in einer Meldung in der rechten Ecke des Bildschirms darauf hingewiesen, dass und wie viele Fehler vorliegen. 1. Klicken Sie auf eine Kontaktstelle, um die Einzelheiten der Fehler für diese Kontaktstelle anzuzeigen. Fehlerdetails werden angezeigt, wenn Sie den Mauszeiger über das Fehlersymbol bewegen. Wenn eine Kontaktstelle über mehr als eine Integration verfügt, werden alle Fehler für jede der aufgelisteten Integrationen angezeigt. 1. Überprüfen Sie in der Spalte Health den Status der Benachrichtigung. Dies kann entweder „OK“, „Keine Versuche“ oder „Fehler“ lauten.