Update Juli 2020 : Alarme in SIGNL4 schließen, wenn das Problem behoben ist

Jul 8, 2020 | Allgemein

Unser Juli-Update bringt neue Funktionen für die E-Mail- und WebHook-APIs. Sie können jetzt Alerts in SIGNL4 schließen, wenn das Problem in Ihrem Backend-System gelöst wurde.

Anwendungsbeispiel

Ein typischer Anwendungsfall ist das IT-Monitoring und die automatische Wiederherstellung. Stellen Sie sich vor, Sie erhalten mitten in der Nacht einen Alarm wegen eines IT-Problems. Ein Dienst ist ausgefallen. Sie haben jedoch einen automatischen Wiederherstellungs-Mechanismus konfiguriert und der Server wird automatisch neu gestartet. Nach einer Weile erkennt das Monitoring-Tool, dass das Problem gelöst ist. Sie können diese Informationen nun einfach und automatisch per E-Mail oder Webhook an SIGNL4 weiterleiten, um den Alert in der App zu schließen. Wenn Sie sich also die SIGNL4-App ansehen, sehen Sie, dass das Problem bereits durch das Backend-System gelöst wurde und Sie können Ihren Schlaf fortsetzen.

Wie funktioniert es?

Der neue X-S4-Status Parameter

So lösen Sie einen neuen Alarm per Webhook aus:

 

{
    „Subject“: „Server Down“,
    „Body“: „Server A2 is down.“,
    „X-S4-ExternalID“: „1234“,
    „X-S4-Status“: „new“
}

 

Und so schließen Sie den Alarm wieder.

 

{
    „X-S4-ExternalID“: „1234“,
    „X-S4-Status“: „resolved“
}

 

Bitte beachten Sie, dass der Parameter „X-S4-ExternalID“ derselbe sein muss wie bei der Auslösung des initialen Alarms. Der Parameter „X-S4-Status“ muss „resolved“ sein, damit der Alarm geschlossen werden kann.

Wenn der Parameter „X-S4-Status“ vorhanden ist und weder „new“ noch „resolved“ ist, wird das Ereignis verworfen. Dies ist nützlich, wenn Sie Updates ignorieren möchten.

Und es funktioniert auch per E-Mail:

 

E-Mail Body, um einen neuen Alarm zu öffnen:
Subject: Server Down
Body: Server A2 is down.
X-S4-ExternalID: 1234
X-S4-Status: new

 

E-Mail Body, um den Alarm wieder zu schließen:
Subject: Server Down
Body: Server A2 is down.
X-S4-ExternalID: 1234
X-S4-Status: resolved

Benutzerdefinierte Parameter

Manchmal sind die Backend-Systeme begrenzt und erlauben es nicht, den Alarm-Text zu ändern. In diesem Fall können Sie festlegen, wo Sie die „Externe ID“ und den „Status“ als Teil Ihrer Webhook-URL finden.

In diesem Fall ist es nicht notwendig, den Code in Ihrem Backend-System zu ändern. Sie müssen nur die Webhook-URL anpassen.

 

Für die Webhook-URL sieht dies wie folgt aus:

https://connect.signl4.com/webhook/<team-secret>?ExtIDParam=Trigger_Id&ExtStatusParam=Trigger_Status&ResolvedStatus=RESOLVED

 

Wie Sie sehen, gibt es einige zusätzliche Parameter:

ExtIDParam: Der Name einer eindeutigen ID Ihres Alarms.

ExtStatusParam: Der Name des Status-Parameters.

ResolvedStatus: Der Wert, der angibt, dass ein Alarm geschlossen wurde.

NewStatus: Optionaler Wert, für den ein neuer Alert geöffnet werden soll. Wenn dieser gesetzt ist und der Wert von ExtStatusParam weder der in NewStatus noch der in ResolvedStatus angegebene ist, wird das Ereignis verworfen. Dies ist nützlich, wenn es Updates gibt, die Sie ignorieren möchten.