Kontaktpunkte konfigurieren - Amazon Managed Grafana
Mit Kontaktpunkten arbeitenKonfigurieren Sie Kontaktpunkt-Integrationen

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

Um einen Kontaktpunkt hinzuzufügen

  1. Wählen Sie im Menü auf der linken Seite Alerting.

  2. Wählen Sie Kontaktstellen.

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

  2. Wählen Sie Kontaktstellen, um eine Liste der vorhandenen Kontaktstellen zu sehen.

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

  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 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 eines WebhooksURL.

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-Dienst

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 }}`,
}

Bei doppelten Schlüsseln überschreiben die benutzerdefinierten Details die Standardschlüssel.