Datadog Alerts

Du kannst dein SIGNL4-Team über neue Alerts in Datadog benachrichtigen. Um dies zu tun, musst du die folgenden Einstellungen vornehmen.

1. Gehe in Datadog zu Integrations und erstelle einen neue Webhook-Integration.

2. Navigiere zur Kachel Webhooks Integration.

3. Gehen Sie auf der Registerkarte „Configuration“ zu „Webhooks“ und klicke auf „New“.

4. Gebe unter „New Webhook“ einen aussagekräftigen Namen („Name“) ein und verwende diese SIGNL4-Webhook-URL mit Deinem Team-Geheimnis, zum Beispiel:

https://connect.signl4.com/webhook/[team-secret]?ExtIDParam=alertId&ExtStatusParam=alertTransition&ResolvedStatus=Recovered

Ersetze [team-secret] mit deinem SIGNL4 Team-Geheimnis.

5. Kopiere den folgenden JSON-String in die „Payload“ Text-Box:

{
"title": "$EVENT_TITLE",
"message": "$TEXT_ONLY_MSG",
"link": "$LINK",
"priority": "$ALERT_PRIORITY",
"host": "$HOSTNAME",
"alertScope": "$ALERT_SCOPE",
"alertStatus": "$ALERT_STATUS",
"alertId": "$ALERT_ID",
"alertTransition": "$ALERT_TRANSITION",
"X-S4-SourceSystem": "Datadog",
"date": "$DATE",
"org": {
"id": "$ORG_ID",
"name": "$ORG_NAME"
},
"id": "$ID"
}

Du kannst die Parameter an Ihre Bedürfnisse anpassen, aber bitte lasse alertId, alertTransition und X-S4-SourceSystem unverändert.

6. Klicke „Save“, um den Webhook anzulegen.

Das war’s. Jetzt kannst Du Deinen Webhook als Benachrichtigungs-Kanal in deinem Monitor verwenden. Du kannst hier @webhook-SIGNL4 wählen, wenn SIGNL4 der Name Deines Webhooks ist. Wenn die Bedingungen des Monitors zutreffen, wird dein Team einen neuen SIGNL4-Alarm erhalten.

Datadog Incidents

Du kannst dein SIGNL4-Team über neue Incidents in Datadog benachrichtigen. Um dies zu tun, musst du die folgenden Einstellungen vornehmen.

1. Gehe in Datadog zu Integrations und erstelle einen neue Webhook-Integration.

2. Navigiere zur Kachel Webhooks Integration.

3. Gehen Sie auf der Registerkarte „Configuration“ zu „Webhooks“ und klicke auf „New“.

4. Gebe unter „New Webhook“ einen aussagekräftigen Namen („Name“) ein und verwende diese SIGNL4-Webhook-URL mit Deinem Team-Geheimnis, zum Beispiel:

https://connect.signl4.com/webhook/[team-secret]?ExtIDParam=s4ExternalId&ExtStatusParam=incidentStatus&ResolvedStatus=resolved

Ersetze [team-secret] mit deinem SIGNL4 Team-Geheimnis.

5. Kopiere den folgenden JSON-String in die „Payload“ Text-Box:

{
	"title": "$EVENT_TITLE",
	"message": "$TEXT_ONLY_MSG",
	"link": "$LINK",
	"priority": "$ALERT_PRIORITY",
	"host": "$HOSTNAME",
	"alertScope": "$ALERT_SCOPE",
	"alertStatus": "$ALERT_STATUS",
	"alertId": "$ALERT_ID",
	"incidentPublicId": "$INCIDENT_PUBLIC_ID",
	"incidentStatus": "$INCIDENT_STATUS",
	"alertTransition": "$ALERT_TRANSITION",
	"s4ExternalId": "DATADOG-INCIDENT-$INCIDENT_PUBLIC_ID",
	"X-S4-SourceSystem": "Datadog",
	"date": "$DATE",
	"org": {
		"id": "$ORG_ID",
		"name": "$ORG_NAME"
	},
	"id": "$ID"
}

Du kannst die Parameter an Ihre Bedürfnisse anpassen, aber bitte lasse incidentStatus, s4ExternalId and X-S4-SourceSystem unverändert.

6. Klicke „Save“, um den Webhook anzulegen.

Incidents Rule

Nun kannst du in Datadog unter Monitors -> Settings (Incidents) Rules eine Regel erstellen. Darin gibst du die Kriterien an, d.h. den Schweregrad, den Service, etc. Für „Other attributes“ empfehlen wir „state:active“, was einen neuen Alarm auslöst und „state:resolved“, was den Alert schließt. Unter „Notifications“ wählst du deinen SIGNL4-Webhook für den Vorfall aus, den du oben erstellt hast, und das war’s.

Wenn du jetzt einen neuen Incident erstellst , erhält dein SIGNL4-Team eine Benachrichtigung. Wenn du den Alarm in der SIGNL4-App bestätigst / schließt, wird der Status des Incidents auf Stable / Resolved gesetzt.

Wenn du den Status des Incidents in Datadog auf „Resolved“ setzt, wird der Alarm in SIGNL4 ebenfalls geschlossen.

Status Updates für Datadog Incidents

Bei Datadog-Incidents kannst du den Status auf Stable / Resolved direkt von deiner SIGNL4-App aus aktualisieren, indem du den entsprechenden Alarm bestätigst/ schließt.

Um diesen Rückkanal zu konfigurieren, gehst du in dein SIGNL4 Web-Portal und dann auf Teams -> Apps. Suche nach der Datadog Connector App und klicke dort auf „Erstellen“. Weitere Informationen findest du direkt in den Einstellungen der App.

Du musst folgendes konfigurieren.

Datadog URL: Die API URL deiner Datadog Instanz, zum Beispiel https://app.datadoghq.com/ oder https://app.datadoghq.eu/.

Datadog API Key: Dein Datadog API Key. Du findest oder erstellst diesen in Datadog unter deinem Account, Organization Settings -> API Keys.

Datadog Application Key: Dein Datadog Application Key. Du findest oder erstellst diesen in Datadog unter deinem Account, Organization Settings -> Application Keys.

Alternative Methode (E-Mail)

E-Mail: In jedem Monitor befindet sich ein Abschnitt, der eine Nachricht für eine Warnung enthält. Hier kannst du die SIGNL4-E-Mail-Adresse hinzufügen.

Alarmfarbe ändern, Titel + Text überschreiben

Dazu musst du entsprechend „Dienste und Systeme“-Kategorien erstellen, die auf bestimmte Schlüsselwörter ansprechen. Gehe dazu in der mobilen App in die Einstellungen und wähle „Dienste und Systeme“. Erstelle eine neue Kategorie oder bearbeite einfach eine bestehende.

Eine Kategorie wird immer angewendet, wenn einzelne Schlüsselwörter oder Kombinationen von Schlüsselwörtern im auslösenden Event gefunden werden.