Benachrichtigung per Skriptaufruf
Bei dieser Benachrichtigungsoption wird eine beliebige Web-Adresse (via HTTP oder HTTPS) aufgerufen.
Damit wird ermöglicht, weitere Abläufe bei Ausfällen zu automatisieren. Zum Beispiel kann bei einem
Serverausfall die Domain der Webpräsenz auf die IP-Adresse eines Backupservers weitergeleitet werden.
Skript-Platzhalter
In der URL-Definition können bestimmte Platzhalter verwendet werden,
welche beim Aufruf mit den eigentlichen Werten ersetzt werden.
Folgende Platzhalter stehen zur Verfügung:
| Platzhalter | Beispiel | Beschreibung |
| {SENSOR_ID} | 12345 | ID des Überwachungsauftrags. |
| {CHECK_ID} | 12345 | ID des Checks, nach welchem die Ausfall- bzw. die Up-Meldung initiiert wird. |
| {SUCCESSFUL_FLAG} | FALSE | Check-Status (TRUE oder FALSE). Wenn TRUE, dann ist der Check erfolgreich. |
| {VERIFICATION_HASH} | f47215350f02d967b51227ad1cd2beb1 | MD5-Hash, welcher für die Validierung des Skriptaufrufs verwendet wird und aus folgenden Werten besteht: MD5({SENSOR_ID}{CHECK_ID}{SECRET_KEY}). Als {SECRET_KEY} ist der Geheimschlüssel, welcher beim Anlegen des Empfängers definiert wird, gemeint. |
Weitere Daten, wie z.B. die Details zu dem Überwachungsauftrag oder dem
Check, können im Skript-Code mit den o.g. Werten über die
API-Schnittstelle ermittelt werden.
Skriptantwort bei erfolgreicher Ausführung
Bei einem erfolgreichen Aufruf muss das Skript den '200 OK' HTTP-Response-Code senden.
Außerdem darf in der Ausgabe das Schlüsselwort 'ERROR' nicht erscheinen. Ansonsten wird
die Benachrichtigung per Skriptaufruf als 'Fehlgeschlagen' in unserem System registriert.
Beispiel der Skript-URL
https://example.com/my_script.php?sensor={SENSOR_ID}&check={CHECK_ID}&successful={SUCCESSFUL_FLAG}&verification={VERIFICATION_HASH}
Hinweis: Bitte platzieren Sie die Skript-Datei nicht auf dem selben Server, welcher überwacht
wird. Wenn der Server ausfällt, kann auch die Skript-Datei nicht aufgerufen werden. Um sicher
zu gehen, empfehlen wir das Skript nicht nur auf einem anderen Server, sondern auch in einem anderen
Rechenzentrum zu installieren.