Monitorización cron

Los monitores cron asignan a cada tarea programada (una copia de seguridad, un proceso por lotes o un script recurrente) una URL única a la que hacer ping, y te avisan cuando un ping llega tarde o no llega. La tarea se marca como degradada cuando supera su periodo y como caída cuando además supera el margen.

Igual que con otros monitores, cuando una tarea cron falla puedes colaborar con tu equipo para resolver la incidencia y, si quieres, actualizar tu página de estado.

Así se ve tu lista de monitores cron:

Lista de monitores cron

¿Qué hace un monitor cron?

  • Comprueba que tus tareas cron se ejecutan a tiempo (mediante los pings de tus tareas).
  • Recibe alertas si una tarea se retrasa o no termina.
  • Integra Slack, correo, SMS, llamadas telefónicas y más para recibir alertas.

Al hacer clic en un monitor cron, verás más detalles:

Detalles del monitor cron

¿Cómo añado un monitor cron?

Ve a tu proyecto → Monitores → Añadir monitor, elige Cron/Heartbeat, apunta tu tarea a la URL generada y define su periodo y su margen.

Añadir monitor

Tipo de monitor

Selecciona Cron/Heartbeat como tipo de monitor.

Tipo de monitor cron

Se generará una URL única para ti. Tu tarea cron debe enviar una petición HTTP (HEAD, GET o POST) a esa URL cada vez que se ejecute.

El monitor se considera correcto si

Un monitor cron tiene éxito cuando tu tarea hace ping a la URL generada dentro del plazo previsto. Puedes configurar:

  • Periodo: con qué frecuencia debe ejecutarse la tarea (por ejemplo, cada 15 minutos).
  • Margen: tiempo adicional que se permite antes de considerar la tarea caída.

Si se alcanza el periodo y la tarea no hace ping, el monitor se marcará como degradado.

Si se alcanza el margen y la tarea no hace ping, el monitor se marcará como caído.

Puedes configurar alertas para recibir avisos cuando una tarea falla, se degrada o se recupera.

Señalar un fallo

Envía una petición a la URL del monitor añadiendo /fail al final para marcar la tarea como fallida, aunque se haya ejecutado y haya hecho ping al monitor.

Es útil cuando tu script encuentra un error y quieres que Instatus registre la tarea como fallida de inmediato.

  • Ping de éxito: https://cron.instatus.com/your-unique-url
  • Ping de fallo: https://cron.instatus.com/your-unique-url/fail

Cuando se recibe una señal de fallo, el monitor se marca como caído y las alertas se envían de inmediato según tus ajustes de alertas.

Medir el tiempo de ejecución de una tarea

Envía dos peticiones, /start cuando empiece tu tarea y el ping de éxito o de fallo cuando termine, e Instatus registrará el tiempo entre ambas como el tiempo de ejecución de la tarea:

  1. Señal de inicio: envía una petición a /start cuando empiece tu tarea
  2. Señal de éxito o fallo: envía una petición a la URL base cuando tu tarea termine o falle
  • Ping de inicio: https://cron.instatus.com/your-unique-url/start
  • Ping de éxito: https://cron.instatus.com/your-unique-url
  • Ping de fallo: https://cron.instatus.com/your-unique-url/fail

El tiempo entre la señal de inicio y la de éxito se registra como el tiempo de ejecución de la tarea. Así puedes seguir el rendimiento e identificar las tareas que tardan más de lo previsto.

Si tu tarea falla después de enviar la señal de inicio, envía una señal de fallo en lugar de la de éxito para marcarla como fallida y registrar igualmente el tiempo de ejecución.

¡Enhorabuena, has añadido tu primer monitor cron!