Ayuda y guíasHeartbeat (cron monitoring) › Crear monitor heartbeat

Crear monitor heartbeat

3 min de lectura · Heartbeat (cron monitoring)

Objetivo: Crear un monitor heartbeat y obtener la URL de ping para incluir en un cron job.

Paso 1: Abra la creación del monitor

  1. En el panel de ePulz.io haga clic en + Nuevo monitor
  2. Elija el tipo Heartbeat (cron)

Paso 2: Asigne un nombre al monitor

Use un nombre descriptivo que le recuerde qué está monitorizando. Ejemplos:

  • Backup nocturno BD
  • Sincronización CRM (cada hora)
  • Facturación semanal
  • Limpieza de sesiones antiguas

Paso 3: Configure el intervalo

Intervalo en minutos, con qué frecuencia debe llegar el heartbeat:

  • 5 = cada 5 minutos (jobs cortos, healthcheck)
  • 60 = cada hora
  • 1440 = diariamente (24 × 60)
  • 10080 = semanalmente (7 × 24 × 60)

Paso 4: Configure el período de gracia

La gracia es la tolerancia tras el tiempo esperado. Los cron pueden tener un ligero desfase (NTP, red, o la tarea dura más de lo habitual).

Recomendaciones:

  • Cron corto (5-60 min): gracia 2-10 minutos
  • Cron cada hora: gracia 10-15 minutos
  • Cron diario: gracia 30-60 minutos
  • Cron semanal: gracia 6+ horas

Paso 5: Notificaciones

Active qué canales deben recibir la alerta al perderse un heartbeat:

  • 📧 Correo electrónico
  • 📨 Telegram (requiere bot conectado)
  • 🔌 Webhook (Slack, Discord, endpoint propio)

Paso 6: Guarde y obtenga la URL

Haga clic en Crear monitor. Se muestra el detalle del monitor con su URL heartbeat única:

https://epulz.io/heartbeat/Qs78OPNIIsCF_-Vj

Esta URL la añade a su script cron o tarea. ePulz.io esperará desde ahora un ping cada [intervalo] minutos.

Consejo: La URL es secreta: quien la conozca puede fingir que su cron se está ejecutando. No la comparta ni la suba a repositorios públicos.

Estado del monitor

Tras la creación, el monitor está en estado Pending (espera el primer heartbeat). Tras el primer ping exitoso cambia a OK. Si el heartbeat no llega en la ventana esperada, cambia a Down y envía alerta.

Siguiente paso:

Añada la URL heartbeat a su cron job (ejemplos en bash, Python, Node.js).

Añadir al cron job →