Tareas programadas (heartbeats)
URL de ping para copias de seguridad y tareas programadas, con ejemplos para cron, shell, Rails, Laravel, Node y Python.
Cómo funcionan los heartbeats
En Pingerer se llaman Tareas programadas (los desarrolladores suelen llamarlas heartbeats o señales de vida). Abre Tareas programadas y elige Vigilar una tarea para agregar una.
Un heartbeat vigila algo que debería pasar según un horario. En lugar de que Pingerer compruebe tu tarea, es tu tarea la que avisa a Pingerer: cuando termina, abre la URL de ping del heartbeat. Si un ping no llega antes del plazo, el heartbeat pasa a caído y te avisamos. El siguiente ping lo resuelve.
- Periodo: cada cuánto se ejecuta la tarea (desde cada 5 minutos hasta una vez por semana).
- Margen: cuánto puede retrasarse un ping antes de contar como perdido, para las tareas que tardan un rato.
- El plazo es el último ping (o el momento en que creaste el heartbeat) más el periodo más el margen.
URL de ping
Cada heartbeat tiene su propia URL con un token secreto, que aparece en la página Tareas programadas (haz clic en la dirección, o en su icono de copiar, para copiarla):
https://pingerer.com/hb/YOUR-TOKEN # éxito
https://pingerer.com/hb/YOUR-TOKEN/fail # la tarea falló: avisar ya
Funcionan GET, POST y HEAD (envía /fail como GET o POST). Las vistas previas de enlaces, como la de Slack cuando pegas la URL, no cuentan. Cualquiera que tenga la URL puede hacer ping, así que trátala como una contraseña. El ping está limitado a 30 peticiones por minuto por heartbeat.
Si el propio Pingerer está caído o reiniciándose, tu tarea recibe un "OK" igualmente al instante. El ping se guarda (hasta un día) y se cuenta con la hora en que se envió cuando volvemos, y un heartbeat con pings pendientes no se da por perdido, así que no recibes una falsa alarma.
cron
# cada noche a las 3:00; hacer ping solo si la tarea salió bien
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 https://pingerer.com/hb/YOUR-TOKEN > /dev/null
Script de shell
#!/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 (o 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
Desde la CLI
pingerer heartbeats ping "Nightly backup"
pingerer heartbeats ping YOUR-TOKEN --fail # por token, sin iniciar sesión
Consejos
- Haz el ping al final de la tarea, cuando de verdad haya salido bien, no al principio.
- Usa
curl -m 10 --retry 3para que una red lenta no bloquee tu tarea y un corte breve no provoque una falsa alarma. - Pon un margen algo mayor que la ejecución normal más larga de la tarea.
- Las ventanas de mantenimiento no pausan los heartbeats; si una tarea está parada a propósito, pausa el propio heartbeat.
¿Sigues atascado? Escríbenos y te responderá una persona.