Kontaktpunkte konfigurieren

Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 10.x unterstützen.

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8

Definieren Sie anhand von Kontaktpunkten, wie Ihre Kontakte benachrichtigt werden, wenn eine Warnregel ausgelöst wird.

Anmerkung

Sie können Kontaktpunkte für von Grafana verwaltete Benachrichtigungen erstellen und bearbeiten. Kontaktstellen für von Datenquellen verwaltete Benachrichtigungen sind schreibgeschützt.

Mit Kontaktpunkten arbeiten

Die folgenden Verfahren zeigen, wie Sie eine Kontaktstelle hinzufügen, bearbeiten, löschen und testen.

So fügen Sie einen Kontaktpunkt hinzu

1. Wählen Sie im Menü auf der linken Seite die Option Alerts Management Portal IRM und dann Alerting aus.

2. Wählen Sie Kontaktstellen aus.

3. Wählen Sie im Drop-down-Menü „Alertmanager auswählen“ einen Alertmanager aus. Der Grafana Alertmanager ist standardmäßig ausgewählt.

4. Wählen Sie auf der Registerkarte Kontaktstellen die Option + Kontaktstelle hinzufügen.

5. Geben Sie einen Namen für die Kontaktstelle ein.

6. Wählen Sie unter Integration einen Typ aus und füllen Sie die Pflichtfelder auf der Grundlage dieses Typs aus. Wenn du dich beispielsweise für Slack entscheidest, gib die Slack-Kanäle und Benutzer ein, die kontaktiert werden sollen.

7. Falls für den von dir ausgewählten Kontaktpunkt verfügbar, wähle die gewünschten optionalen Einstellungen, um zusätzliche Einstellungen festzulegen.

8. 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.

9. Um eine weitere Kontaktpunktintegration hinzuzufügen, wählen Sie Kontaktpunktintegration hinzufügen aus und wiederholen Sie die Schritte für jeden benötigten Kontaktpunkttyp.

10. Speichern Sie Ihre Änderungen.

Um eine Kontaktstelle zu bearbeiten

1. Wählen Sie im Menü auf der linken Seite die Option Alerts Management Portal IRM und dann Alerting aus.

2. Wählen Sie Kontaktstellen aus, um eine Liste der vorhandenen Kontaktstellen aufzurufen.

3. Wählen Sie die Kontaktstelle aus, die Sie bearbeiten möchten, und wählen Sie dann Bearbeiten.

4. Aktualisieren Sie die Kontaktstelle und speichern Sie dann Ihre Änderungen.

Sie können Kontaktpunkte löschen, die aufgrund einer Benachrichtigungsrichtlinie nicht verwendet werden.

Um eine Kontaktstelle zu löschen

1. Wählen Sie im Menü auf der linken Seite die Option Alerts Management Portal IRM und dann Alerting aus.

2. Wählen Sie Kontaktstellen, um die Liste der vorhandenen Kontaktstellen zu öffnen.

3. Wählen Sie unter Kontaktstellen die Kontaktstelle aus, die Sie löschen möchten, und wählen Sie dann Mehr, Löschen aus.

4. Wählen Sie im Bestätigungsdialogfeld Ja, löschen aus.

Anmerkung

Wenn der Kontaktpunkt von einer Benachrichtigungsrichtlinie verwendet wird, müssen Sie die Benachrichtigungsrichtlinie löschen oder sie so bearbeiten, dass sie einen anderen Kontaktpunkt verwendet, bevor Sie den Kontaktpunkt löschen.

Nachdem Ihre Kontaktstelle erstellt wurde, können Sie eine Testbenachrichtigung senden, um zu überprüfen, ob sie richtig konfiguriert ist.

Um eine Testbenachrichtigung zu senden

1. Wählen Sie im Menü auf der linken Seite die Option Alerts Management Portal IRM und dann Alerting aus.

2. Wählen Sie Kontaktstellen, um die Liste der vorhandenen Kontaktstellen zu öffnen.

3. Wählen Sie unter Kontaktstellen die Kontaktstelle aus, die Sie testen möchten, und klicken Sie dann auf Bearbeiten. Bei Bedarf können Sie auch eine neue Kontaktstelle erstellen.

4. Wählen Sie Test, um den Dialog zum Testen der Kontaktstelle zu öffnen.

5. 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.

6. Wählen Sie Testbenachrichtigung senden, um die Warnung mit den angegebenen Kontaktpunkten zu testen.

Konfigurieren Sie Kontaktpunkt-Integrationen

Konfigurieren Sie Kontaktpunktintegrationen in Grafana, um Ihren bevorzugten Kommunikationskanal für den Empfang von Benachrichtigungen auszuwählen, wenn Ihre Alarmregeln ausgelöst werden. Jede Integration hat ihre eigenen Konfigurationsoptionen und ihren eigenen Einrichtungsprozess. In den meisten Fällen beinhaltet dies die Bereitstellung eines API-Schlüssels oder einer Webhook-URL.

Nach der Konfiguration können Sie Integrationen als Teil Ihrer Kontaktstellen verwenden, um Benachrichtigungen zu erhalten, wenn sich der Status Ihrer Warnung ändert. In diesem Abschnitt behandeln wir anhand PagerDuty eines Beispiels die grundlegenden Schritte zur Konfiguration einer Integration, sodass Sie sofort Benachrichtigungen in Echtzeit erhalten und den Überblick über Ihre Überwachungsdaten behalten können.

Liste der unterstützten Integrationen

In der folgenden Tabelle sind die von Grafana unterstützten Kontaktpunkttypen aufgeführt.

Name	Typ
Amazon SNS	sns
OpsGenie	opsgenie
Pager Duty	pagerduty
Slack	slack
VictorOps	victorops

Konfiguration PagerDuty für Warnmeldungen

Für die Einrichtung PagerDuty müssen Sie einen Integrationsschlüssel angeben. Geben Sie die folgenden Details an.

Einstellung	Beschreibung
Integrationsschlüssel	Integrationsschlüssel für PagerDuty
Schweregrad	Stufe für dynamische Benachrichtigungen. Der Standardwert ist critical.
Benutzerdefinierte Details	Zusätzliche Informationen zur Veranstaltung

Das CustomDetails Feld ist ein Objekt, das beliebige Schlüssel-Wert-Paare enthält. Die benutzerdefinierten Details werden mit den standardmäßig verwendeten zusammengeführt.

Die Standardwerte für CustomDetails sind:

{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}

Im Fall von doppelten Schlüsseln überschreiben die benutzerdefinierten Details die Standarddaten.