Hilfe-Center / Prüfungen

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.