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 Benachrichtigungen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Sobald Sie Ihre Alarmregeln, Kontaktstellen und Benachrichtigungsrichtlinien eingerichtet haben, können Sie Grafana-Benachrichtigungen verwenden, um Ihre Benachrichtigungen in der Praxis zu verwalten. **Topics** + [Benachrichtigungen anpassen](v10-alerting-manage-notifications.md) + [Kontaktstellen verwalten](v10-alerting-manage-contactpoints.md) + [Warnmeldungen stummschalten](v10-alerting-silences.md) + [Warnungsregeln anzeigen und filtern](v10-alerting-manage-rules-viewfilter.md) + [Timings stummschalten](v10-alerting-manage-muting.md) + [Status und Zustand der Warnungsregeln anzeigen](v10-alerting-manage-rulestate.md) + [Warnungsgruppen anzeigen und nach Warnungsgruppen filtern](v10-alerting-manage-viewfiltergroups.md) + [Benachrichtigungsfehler anzeigen](v10-alerting-manage-viewnotificationerrors.md) # Benachrichtigungen anpassen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Passen Sie Ihre Benachrichtigungen mit Vorlagen für Benachrichtigungen an. Sie können Benachrichtigungsvorlagen verwenden, um den Titel, die Nachricht und das Format der Nachricht in Ihren Benachrichtigungen zu ändern. Benachrichtigungsvorlagen sind nicht an bestimmte Kontaktpunkt-Integrationen wie Amazon SNS oder Slack gebunden. Sie können sich jedoch dafür entscheiden, separate Benachrichtigungsvorlagen für verschiedene Kontaktpunkt-Integrationen zu erstellen. Sie können Benachrichtigungsvorlagen verwenden, um: + Informationen in der Benachrichtigung hinzufügen, entfernen oder neu anordnen, einschließlich Zusammenfassung, Beschreibung, Beschriftungen und Anmerkungen, Werten und Links + Formatieren Sie Text fett und kursiv und fügen Sie Zeilenumbrüche hinzu oder entfernen Sie sie Sie können Benachrichtigungsvorlagen nicht verwenden, um: + Ändern Sie das Design von Benachrichtigungen in Instant-Messaging-Diensten wie Slack und Microsoft Teams **Topics** + [Verwendung der Template-Sprache von Go](v10-alerting-notifications-go-templating.md) + [Vorlagen für Benachrichtigungen erstellen](v10-alerting-create-templates.md) + [Verwenden von Benachrichtigungsvorlagen](#v10-alerting-use-notification-templates) + [Vorlage – Referenz](v10-alerting-template-reference.md) # Verwendung der Template-Sprache von Go **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) [Sie schreiben Benachrichtigungsvorlagen in der Vorlagensprache von Go, Text/Vorlage.](https://pkg.go.dev/text/template) Dieser Abschnitt bietet einen Überblick über die Vorlagensprache von Go und das Schreiben von Vorlagen in Text/Vorlage. ## Punkt Darin text/template befindet sich ein spezieller Cursor namens Punkt, der als geschrieben wird`.`. Sie können sich diesen Cursor als eine Variable vorstellen, deren Wert sich ändert, je nachdem, wo in der Vorlage er verwendet wird. Beispielsweise `.` bezieht sich eine Benachrichtigungsvorlage zu Beginn auf das `ExtendedData` Objekt, das eine Reihe von Feldern enthält`Alerts`, darunter `Status``GroupLabels`,`CommonLabels`, `CommonAnnotations` und`ExternalURL`. Punkt kann sich jedoch auf etwas anderes beziehen, wenn es in einer Liste verwendet wird, wenn `range` es in einer Liste verwendet wird, wenn es innerhalb einer verwendet wird oder wenn Feature-Vorlagen geschrieben werden`with`, die in anderen Vorlagen verwendet werden sollen. Beispiele dafür finden Sie in [Vorlagen für Benachrichtigungen erstellen](v10-alerting-create-templates.md) und alle Daten und Funktionen in der[Vorlage – Referenz](v10-alerting-template-reference.md). ## Tags öffnen und schließen In text/template beginnen `{{` und enden Vorlagen mit, `}}` unabhängig davon, ob die Vorlage eine Variable druckt oder Kontrollstrukturen wie if-Anweisungen ausführt. Dies unterscheidet sich von anderen Template-Sprachen wie Jinja, wo das Drucken einer Variablen und und `{{` Kontrollstrukturen `}}` und verwenden. `{%` `%}` ## Print (Ausgabe) Um den Wert von etwas zu drucken, verwende `{{` und. `}}` Sie können den Wert eines Punkts, ein Punktfeld, das Ergebnis einer Funktion und den Wert einer [Variablen](#v10-go-variables) drucken. Um beispielsweise das `Alerts` Feld zu drucken, auf das sich der Punkt bezieht, würden `ExtendedData` Sie Folgendes schreiben: ``` {{ .Alerts }} ``` ## Wiederholt die Warnmeldungen Um nur die Beschriftungen jeder Warnung und nicht alle Informationen über die Warnung zu drucken, können Sie a verwenden, um die Warnungen in `range` folgenden Schritten zu iterieren: `ExtendedData` ``` {{ range .Alerts }} {{ .Labels }} {{ end }} ``` Innerhalb des Bereichs bezieht sich der Punkt nicht mehr auf`ExtendedData`, sondern auf eine`Alert`. Sie können `{{ .Labels }}` es verwenden, um die Beschriftungen der einzelnen Warnmeldungen zu drucken. Das funktioniert, weil `{{ range .Alerts }}` sich der Punkt so ändert, dass er sich auf die aktuelle Warnung in der Liste der Benachrichtigungen bezieht. Wenn der Bereich abgeschlossen ist, wird der Punkt auf den Wert zurückgesetzt, den er vor dem Beginn des Bereichs hatte. In diesem Beispiel ist das`ExtendedData`: ``` {{ range .Alerts }} {{ .Labels }} {{ end }} {{/* does not work, .Labels does not exist here */}} {{ .Labels }} {{/* works, cursor was reset */}} {{ .Status }} ``` ## Iterieren Sie über Anmerkungen und Beschriftungen Lassen Sie uns eine Vorlage schreiben, um die Beschriftungen jeder Warnung in dem Format zu drucken`The name of the label is $name, and the value is $value`, in dem sie den Namen `$name` und den Wert jedes Labels `$value` enthalten. Verwenden Sie wie im vorherigen Beispiel einen Bereich, um über die Warnungen zu iterieren, sodass der Punkt auf die aktuelle Warnung in der Liste der Warnungen verweist, und verwenden Sie dann einen zweiten Bereich für die sortierten Beschriftungen, sodass der Punkt ein zweites Mal aktualisiert wird, sodass er sich auf die aktuelle Bezeichnung bezieht. `.Alerts` Verwenden Sie innerhalb des zweiten Bereichs `.Name` und`.Value`, um den Namen und den Wert jedes Labels zu drucken: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} The name of the label is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ range .Annotations.SortedPairs }} The name of the annotation is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ end }} ``` ## Die Index-Funktionen Verwenden Sie die `index` Funktion, um eine bestimmte Anmerkung oder ein bestimmtes Etikett zu drucken. ``` {{ range .Alerts }} The name of the alert is {{ index .Labels "alertname" }} {{ end }} ``` ## Wenn Aussagen Sie können if-Anweisungen in Vorlagen verwenden. Um beispielsweise zu drucken, `There are no alerts` wenn keine Warnmeldungen enthalten sind, würden `.Alerts` Sie Folgendes schreiben: ``` {{ if .Alerts }} There are alerts {{ else }} There are no alerts {{ end }} ``` ## Mit With ähnelt if-Anweisungen, `with` aktualisiert jedoch im Gegensatz zu if-Anweisungen den Punkt, sodass er auf den Wert von with verweist: ``` {{ with .Alerts }} There are {{ len . }} alert(s) {{ else }} There are no alerts {{ end }} ``` ## Variablen Variablen in text/template müssen innerhalb der Vorlage erstellt werden. Um beispielsweise eine Variable zu erstellen, die `$variable` mit dem aktuellen Wert Punkt aufgerufen wird, würden Sie Folgendes schreiben: ``` {{ $variable := . }} ``` Sie können `$variable` innerhalb eines Bereichs oder verwenden `with` und es bezieht sich auf den Wert von Punkt zu dem Zeitpunkt, als die Variable definiert wurde, und nicht auf den aktuellen Wert von Punkt. Sie können beispielsweise keine Vorlage schreiben, die den zweiten `{{ .Labels }}` Bereich verwendet, da sich Punkt hier auf das aktuelle Label bezieht, nicht auf die aktuelle Warnung: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* does not work because in the second range . is a label not an alert */}} There are {{ len .Labels }} {{ end }} {{ end }} ``` Sie können dies beheben, indem Sie eine Variable definieren, die `$alert` im ersten Bereich und vor dem zweiten Bereich aufgerufen wird: ``` {{ range .Alerts }} {{ $alert := . }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* works because $alert refers to the value of dot inside the first range */}} There are {{ len $alert.Labels }} {{ end }} {{ end }} ``` ## Bereich mit Index Sie können den Index jeder Warnung innerhalb eines Bereichs abrufen, indem Sie Index- und Wertvariablen am Anfang des Bereichs definieren: ``` {{ $num_alerts := len .Alerts }} {{ range $index, $alert := .Alerts }} This is alert {{ $index }} out of {{ $num_alerts }} {{ end }} ``` ## Definieren Sie Vorlagen Sie können Vorlagen definieren, die in anderen Vorlagen verwendet werden können, indem Sie `define` den Namen der Vorlage in doppelten Anführungszeichen verwenden. Sie sollten keine Vorlagen mit demselben Namen wie andere Vorlagen definieren, einschließlich Standardvorlagen wie `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Wenn eine Vorlage mit demselben Namen wie eine Standardvorlage oder eine Vorlage in einer anderen Benachrichtigungsvorlage erstellt wurde, kann Grafana beide Vorlagen verwenden. Grafana verhindert nicht und zeigt auch keine Fehlermeldung an, wenn es zwei oder mehr Vorlagen mit demselben Namen gibt. ``` {{ define "print_labels" }} {{ end }} ``` ## Vorlagen ausführen Sie können eine definierte Vorlage innerhalb Ihrer Vorlage ausführen`template`, indem Sie den Namen der Vorlage in doppelten Anführungszeichen und den Cursor verwenden, der an die Vorlage übergeben werden soll: ``` {{ template "print_labels" . }} ``` ## Übergeben Sie Daten an Vorlagen Innerhalb einer Vorlage bezieht sich der Punkt auf den Wert, der an die Vorlage übergeben wird. Wenn einer Vorlage beispielsweise eine Liste mit Auslösewarnungen übergeben wird, bezieht sich Punkt auf diese Liste von Auslösewarnungen: ``` {{ template "print_alerts" .Alerts }} ``` Wenn der Vorlage die sortierten Labels für eine Warnung übergeben werden, bezieht sich Punkt auf die Liste der sortierten Labels: ``` {{ template "print_labels" .SortedLabels }} ``` Dies ist nützlich, wenn Sie wiederverwendbare Vorlagen schreiben. Um beispielsweise alle Benachrichtigungen zu drucken, könnten Sie Folgendes schreiben: ``` {{ template "print_alerts" .Alerts }} ``` Um dann nur die Feuermeldungen auszudrucken, könnten Sie Folgendes schreiben: ``` {{ template "print_alerts" .Alerts.Firing }} ``` Das funktioniert, weil es sich bei beiden `.Alerts` um Listen von Warnmeldungen `.Alerts.Firing` handelt. ``` {{ define "print_alerts" }} {{ range . }} {{ template "print_labels" .SortedLabels }} {{ end }} {{ end }} ``` ## Kommentare Sie können Kommentare hinzufügen mit `{{/*` und`*/}}`: ``` {{/* This is a comment */}} ``` Um zu verhindern, dass Kommentare Zeilenumbrüche hinzufügen, verwende: ``` {{- /* This is a comment with no leading or trailing line breaks */ -}} ``` ## Einrückung Sie können Einzüge, sowohl Tabulatoren als auch Leerzeichen, und Zeilenumbrüche verwenden, um die Lesbarkeit von Vorlagen zu verbessern: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Einrückungen in der Vorlage werden jedoch auch im Text vorhanden sein. Als nächstes werden wir sehen, wie man es entfernt. ## Entferne Leerzeichen und Zeilenumbrüche Wird text/template verwendet `{{-` und dient `-}}` zum Entfernen von führenden und nachfolgenden Leerzeichen und Zeilenumbrüchen. Wenn Sie beispielsweise Einrückungen und Zeilenumbrüche verwenden, um eine Vorlage lesbarer zu machen: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Der Einzug und die Zeilenumbrüche werden auch im Text vorhanden sein: ``` alertname = "Test" grafana_folder = "Test alerts" ``` Sie können den Einzug und die Zeilenumbrüche aus dem Text entfernen, indem Sie `}}` zu `-}}` Beginn jedes Bereichs wechseln: ``` {{ range .Alerts -}} {{ range .Labels.SortedPairs -}} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Der Einzug und die Zeilenumbrüche in der Vorlage fehlen jetzt im Text: ``` alertname = "Test" grafana_folder = "Test alerts" ``` # Vorlagen für Benachrichtigungen erstellen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Erstellen Sie wiederverwendbare Benachrichtigungsvorlagen, die Sie an Ihre Kontaktstellen senden können. Sie können Ihrer Benachrichtigungsvorlage eine oder mehrere Vorlagen hinzufügen. Der Name Ihrer Benachrichtigungsvorlage muss eindeutig sein. Sie können nicht zwei Vorlagen mit demselben Namen in derselben Benachrichtigungsvorlage oder in verschiedenen Benachrichtigungsvorlagen haben. Vermeiden Sie es, Vorlagen mit demselben Namen wie Standardvorlagen zu definieren, z. B.: `__subject``__text_values_list`,`__text_alert_list`, `default.title` und`default.message`. Auf der Registerkarte Kontaktstellen finden Sie eine Liste Ihrer Benachrichtigungsvorlagen. ## Vorlagen für Benachrichtigungen erstellen **Um eine Benachrichtigungsvorlage zu erstellen** 1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“. 1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage hinzufügen**. 1. Wählen Sie einen Namen für die Benachrichtigungsvorlage, z. `email.subject` B. 1. Schreiben Sie den Inhalt der Vorlage in das Inhaltsfeld. Beispiel: ``` {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Speichern Sie Ihre Änderungen. `{{ define "email.subject" }}`(wo `email.subject` ist der Name Ihrer Vorlage) und `{{ end }}` wird automatisch am Anfang und Ende des Inhalts hinzugefügt. **Um eine Benachrichtigungsvorlage zu erstellen, die mehr als eine Vorlage enthält** 1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“. 1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage hinzufügen**. 1. Geben Sie einen Namen für die gesamte Benachrichtigungsvorlage ein. Beispiel, `email`. 1. Schreiben Sie jede Vorlage in das Feld Inhalt, einschließlich `{{ define "name-of-template" }}` und `{{ end }}` am Anfang und Ende jeder Vorlage. Sie können für jede Vorlage in der Benachrichtigungsvorlage aussagekräftige Namen verwenden, z. B. `email.subject` oder`email.message`. Verwenden Sie in diesem Fall nicht den Namen der Benachrichtigungsvorlage, den Sie oben eingegeben haben. In späteren Abschnitten finden Sie detaillierte Beispiele für Vorlagen, die Sie möglicherweise erstellen. 1. Klicken Sie auf Speichern. ## Eine Vorschau der Benachrichtigungsvorlagen anzeigen Sehen Sie sich eine Vorschau Ihrer Benachrichtigungsvorlagen an, bevor Sie sie in Ihren Kontaktstellen verwenden. Dies hilft Ihnen, das Ergebnis der von Ihnen erstellten Vorlage zu verstehen, und gibt Ihnen die Möglichkeit, etwaige Fehler zu beheben, bevor Sie die Vorlage speichern. **Anmerkung** Benachrichtigungsvorschauen sind nur für Grafana Alertmanager verfügbar. **Um eine Vorschau Ihrer Benachrichtigungsvorlagen anzuzeigen** 1. Wählen Sie „**Benachrichtigungen“,** „**Kontaktstellen**“. 1. Wählen Sie den Tab **Benachrichtigungsvorlagen** und dann **\$1 Benachrichtigungsvorlage hinzufügen** oder bearbeiten Sie eine vorhandene Vorlage. 1. Fügen Sie den Inhalt Ihrer Vorlage hinzu oder aktualisieren Sie sie. Standarddaten werden bereitgestellt, und Sie können Warndaten sowie Warnungsinstanzen hinzufügen oder bearbeiten. Sie können Warndaten direkt im Payload-Datenfenster selbst hinzufügen oder auf **Warnungsinstanzen auswählen** oder **Benutzerdefinierte Benachrichtigungen hinzufügen** klicken. 1. [Optional] So fügen Sie Warnungsdaten aus vorhandenen Warnungsinstanzen hinzu: 1. **Wählen Sie „Warnungsinstanzen** auswählen“. 1. Bewegen Sie den Mauszeiger über die Warnungsinstanzen, um weitere Informationen zu jeder Warnungsinstanz anzuzeigen/ 1. Wählen Sie **Bestätigen**, um die Warnungsinstanz zur Payload hinzuzufügen. 1. [Optional] Um Warnungsdaten mit dem Alert-Dateneditor hinzuzufügen, wählen Sie **Benutzerdefinierte Daten hinzufügen** aus: 1. Fügen Sie Anmerkungen und benutzerdefinierte Beschriftungen hinzu oder richten Sie ein Dashboard oder einen Bereich ein. 1. Aktiviere „Ausgelöst“ oder „Gelöst“, je nachdem, ob du deiner Benachrichtigung ausgelöste oder gelöste Warnmeldungen hinzufügen möchtest. 1. Wähle „**Warnungsdaten hinzufügen**“. 1. Wählen Sie **Vorschau aktualisieren**, um zu sehen, wie der Inhalt Ihrer Vorlage aussehen wird und welche Payload-Daten dazu gehören. Wenn Ihre Vorlage Fehler enthält, werden diese in der Vorschau angezeigt und Sie können sie vor dem Speichern korrigieren. 1. Speichern Sie Ihre Änderungen. ## Erstellen Sie eine Vorlage für den Betreff der Nachricht Erstellen Sie eine Vorlage für den Betreff einer E-Mail, die die Anzahl der ausgelösten und gelösten Benachrichtigungen enthält, wie in diesem Beispiel: ``` 1 firing alerts, 0 resolved alerts ``` **Um eine Vorlage für den Betreff einer E-Mail zu erstellen** 1. Erstellen Sie eine Vorlage namens `email.subject` mit dem folgenden Inhalt: ``` {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das Feld **Betreff** mit dem `template` Schlüsselwort einfügen. ``` {{ template "email.subject" . }} ``` ## Erstellen Sie eine Vorlage für die Nachricht einer E-Mail Erstellen Sie eine Vorlage für die Nachricht einer E-Mail, die eine Zusammenfassung aller ausgelösten und gelösten Alarme enthält, wie in diesem Beispiel: ``` There are 2 firing alerts, and 1 resolved alerts Firing alerts: - alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1 - alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2 Resolved alerts: - alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0 ``` **Um eine Vorlage für die Nachricht einer E-Mail zu erstellen** 1. Erstellen Sie eine Benachrichtigungsvorlage `email` mit zwei Vorlagen im Inhalt: `email.message_alert` und`email.message`. Die `email.message_alert` Vorlage wird verwendet, um die Bezeichnungen und Werte für jede ausgelöste und behobene Warnung zu drucken, wobei die `email.message` Vorlage die Struktur der E-Mail enthält. ``` {{- define "email.message_alert" -}} {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s) {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }} {{- end -}} {{ define "email.message" }} There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts {{ if .Alerts.Firing -}} Firing alerts: {{- range .Alerts.Firing }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ if .Alerts.Resolved -}} Resolved alerts: {{- range .Alerts.Resolved }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ end }} ``` 1. Verwenden Sie die Vorlage bei der Erstellung Ihrer Kontaktpunktintegration, indem Sie sie in das **Textfeld** mit dem `template` Schlüsselwort einfügen. ``` {{ template "email.message" . }} ``` ## Eine Vorlage für den Titel einer Slack-Nachricht erstellen Erstelle eine Vorlage für den Titel einer Slack-Nachricht, die die Anzahl der ausgelösten und gelösten Alerts enthält, wie im folgenden Beispiel: ``` 1 firing alerts, 0 resolved alerts ``` **Um eine Vorlage für den Titel einer Slack-Nachricht zu erstellen** 1. Erstelle eine Vorlage namens `slack.title` mit dem folgenden Inhalt: ``` {{ define "slack.title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Führen Sie die Vorlage über das Titelfeld in Ihrer Kontaktpunktintegration aus. ``` {{ template "slack.title" . }} ``` ## Eine Vorlage für den Inhalt einer Slack-Nachricht erstellen Erstelle eine Vorlage für den Inhalt einer Slack-Nachricht, die eine Beschreibung aller ausgelösten und gelösten Alerts enthält, einschließlich ihrer Labels, Anmerkungen und Dashboard-URL. **Anmerkung** Diese Vorlage ist nur für von Grafana verwaltete Benachrichtigungen vorgesehen. Um die Vorlage für von Datenquellen verwaltete Benachrichtigungen zu verwenden, löschen Sie die Verweise auf dashboardURL und silenceUrl. Weitere Informationen zur Konfiguration von Prometheus-Benachrichtigungen finden Sie in der [Prometheus-Dokumentation](https://prometheus.io/docs/alerting/latest/notifications/) zu Benachrichtigungen. ``` 1 firing alerts: [firing] Test1 Labels: - alertname: Test1 - grafana_folder: GrafanaCloud Annotations: - description: This is a test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 1 resolved alerts: [firing] Test2 Labels: - alertname: Test2 - grafana_folder: GrafanaCloud Annotations: - description: This is another test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 ``` **Um eine Vorlage für den Inhalt einer Slack-Nachricht zu erstellen** 1. Erstelle ein Template namens `slack` mit zwei Templates im Inhalt: `slack.print_alert` und`slack.message`. Die `slack.print_alert` Vorlage wird zum Drucken der Beschriftungen, Anmerkungen und der Dashboard-URL verwendet, während die `slack.message` Vorlage die Struktur der Benachrichtigung enthält. ``` {{ define "slack.print_alert" -}} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ if .Annotations -}} Annotations: {{ range .Annotations.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ end -}} {{ if .DashboardURL -}} Go to dashboard: {{ .DashboardURL }} {{- end }} {{- end }} {{ define "slack.message" -}} {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts: {{ range .Alerts.Firing }} {{ template "slack.print_alert" . }} {{ end -}} {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts: {{ range .Alerts.Resolved }} {{ template "slack.print_alert" .}} {{ end -}} {{ end }} {{- end }} ``` 1. Führen Sie die Vorlage über das Textfeld in Ihrer Kontaktpunktintegration aus: ``` {{ template "slack.message" . }} ``` ## Template sowohl für E-Mail als auch für Slack mit gemeinsam genutzten Vorlagen Anstatt separate Benachrichtigungsvorlagen für jeden Kontaktpunkt wie E-Mail und Slack zu erstellen, kannst du dieselbe Vorlage gemeinsam nutzen. Wenn du beispielsweise eine E-Mail mit diesem Betreff und eine Slack-Nachricht mit diesem Titel senden möchtest`1 firing alerts, 0 resolved alerts`, kannst du eine gemeinsame Vorlage erstellen. **Um eine gemeinsame Vorlage zu erstellen** 1. Erstellen Sie eine Vorlage namens `common.subject_title` mit dem folgenden Inhalt: ``` {{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Führen Sie für E-Mails die Vorlage im Betreff-Feld Ihrer E-Mail-Kontaktpunkt-Integration aus: ``` {{ template "common.subject_title" . }} ``` 1. Für Slack führe die Vorlage im Titelfeld deiner Slack-Kontaktpunkt-Integration aus: ``` {{ template "common.subject_title" . }} ``` ## Verwenden von Benachrichtigungsvorlagen Verwenden Sie Vorlagen in Kontaktpunkten, um Ihre Benachrichtigungen zu personalisieren. **Um eine Vorlage beim Erstellen einer Kontaktstelle zu verwenden** 1. Wählen Sie im Menü **„Benachrichtigungen**“ die Registerkarte „**Kontaktstellen**“, um eine Liste der vorhandenen Kontaktstellen anzuzeigen. 1. Wählen Sie **New (Neu)**. Alternativ können Sie eine bestehende Kontaktstelle bearbeiten, indem Sie auf das Symbol **Bearbeiten** klicken. 1. Geben Sie die Vorlagen, die Sie verwenden möchten, in ein Feld ein, z. B. **Nachricht** oder **Betreff**. Um eine Vorlage einzugeben, verwenden Sie das Formular `{{ template "template_name" . }}` und *template\$1name* ersetzen Sie es durch den Namen der Vorlage, die Sie verwenden möchten. 1. Wählen Sie **Kontaktstelle speichern**. # Vorlage – Referenz **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen. **Warnung (Typ)** Der Warnungstyp enthält die folgenden Daten. | Name | Art | Description | Beispiel | | --- | --- | --- | --- | | Status | Zeichenfolge | `firing` oder `resolved`. | \$1\$1 .Status \$1\$1 | | Labels | KeyValue | Eine Reihe von Bezeichnungen, die an die Warnung angehängt sind. | \$1\$1 .Labels \$1\$1 | | Anmerkungen | KeyValue | Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. | \$1\$1 .Annotations \$1\$1 | | Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen | \$1\$1 .Values \$1\$1 | | StartsAt | Zeit.Zeit | Uhrzeit, zu der der Alarm ausgelöst wurde. | \$1\$1 .StartsAt \$1\$1 | | EndsAt | Zeit. Zeit | Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt. | \$1\$1 .EndsAt \$1\$1 | | Generator-URL | Zeichenfolge | Ein Backlink zu Grafana oder einem externen Alertmanager. | \$1\$1 .GeneratorURL \$1\$1 | | Silence-URL | Zeichenfolge | Ein Link zum Stummschalten der Warnung (mit vorgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .SilenceURL\$1\$1 | | Dashboard-URL | Zeichenfolge | Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .DashboardURL \$1\$1 | | Panel-URL | Zeichenfolge | Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. | \$1\$1 .PanelURL \$1\$1 | | Fingerabdruck | Zeichenfolge | Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. | \$1\$1 .Fingerprint \$1\$1 | | ValueString | Zeichenfolge | Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. | \$1\$1 .ValueString \$1\$1 | **ExtendedData** Das ExtendedData Objekt enthält die folgenden Eigenschaften. | Name | Art | Description | Beispiel | | --- | --- | --- | --- | | Empfänger | `string` | Der Name der Kontaktstelle, die die Benachrichtigung sendet. | `{{ .Receiver }}` | | Status | `string` | Der Status gibt an`firing`, ob mindestens ein Alarm ausgelöst wird, andernfalls`resolved`. | `{{ .Status }}` | | Benachrichtigungen | `[]Alert` | Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung. | `There are {{ len .Alerts }} alerts` | | Auslösewarnungen | `[]Alert` | Liste aller Feuerwarnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Firing }} firing alerts` | | Behobene Warnungen | `[]Alert` | Liste aller gelösten Warnungen in dieser Benachrichtigung. | `There are {{ len .Alerts.Resolved }} resolved alerts` | | GroupLabels | `KeyValue` | Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren. | `{{ .GroupLabels }}` | | CommonLabels | `KeyValue` | Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonLabels }}` | | CommonAnnotations | `KeyValue` | Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind. | `{{ .CommonAnnotations }}` | | Externe URL | `string` | Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat. | `{{ .ExternalURL }}` | **KeyValue Typ** Der `KeyValue` Typ besteht aus einer Reihe von key/value Zeichenkettenpaaren, die Beschriftungen und Anmerkungen darstellen. Neben dem direkten Zugriff auf die als `KeyValue` gespeicherten Daten gibt es auch Methoden zum Sortieren, Entfernen und Transformieren der Daten. | Name | Argumente | Rückgabewert | Hinweise | Beispiel | | --- | --- | --- | --- | --- | | SortedPairs | | Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert | | `{{ .Annotations.SortedPairs }}` | | Remove | [] Zeichenfolge | KeyValue | Gibt eine Kopie der Key/Value Map ohne die angegebenen Schlüssel zurück. | `{{ .Annotations.Remove "summary" }}` | | Namen | | [] Zeichenfolge | Liste der Namen | `{{ .Names }}` | | Werte | | [] Zeichenfolge | Liste von Werten | `{{ .Values }}` | **Time (Zeit)** Die Zeit stammt aus dem [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)Go-Paket. Sie können eine Uhrzeit in verschiedenen Formaten drucken. Um beispielsweise die Uhrzeit zu drucken, zu der eine Warnung ausgelöst wurde`Monday, 1st January 2022 at 10:00AM`, in diesem Format schreiben Sie die folgende Vorlage: ``` {{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }} ``` Eine Referenz für das Zeitformat von Go finden Sie [hier](https://pkg.go.dev/time#pkg-constants). # Kontaktstellen verwalten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) In der Listenansicht der **Kontaktpunkte** werden alle vorhandenen Kontaktstellen und Benachrichtigungsvorlagen aufgeführt. Auf der Registerkarte **Kontaktstellen** können Sie: + Suchen Sie nach Namen und Typen von Kontaktstellen und Integrationen. + Sehen Sie sich alle vorhandenen Kontaktstellen und Integrationen an. + Sehen Sie sich an, für wie viele Benachrichtigungsrichtlinien jeder Kontaktpunkt verwendet wird, und navigieren Sie direkt zu den verknüpften Benachrichtigungsrichtlinien. + Sehen Sie sich den Status der Zustellungen von Benachrichtigungen an. + Exportieren Sie einzelne Kontaktpunkte oder alle Kontaktpunkte im JSON-, YAML- oder Terraform-Format. + Löschen Sie Kontaktpunkte, die nicht von einer Benachrichtigungsrichtlinie verwendet werden. Auf der Registerkarte **Benachrichtigungsvorlagen** können Sie: + Bestehende Benachrichtigungsvorlagen anzeigen, bearbeiten, kopieren oder löschen. # Warnmeldungen stummschalten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) *Sie können Warnmeldungen unterdrücken, indem Sie sie stumm schalten.* Eine Stille verhindert nur, dass Benachrichtigungen erstellt werden: Stummschaltungen verhindern nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Wenn Sie eine Warnung stummschalten, geben Sie ein Zeitfenster an, in dem sie unterdrückt werden soll. **Anmerkung** Um Warnmeldungen in regelmäßigen Zeitabständen zu unterdrücken, z. B. während regulärer Wartungsperioden, sollten Sie [Timings stummschalten](v10-alerting-manage-muting.md) eher die Option „Stummschalten“ verwenden. **Um eine Stille hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. **Wählen Sie Stille.** 1. **Wählen Sie einen Alertmanager aus dem Alertmanager-Drop-down-Menü aus.** 1. Wählen Sie **„**Stille erstellen“. 1. Wählen Sie das Start- und Enddatum **unter Start und Ende der Stille** aus, um anzugeben, wann die Stille in Kraft treten und wann sie enden soll. 1. Als Alternative zur Festlegung einer Endzeit können Sie im Feld **Dauer** angeben, wie lange die Stille durchgesetzt werden soll. Dadurch wird die Endzeit im Feld **Start und Ende der Stille** automatisch aktualisiert. 1. Geben Sie in den Feldern **Bezeichnung** und **Wert** ein oder mehrere *passende Labels* ein. Matcher bestimmen, für welche Regeln das Schweigen gilt. Alle passenden Warnmeldungen (im Status „Auslösen“) werden im Feld **Betroffene Warnmeldungen angezeigt**. 1. Fügen Sie optional einen **Kommentar** hinzu, der die Stille beschreibt. 1. Wählen Sie **Absenden** aus. **Um eine Stille zu bearbeiten** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille anzuzeigen. 1. Suchen Sie nach der Stille, die Sie bearbeiten möchten, und wählen Sie dann **Bearbeiten** (Stiftsymbol). 1. Nehmen Sie die gewünschten Änderungen vor und wählen Sie dann **Absenden**, um Ihre Änderungen zu speichern. Sie können eine bestehende Stille bearbeiten, indem Sie das **Bearbeiten-Symbol** (Stift) wählen. **Um einen URL-Link zu einem Stilleformular zu erstellen** Wenn Sie auf ein Silence-Formular verlinken, geben Sie die standardmäßigen passenden Labels sowie die Parameter für die Kommentarfunktion `matcher` und die `comment` Abfrageparameter an. Der `matcher` Parameter sollte das folgende Format haben, `[label][operator][value]` wobei der `operator` Parameter eines der folgenden sein kann: `=` (equals, not regex), (not equals, not regex), `!=` (equals, regex), `=~` (not equals, regex). `!~` Die URL kann viele `matcher` Abfrageparameter mit dem Schlüssel enthalten. Um beispielsweise einen Link zu einem Silence-Formular mit den passenden Bezeichnungen `severity=critical` `cluster!~europe-.*` und Kommentar zu erstellen`Silence critical EU alerts`, erstellen Sie eine URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`. Um einen Link zu einer neuen Silence-Seite für einen externen Alertmanager zu erstellen, fügen Sie einen `alertmanager` Abfrageparameter hinzu **Um eine Stille zu entfernen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Stille**, um die Liste der vorhandenen Stille anzuzeigen. 1. **Wählen Sie die Stille aus, die Sie beenden möchten, und wählen Sie „Stille aufheben“.** Dadurch wird die Unterdrückung von Alarmen beendet. **Anmerkung** Durch das Aufheben der Stummschaltung wird die Unterdrückung von Alarmen beendet, als ob die Endzeit für die aktuelle Uhrzeit festgelegt wäre. Stille, die (automatisch oder manuell) beendet wurde, werden fünf Tage lang beibehalten und in der Liste aufgeführt. Sie können eine Stille nicht manuell aus der Liste entfernen. # Warnungsregeln anzeigen und filtern **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Auf der Seite „**Benachrichtigungen“ werden Warnregeln aufgeführt.** Standardmäßig sind Regeln nach Datenquellentypen gruppiert. Der Abschnitt **Grafana** listet Regeln auf, die von Grafana verwaltet werden. Warnregeln für Prometheus-kompatible Datenquellen sind ebenfalls hier aufgeführt. Sie können Warnregeln für Prometheus-kompatible Datenquellen anzeigen, sie jedoch nicht bearbeiten. Im Abschnitt Mimir/Cortex/Loki Regeln sind alle Regeln für Mimir-, Cortex- oder Loki-Datenquellen aufgeführt. Cloud-Warnungsregeln sind ebenfalls in diesem Abschnitt aufgeführt. Bei der Verwaltung großer Mengen von Benachrichtigungen können Sie erweiterte Funktionen zur Suche nach Warnungsregeln verwenden, um nach Ordnern, Bewertungsgruppen und Regeln zu filtern. Darüber hinaus können Sie Warnungsregeln nach ihren Eigenschaften wie Bezeichnungen, Status, Typ und Zustand filtern. ## Warnungsregeln anzeigen Mit Grafana-Benachrichtigungen können Sie alle Ihre Benachrichtigungen auf einer Seite anzeigen. **Um die Details der Benachrichtigungen anzuzeigen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü **Alerting, Alert-Regeln aus**.** Standardmäßig wird die Listenansicht angezeigt. 1. In **Ansicht als** können Sie zwischen den Ansichten Gruppiert, Listen und Status wechseln, indem Sie die gewünschte Option auswählen. 1. Erweitern Sie die Regelzeile, um die Regelbezeichnungen, Anmerkungen, Datenquellen, die Regelabfragen und eine Liste der Warnungsinstanzen anzuzeigen, die sich aus der Regel ergeben. Auf dieser Seite können Sie auch Kopien einer Warnungsregel erstellen, um bestehende Regeln wiederzuverwenden. ## Warnungsregeln exportieren Sie können Regeln im Grafana-Arbeitsbereich nach YAML oder JSON exportieren. + Wählen Sie das Symbol **Regelgruppe exportieren** neben jeder Warnungsregelgruppe, um sie nach YAML, JSON oder Terraform zu exportieren. + Wählen Sie **Regeln exportieren**, um alle von Grafana verwalteten Warnungsregeln nach YAML, JSON oder Terraform zu exportieren. + Wählen Sie neben jeder einzelnen Warnungsregel innerhalb einer Gruppe die Option **Mehr**, **Export ändern** aus, um bereitgestellte Warnungsregeln zu bearbeiten und eine geänderte Version zu exportieren. ## Abfragedefinitionen für bereitgestellte Benachrichtigungen anzeigen Zeigt schreibgeschützte Abfragedefinitionen für bereitgestellte Benachrichtigungen an. Prüfen Sie schnell, ob Ihre Warnungsregelabfragen korrekt sind, ohne in Ihrem As-Code-Repository nach Regeldefinitionen suchen zu müssen. **Gruppierte Ansicht** Die gruppierte Ansicht zeigt Grafana-Warnungsregeln gruppiert nach Ordnern und Loki- oder Prometheus-Alarmregeln gruppiert nach \$1. `namespace` `group` Dies ist die Standardregellistenansicht, die für die Verwaltung von Regeln vorgesehen ist. Sie können jede Gruppe erweitern, um eine Liste der Regeln in dieser Gruppe anzuzeigen. Erweitern Sie eine Regel weiter, um ihre Details anzuzeigen. Sie können auch Aktionsschaltflächen und Warnmeldungen, die sich aus der Regel ergeben, erweitern, um deren Details anzuzeigen. **Ansicht „Status“** In der Statusansicht werden die Warnungsregeln nach Bundesland gruppiert angezeigt. Verwenden Sie diese Ansicht, um einen Überblick darüber zu erhalten, welche Regeln sich in welchem Status befinden. Jede Regel kann erweitert werden, um ihre Details anzuzeigen. Aktionsschaltflächen und alle durch diese Regel generierten Warnungen. Jede Warnung kann weiter erweitert werden, um ihre Details anzuzeigen. ## Regeln für Warnmeldungen filtern Sie können die Warnregeln, die auf der Seite „**Benachrichtigungen**“ angezeigt werden, auf verschiedene Arten filtern. **Um Warnungsregeln zu filtern** 1. **Wählen Sie unter Datenquellen** auswählen eine Datenquelle aus. Sie können Warnungsregeln sehen, die die ausgewählte Datenquelle abfragen. 1. Geben Sie im Feld **Nach Label suchen mithilfe von** Label-Selektoren Suchkriterien ein. Beispiel, `environment=production;region=~US|EU,severity!=warning`. 1. Wählen Sie **unter Benachrichtigungen nach Status filtern** den Warnstatus aus, den Sie sehen möchten. Sie können sich Warnregeln anzeigen lassen, die diesem Status entsprechen. Regeln, die anderen Bundesstaaten entsprechen, sind ausgeblendet. # Timings stummschalten **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Eine Stummschaltung ist ein wiederkehrendes Zeitintervall, in dem keine neuen Benachrichtigungen für eine Richtlinie generiert oder gesendet werden. Verwenden Sie sie, um zu verhindern, dass Warnmeldungen für einen bestimmten und sich wiederholenden Zeitraum ausgelöst werden, z. B. während eines regulären Wartungszeitraums. Ähnlich wie bei Stummschaltungen verhindern auch Stummschaltungen nicht, dass Warnungsregeln ausgewertet werden, und sie verhindern auch nicht, dass Warnungsinstanzen auf der Benutzeroberfläche angezeigt werden. Sie verhindern lediglich, dass Benachrichtigungen erstellt werden. Sie können von Grafana verwaltete Stummschaltezeiten sowie Stummschaltezeiten für eine externe Alertmanager-Datenquelle konfigurieren. ## Stummschalten im Vergleich zu Stille In der folgenden Tabelle werden die Unterschiede zwischen Stummschaltezeiten und Stummschaltungen hervorgehoben. | Timing stummschalten | Stumm | | --- | --- | | Verwendet Zeitintervalldefinitionen, die sich wiederholen können. | Hat eine feste Start- und Endzeit. | | Wird erstellt und dann zu den Benachrichtigungsrichtlinien hinzugefügt. | Verwendet Labels, um mit einer Warnung abzugleichen, um zu bestimmen, ob stummgeschaltet werden soll oder nicht. | ## Timing für Stummschaltung hinzufügen Sie können in Ihrem Grafana-Arbeitsbereich Stummschaltungen erstellen. **Um ein Timing für die Stummschaltung hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte Timings **stummschalten**. 1. Wählen Sie in der Dropdownliste **Alertmanager** den Alertmanager aus, den Sie bearbeiten möchten. 1. Wählen Sie die Taste **\$1** Timing für Stummschaltung hinzufügen. 1. Füllen Sie das Formular aus, um ein [Zeitintervall](#v10-alerting-manage-muting-interval) zu erstellen, das mit Ihrem Timing für die Stummschaltung übereinstimmt. 1. Speichern Sie Ihre Stummschaltung. ## Hinzufügen eines Timings für die Stummschaltung zu einer Benachrichtigungsrichtlinie Sobald Sie einen Zeitpunkt für die Stummschaltung festgelegt haben, verwenden Sie ihn, indem Sie ihn der Benachrichtigungsrichtlinie hinzufügen, die Sie in regelmäßigen Abständen stummschalten möchten. **Um einer Benachrichtigungsrichtlinie einen Zeitpunkt für die Stummschaltung hinzuzufügen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Benachrichtigungsrichtlinien** und dann die Registerkarte **Benachrichtigungsrichtlinien** aus. 1. Wählen Sie die Benachrichtigungsrichtlinie aus, der Sie die Stummschaltung hinzufügen möchten, und wählen Sie**...** , **Bearbeiten**. 1. Wählen Sie in der Dropdownliste **für die Stummschaltung** die Zeiten für die Stummschaltung aus, die Sie der Richtlinie hinzufügen möchten. 1. Speichern Sie Ihre Änderungen. ## Zeitintervalle Ein Zeitintervall ist eine bestimmte Dauer, in der Warnmeldungen unterdrückt werden. Die Dauer besteht in der Regel aus einem bestimmten Zeitraum und den Tagen der Woche, des Monats oder des Jahres. Die Optionen für das Supportzeitintervall sind: + **Zeitbereich** — Die Zeit inklusive Start- und Endzeit (in UTC, wenn kein Standort ausgewählt wurde, andernfalls Ortszeit). + **Standort** — Legt den Ort für das Timing fest. Der Zeitraum wird in Ortszeit für den Standort angezeigt. + **Wochentage** — Der Tag oder Bereich von Wochentagen. Beispiel, `monday:thursday`. + **Tage des Monats** — Die Daten innerhalb eines Monats. Die Werte können im Bereich von `1` - liegen`31`. Negative Werte geben die Tage des Monats in umgekehrter Reihenfolge an, `-1` stellen also den letzten Tag des Monats dar. + **Monate** — Die Monate des Jahres in numerischer oder vollständiger Kalendermonatsbezeichnung. Beispiel, `1, may:august`. + **Jahre** — Das Jahr oder die Jahre für das Intervall. Beispiel, `2023:2024`. Jedes dieser Elemente kann eine Liste sein, und mindestens ein Element im Element muss erfüllt sein, um eine Übereinstimmung zu erhalten. Felder unterstützen auch Bereiche mithilfe von`:`. Beispiel, `monday:thursday`. Wenn ein Feld leer gelassen wird, entspricht jeder Zeitpunkt dem Feld. Damit ein Moment von einem kompletten Zeitintervall entspricht, müssen alle Felder übereinstimmen. Ein Timing für die Stummschaltung kann mehrere Zeitintervalle enthalten. Wenn Sie eine genaue Dauer angeben möchten, geben Sie alle für diese Dauer erforderlichen Optionen an. Wenn Sie beispielsweise ein Zeitintervall für den ersten Montag des Monats, für März, Juni, September und Dezember, zwischen 12:00 und 24:00 Uhr UTC erstellen möchten, könnte Ihre Zeitintervallspezifikation wie folgt lauten: + Zeitbereich: + Startzeit: `12:00` + Endzeit: `24:00` + Wochentage: `monday` + Monate: `3, 6, 9, 12` + Tage des Monats: `1:7` # Status und Zustand der Warnungsregeln anzeigen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Anhand des Status und der Integrität von Warnungsregeln erhalten Sie mehrere wichtige Statusindikatoren für Ihre Benachrichtigungen. Es gibt drei Komponenten: + [Status der Warnungsregel](#v10-alerting-manage-rulestate-state) + [Status der Warnungsinstanz](#v10-alerting-manage-rulestate-instance) + [Zustand der Warnmeldungsregel](#v10-alerting-manage-rulestate-health) Obwohl sie miteinander verwandt sind, vermittelt jede Komponente subtil unterschiedliche Informationen. **Um den Status und den Zustand Ihrer Warnungsregeln einzusehen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Warnungsregeln**, um die Liste der vorhandenen Benachrichtigungen anzuzeigen. 1. Wählen Sie eine Warnungsregel aus, um deren Status und Zustand einzusehen. ## Status der Warnungsregel Eine Warnungsregel kann sich in einem der folgenden Status befinden: | Status | Description | | --- | --- | | Normal | Keine der von der Evaluierungs-Engine zurückgegebenen Zeitreihen hat den firing Status „pendingOder“. | | Ausstehend | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istpending. | | Wird gefeuert | Mindestens eine von der Evaluierungs-Engine zurückgegebene Zeitreihe istfiring. | **Anmerkung** Warnmeldungen werden zuerst auf `pending` und dann `firing` übertragen. Daher dauert es mindestens zwei Bewertungszyklen, bis eine Warnung ausgelöst wird. ## Status der Warnungsinstanz Eine Warnungsinstanz kann sich in einem der folgenden Zustände befinden: | Status | Description | | --- | --- | | Normal | Der Status einer Warnung, die pending weder noch istfiring. Alles funktioniert wie erwartet. | | Ausstehend | Der Status einer Warnung, die für weniger als die konfigurierte Schwellenwertdauer aktiv war. | | Warnfunktion | Der Status einer Warnung, die länger als die konfigurierte Schwellenwertdauer aktiv war. | | Keine Daten | Für das konfigurierte Zeitfenster wurden keine Daten empfangen. | | Warnfunktion | Beim Versuch, eine Warnregel auszuwerten, ist ein Fehler aufgetreten. | ## Letzten Status beibehalten Eine Warnungsregel kann so konfiguriert werden, dass der letzte Status beibehalten wird, wenn ein `NoData` oder `Error` -Zustand auftritt. Dadurch wird sowohl verhindert, dass Warnmeldungen ausgelöst werden, als auch, dass sie behoben und erneut ausgelöst werden. Genau wie bei der normalen Evaluierung wird die Warnungsregel von `pending` zu `firing` nach Ablauf der Wartezeit umgestellt. ## Zustand der Warnmeldungsregel Eine Warnungsregel kann einen der folgenden Integritätsstatus haben. | Status | Description | | --- | --- | | Ok | Keine Fehler bei der Auswertung der Warnungsregel. | | Fehler | Bei der Auswertung der Warnungsregel ist ein Fehler aufgetreten. | | NoData | Das Fehlen von Daten in mindestens einer Zeitreihe, die während einer Regelauswertung zurückgegeben wurde. | | \$1Status\$1, KeepLast | Die Regel hätte einen anderen Status erhalten, wurde aber so konfiguriert, dass sie den letzten Status der Warnungsregel beibehält. | ## Besondere Warnmeldungen für NoData und Fehler Wenn die Auswertung einer Warnungsregel den Status `NoData` oder ergibt`Error`, generiert Grafana-Alerting Warninstanzen mit den folgenden zusätzlichen Bezeichnungen. | Label (Bezeichnung) | Description | | --- | --- | | Name der Warnung | Entweder DatasourceNoData oderDatasourceError, je nach Bundesland. | | datasource\$1uid | Die UID der Datenquelle, die den Status verursacht hat. | **Anmerkung** Um die zusätzlichen Beschriftungen zu generieren, müssen Sie, wie im [Konfigurieren Sie die verwalteten Warnungsregeln von Grafana](v10-alerting-configure-grafanamanaged.md) Thema beschrieben, `Error` in der Regel „Keine Daten“ `NoData` oder „Fehler behandeln“ auf oder in der Warnungsregel festlegen. Sie können diese Benachrichtigungen auf die gleiche Weise behandeln wie normale Benachrichtigungen, einschließlich Hinzufügen von Stille, Weiterleitung an eine Kontaktstelle usw. # Warnungsgruppen anzeigen und nach Warnungsgruppen filtern **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Warnungsgruppen zeigen gruppierte Alerts aus einer Alertmanager-Instanz an. Standardmäßig werden Warnungsregeln in Benachrichtigungsrichtlinien nach den Labelschlüsseln für die Standardrichtlinie gruppiert. Durch die Gruppierung allgemeiner Warnungsregeln in einer einzigen Warnungsgruppe wird verhindert, dass doppelte Warnungsregeln ausgelöst werden. Sie können Warnungsgruppen anzeigen und auch nach Warnungsregeln filtern, die bestimmten Kriterien entsprechen. **Um Warnungsgruppen anzuzeigen** 1. **Wählen Sie in Ihrer Grafana-Konsole im Grafana-Menü Alerting.** 1. Wählen Sie **Gruppen, um bestehende Gruppen** anzuzeigen. 1. Wählen Sie in der **Alertmanager-Dropdownliste** einen externen Alertmanager als Datenquelle aus. 1. Wählen Sie aus der Dropdownliste **Benutzerdefiniert gruppieren nach eine Kombination von** Bezeichnungen aus, um eine andere Gruppierung als die Standardgruppierung anzuzeigen. Dies ist nützlich, um Ihre Gruppierung von Benachrichtigungsrichtlinien zu debuggen und zu überprüfen. Wenn eine Warnung keine Bezeichnungen enthält, die entweder in der Gruppierung der Stammrichtlinie oder in der benutzerdefinierten Gruppierung angegeben wurden, wird die Warnung einer Catch-All-Gruppe mit dem Header von hinzugefügt. `No grouping` Sie können Warnungen nach Bezeichnung oder Status der Benachrichtigungen filtern. **Um nach Label zu filtern** + Geben Sie **unter Suchen** ein vorhandenes Label ein, um Benachrichtigungen anzuzeigen, die dem Label entsprechen. Beispiel, `environment=production,region=~US|EU,severity!=warning`. **Um nach Bundesland zu filtern** + Wählen Sie unter **Staaten den** Status Aktiv, Unterdrückt oder Nicht verarbeitet aus, um Benachrichtigungen anzuzeigen, die Ihrem ausgewählten Status entsprechen. Alle anderen Benachrichtigungen sind ausgeblendet. # Benachrichtigungsfehler anzeigen **** Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen. Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md) Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md) Sehen Sie sich Benachrichtigungsfehler an und erfahren Sie, warum sie nicht gesendet oder empfangen wurden. **Anmerkung** Diese Funktion wird nur für Grafana Alertmanager unterstützt. **Um Benachrichtigungsfehler anzuzeigen** 1. Wählen Sie im Menü auf der linken Seite **Benachrichtigungen und** dann **Kontaktstellen** aus. Wenn eine Kontaktstelle ausfällt, werden Sie in einer Meldung in der rechten Ecke des Arbeitsbereichs darüber informiert, dass und wie viele Fehler vorliegen. 1. Wählen Sie eine Kontaktstelle aus, um die Details der Fehler für diese Kontaktstelle einzusehen. Fehlerdetails werden angezeigt, wenn Sie den Mauszeiger über das Fehlersymbol bewegen. Wenn eine Kontaktstelle über mehr als eine Integration verfügt, werden alle Fehler für jede der aufgelisteten Integrationen angezeigt. 1. Überprüfen Sie in der Spalte Health den Status der Benachrichtigung. Dies kann entweder „OK“, „Keine Versuche“ oder „Fehler“ lauten.