Centro de ayuda / Comprobaciones

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 3 para 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.