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.
Kontaktpunkte konfigurieren
Dieses Dokumentationsthema wurde für Grafana-Arbeitsbereiche entwickelt, die Grafana-Version 12.x unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 10
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8
Definieren Sie mithilfe von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Alarmregel ausgelöst wird.
Anmerkung
Sie können Kontaktstellen für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktstellen für Benachrichtigungen, die von Datenquellen verwaltet werden, sind schreibgeschützt.
Mit Kontaktstellen arbeiten
Die folgenden Verfahren zeigen, wie eine Kontaktstelle hinzugefügt, bearbeitet, gelöscht und getestet wird.
So fügen Sie einen Kontaktpunkt hinzu
-
Wählen Sie im Menü auf der linken Seite Alerting aus.
-
Wählen Sie Kontaktstellen aus.
-
Wählen Sie aus der Dropdownliste Choose Alertmanager einen Alertmanager aus. Der Grafana-Alertmanager ist standardmäßig ausgewählt.
-
Wählen Sie auf der Registerkarte Kontaktpunkte die Option + Kontaktstelle hinzufügen.
-
Geben Sie einen Namen für die Kontaktstelle ein.
-
Wählen Sie unter Integration einen Typ aus und füllen Sie die Pflichtfelder entsprechend diesem Typ aus. Wenn du dich zum Beispiel für Slack entscheidest, gib die Slack-Kanäle und Nutzer ein, die kontaktiert werden sollen.
-
Falls für die von dir gewählte Kontaktstelle verfügbar, wähle die gewünschten Optionalen Einstellungen, um zusätzliche Einstellungen festzulegen.
-
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.
-
Um eine weitere Kontaktpunkt-Integration hinzuzufügen, wählen Sie Kontaktpunkt-Integration hinzufügen und wiederholen Sie die Schritte für jeden benötigten Kontaktpunkttyp.
-
Speichern Sie Ihre Änderungen.
Um eine Kontaktstelle zu bearbeiten
-
Wählen Sie im Menü auf der linken Seite Alerting aus.
-
Wählen Sie Kontaktpunkte, um eine Liste der vorhandenen Kontaktstellen anzuzeigen.
-
Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann Bearbeiten aus.
-
Aktualisieren Sie den Kontaktpunkt und speichern Sie dann Ihre Änderungen.
Sie können Kontaktpunkte löschen, die von einer Benachrichtigungsrichtlinie nicht verwendet werden.
Um eine Kontaktstelle zu löschen
-
Wählen Sie im Menü auf der linken Seite Alerting aus.
-
Wählen Sie Kontaktstellen, um die Liste der vorhandenen Kontaktstellen zu öffnen.
-
Wählen Sie auf den Kontaktpunkten den Kontaktpunkt aus, den Sie löschen möchten, und wählen Sie dann Mehr, Löschen.
-
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 bearbeiten, sodass ein anderer Kontaktpunkt verwendet wird, bevor Sie den Kontaktpunkt löschen.
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
-
Wählen Sie im Menü auf der linken Seite Alerting aus.
-
Wählen Sie Kontaktstellen, um die Liste der vorhandenen Kontaktstellen zu öffnen.
-
Wählen Sie unter Kontaktpunkte den Kontaktpunkt aus, den Sie testen möchten, und wählen Sie dann Bearbeiten aus. Bei Bedarf können Sie auch eine neue Kontaktstelle erstellen.
-
Wählen Sie Testen, um das Dialogfeld zum Testen von Kontaktpunkten zu öffnen.
-
Wählen Sie, ob Sie eine vordefinierte Testbenachrichtigung senden möchten, oder wählen Sie Benutzerdefiniert, um der Testbenachrichtigung Ihre eigenen benutzerdefinierten Anmerkungen und Beschriftungen hinzuzufügen.
-
Wählen Sie Testbenachrichtigung senden, um die Warnung mit den angegebenen Kontaktpunkten zu testen.
Konfigurieren Sie die Integrationen von Kontaktstellen
Konfigurieren Sie Kontaktpunkt-Integrationen in Grafana, um Ihren bevorzugten Kommunikationskanal für den Empfang von Benachrichtigungen auszuwählen, wenn Ihre Alarmregeln ausgelöst werden. Jede Integration hat ihre eigenen Konfigurationsoptionen und ihren eigenen Einrichtungsprozess. In den meisten Fällen beinhaltet dies die Bereitstellung eines API-Schlüssels oder einer Webhook-URL.
Nach der Konfiguration können Sie Integrationen als Teil Ihrer Kontaktstellen verwenden, um Benachrichtigungen zu erhalten, wenn sich der Status Ihrer Warnung ändert. In diesem Abschnitt behandeln wir die grundlegenden Schritte zur Konfiguration einer Integration anhand eines PagerDuty Beispiels, damit Sie Benachrichtigungen in Echtzeit erhalten und den Überblick über Ihre Überwachungsdaten behalten können.
Liste der unterstützten Integrationen
In der folgenden Tabelle sind die von Grafana unterstützten Kontaktpunkttypen aufgeführt.
| Name | Typ |
|---|---|
Amazon SNS |
|
PagerDuty |
|
Slack |
|
VictorOps |
|
Konfiguration PagerDuty für Warnmeldungen
Für die Einrichtung PagerDuty müssen Sie einen Integrationsschlüssel angeben. Geben Sie die folgenden Details an.
| Einstellung | Description |
|---|---|
| Integrationsschlüssel | Integrationsschlüssel für PagerDuty |
| Schweregrad | Stufe für dynamische Benachrichtigungen. Der Standardwert ist critical. |
| Benutzerdefinierte Details | Zusätzliche Informationen zur Veranstaltung |
Das CustomDetails Feld ist ein Objekt, das beliebige Schlüssel-Wert-Paare enthält. Die benutzerdefinierten Details werden mit den standardmäßig verwendeten zusammengeführt.
Die Standardwerte für CustomDetails sind:
{ "firing": `{{ template "__text_alert_list" .Alerts.Firing }}`, "resolved": `{{ template "__text_alert_list" .Alerts.Resolved }}`, "num_firing": `{{ .Alerts.Firing | len }}`, "num_resolved": `{{ .Alerts.Resolved | len }}`, }
Bei doppelten Schlüsseln überschreiben die benutzerdefinierten Details die Standardangaben.