Geplante Aufgaben (Heartbeats)
Ping-URLs für Backups und geplante Aufgaben, mit Beispielen für cron, Shell, Rails, Laravel, Node und Python.
So funktionieren Heartbeats
In Pingerer heißen sie Geplante Aufgaben (Entwickler nennen sie oft Heartbeats). Öffnen Sie Geplante Aufgaben und wählen Sie Aufgabe überwachen, um eine hinzuzufügen.
Ein Heartbeat überwacht etwas, das nach Zeitplan passieren soll. Statt dass Pingerer Ihre Aufgabe prüft, meldet sich Ihre Aufgabe bei Pingerer: Wenn sie fertig ist, ruft sie die Ping-URL des Heartbeats auf. Kommt ein Ping nicht bis zur Frist an, ist der Heartbeat ausgefallen und Sie werden benachrichtigt. Der nächste Ping hebt das wieder auf.
- Intervall: wie oft die Aufgabe läuft (von alle 5 Minuten bis wöchentlich).
- Kulanz: wie spät ein Ping sein darf, bevor er als verpasst gilt, für Aufgaben, die eine Weile dauern.
- Die Frist ist der letzte Ping (oder der Zeitpunkt, zu dem Sie den Heartbeat angelegt haben) plus Intervall plus Kulanz.
Ping-URLs
Jeder Heartbeat hat eine eigene URL mit einem geheimen Token, angezeigt auf der Seite „Geplante Aufgaben“ (klicken Sie auf die Adresse oder ihr Kopiersymbol, um sie zu kopieren):
https://pingerer.com/hb/YOUR-TOKEN # Erfolg
https://pingerer.com/hb/YOUR-TOKEN/fail # die Aufgabe ist fehlgeschlagen: sofort benachrichtigen
GET, POST und HEAD funktionieren alle (senden Sie /fail als GET oder POST). Link-Vorschauen, etwa von Slack, wenn Sie die URL einfügen, werden nicht mitgezählt. Jeder, der die URL kennt, kann sie anpingen, behandeln Sie sie also wie ein Passwort. Pro Heartbeat sind 30 Pings pro Minute möglich.
Wenn Pingerer selbst nicht erreichbar ist oder neu startet, bekommt Ihre Aufgabe trotzdem sofort ein „OK“. Der Ping wird aufbewahrt (bis zu einen Tag) und zum Zeitpunkt seines Versands gezählt, sobald wir wieder da sind. Ein Heartbeat mit noch wartenden Pings gilt nicht als verpasst, Sie bekommen also keinen Fehlalarm.
cron
# jede Nacht um 3 Uhr; nur pingen, wenn die Aufgabe erfolgreich war
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 https://pingerer.com/hb/YOUR-TOKEN > /dev/null
Shell-Skript
#!/bin/sh
if /usr/local/bin/backup.sh; then
curl -fsS -m 10 --retry 3 https://pingerer.com/hb/YOUR-TOKEN
else
curl -fsS -m 10 --retry 3 https://pingerer.com/hb/YOUR-TOKEN/fail
fi
Ruby on Rails
# app/jobs/nightly_backup_job.rb
require "net/http"
class NightlyBackupJob < ApplicationJob
PING = "https://pingerer.com/hb/YOUR-TOKEN"
def perform
Backup.run!
Net::HTTP.get(URI(PING))
rescue => error
Net::HTTP.get(URI("#{PING}/fail"))
raise
end
end
Laravel
// routes/console.php (oder app/Console/Kernel.php)
Schedule::command('backup:run')
->daily()
->pingOnSuccess('https://pingerer.com/hb/YOUR-TOKEN')
->pingOnFailure('https://pingerer.com/hb/YOUR-TOKEN/fail');
Node.js
const PING = "https://pingerer.com/hb/YOUR-TOKEN";
async function main() {
try {
await runBackup();
await fetch(PING);
} catch (error) {
await fetch(`${PING}/fail`);
throw error;
}
}
main();
Python
import urllib.request
PING = "https://pingerer.com/hb/YOUR-TOKEN"
try:
run_backup()
urllib.request.urlopen(PING, timeout=10)
except Exception:
urllib.request.urlopen(PING + "/fail", timeout=10)
raise
Über die Kommandozeile
pingerer heartbeats ping "Nightly backup"
pingerer heartbeats ping YOUR-TOKEN --fail # per Token, ohne Anmeldung
Tipps
- Pingen Sie am Ende der Aufgabe, wenn sie wirklich erfolgreich war, nicht am Anfang.
- Verwenden Sie
curl -m 10 --retry 3, damit ein langsames Netz Ihre Aufgabe nicht aufhält und ein kurzer Aussetzer keinen Fehlalarm auslöst. - Stellen Sie die Kulanz etwas länger ein als die längste normale Laufzeit der Aufgabe.
- Wartungsfenster pausieren keine Heartbeats; pausieren Sie den Heartbeat selbst, wenn eine Aufgabe absichtlich nicht läuft.
Kommen Sie nicht weiter? Schreiben Sie uns, ein Mensch antwortet Ihnen.