Skip to Content
Uptimeify Docs

Heartbeat-Überwachung (Cron)

Heartbeat Monitoring (auch bekannt als Cron Monitoring) funktioniert andersherum: Anstatt dass wir Ihre Server prüfen, benachrichtigt Ihr Server (oder Skript) uns, dass er lebt.

Dies ist perfekt für die Überwachung von:

  • Täglichen Backups: Stellen Sie sicher, dass Ihre Datenbank-Backups tatsächlich gelaufen sind.
  • Hintergrund-Jobs: Überwachen Sie Worker, Import-Skripte oder periodische Aufgaben.
  • Intranet-Geräten: Überwachen Sie Geräte hinter einer Firewall, die ausgehende Anfragen senden können.

Funktionsweise

  1. Sie erstellen einen Heartbeat Monitor im Dashboard.
  2. Wir geben Ihnen eine eindeutige Heartbeat URL.
  3. Sie konfigurieren Ihr Skript (Cronjob, Worker), diese URL aufzurufen, wenn es erfolgreich beendet wurde.
  4. Wir erwarten einen Ping innerhalb Ihres konfigurierten Intervalls (plus einer Grace Period).
  5. Wenn wir keinen Ping rechtzeitig erhalten, senden wir einen Alarm: "Heartbeat missing", mit erwartetem Intervall, Grace Period, Zeitpunkt des letzten Pings und Verzug, z. B. Heartbeat missing: expected every 30 min + 5 min grace, last ping 2026-10-28T10:00:00.000Z, overdue by 12 min.
  6. Ist ein Vorfall offen, stößt der nächste Ping die Erholungsprüfung sofort an, statt auf den nächsten planmäßigen Lauf zu warten.

Konfiguration

Erwartetes Intervall (Expected Interval)

Wie oft erwarten Sie den Ping?

  • Beispiel: Für ein tägliches Backup setzen Sie dies auf 24 Stunden (1440 Minuten).
  • Beispiel: Für einen minütlichen Worker setzen Sie dies auf 1 Minute.
  • Beispiel: Für einen monatlichen Report-Job setzen Sie dies auf 30 Tage (43200 Minuten).
  • Erlaubt sind 1 bis 43200 Minuten (30 Tage). Anders als aktiv getaktete Monitore, die wir abfragen und deshalb bei 24 Stunden deckeln, wartet ein Heartbeat nur, ein langes Intervall kostet dort nichts.

Grace Period (Toleranzzeit)

Wie viel Verzögerung ist akzeptabel?

  • Beispiel: Wenn Ihr Backup normalerweise 10 Minuten dauert, aber manchmal 30, setzen Sie die Grace Period auf 30 Minuten.
  • Wir alarmieren nur, wenn Letzter Ping + Intervall + Grace Period < JETZT.

Erwarteter Zustand

Standardmäßig alarmiert ein Heartbeat, wenn die Pings ausbleiben. Das lässt sich umdrehen: auf der Seite zum Anlegen und Bearbeiten unter Alarm auslösen, wenn … die Option … ein Heartbeat ankommt wählen. Das passt für Jobs, die sich nur im Fehlerfall melden (z. B. ein Fehler-Handler).

  • Jeder Ping zählt dann als Fehlschlag und öffnet einen Vorfall.
  • Der Vorfall schließt sich, sobald über Intervall plus Grace Period kein Ping mehr ankommt.
  • In der API heißt das Feld expectedState: up (Standard, Alarm bei ausbleibenden Pings) oder down (Alarm, wenn ein Ping ankommt).

Anwendungsbeispiele

Linux Cronjob (Backup Script)

#!/bin/bash
# Backup ausführen ...
pg_dump dbname > backup.sql

# Wenn erfolgreich, Heartbeat pingen
if [ $? -eq 0 ]; then
  curl -m 10 --retry 3 https://ping.uptimeify.io/ping/YOUR_TOKEN
fi

PowerShell (Windows)

# Task ausführen...
Write-Output "Task running..."

# Heartbeat pingen
Invoke-RestMethod -Uri "https://ping.uptimeify.io/ping/YOUR_TOKEN"

Node.js Worker

await doImport();

# Ping
await fetch('https://ping.uptimeify.io/ping/YOUR_TOKEN');

Auf dieser Seite