Was sind Scheduled Tasks?
Mit Scheduled Tasks (auch als Überwachung von Cron-Jobs oder Heartbeat-Monitoring bekannt) überwachst du Hintergrund-Jobs, Cron-Jobs und alle anderen wiederkehrenden Prozesse. UptimeEye arbeitet nach dem Prinzip des Dead Man's Switch: Der Job deines Tasks sendet in regelmäßigen Abständen einen Heartbeat an UptimeEye. Bleibt ein Heartbeat aus, bekommst du von UptimeEye einen Alert.
Task-Typen
UptimeEye unterstützt zwei Typen von Scheduled Tasks:
- Einfacher Task – Leg ein festes Intervall fest (z. B. alle 5 Minuten, alle 2 Stunden, jeden Tag). Am besten für Tasks, die in regelmäßigen Abständen laufen.
- Cron-Task – Nutze eine Cron-Expression (z. B.
0 9 * * 1-5) mit Zeitzone. Am besten für Tasks mit komplexen Zeitplänen.
Scheduled Task erstellen
So erstellst du einen neuen Scheduled Task:
- Öffne Scheduled Tasks in der Seitenleiste
- Klick auf „Neuer Scheduled Task“
- Gib einen Namen für deinen Task ein
- Wähl einen Benachrichtigungskanal, der die Alerts bekommt
- Wähl den Task-Typ (Einfach oder Cron)
- Leg den Zeitplan fest (Intervall oder Cron-Expression mit Zeitzone)
- Leg optional eine Karenzzeit fest (wie viele Minuten gewartet wird, bevor der Task als offline gilt)
- Klick auf „Task erstellen“, um zu speichern
Heartbeat-API (Integrations-Endpoints)
Nach dem Erstellen eines Scheduled Tasks bekommst du eine eindeutige Task-ID. Mit ihr sendet deine Anwendung Heartbeats, per einfachem HTTP-Request. Alle Endpoints akzeptieren die Methoden GET, POST und HEAD.
| Endpoint | Beschreibung |
|---|---|
| /v1/beat/{taskId} | Erfolgreichen Lauf melden (Standard-Heartbeat) |
| /v1/beat/{taskId}/success | Erfolg ausdrücklich melden |
| /v1/beat/{taskId}/fail | Fehler melden (löst sofort einen Alert aus) |
| /v1/beat/{taskId}/start | Melden, dass der Task gestartet ist |
Beispiel mit cURL:
# Send a beat after your cron job completes
curl -X GET https://api.uptimeeye.com/v1/beat/YOUR_TASK_ID
# Report failure if something goes wrong
curl -X POST https://api.uptimeeye.com/v1/beat/YOUR_TASK_ID/failKarenzzeit
Die Karenzzeit legt fest, wie viele Minuten UptimeEye wartet, wenn ein Heartbeat ausbleibt, bevor der Task als offline markiert und ein Alert gesendet wird. Das hilft bei Tasks, die gelegentlich länger brauchen als erwartet. Mit 0 kommt der Alert sofort.