Guía cron

Monitoriza un cron job de Linux con Verifagent

Cron es el calendario de servidor más común. Añade una llamada a Verifagent después del comando del job para que el silencio signifique que el job no se ejecutó o falló antes del ping.

Antes de empezar

Crea un monitor con la frecuencia real de tu workflow y copia su URL desde el panel. Su token es secreto: no lo publiques.

Módulo a usar : crontab + curl. Colócalo después de la última acción útil en la ruta de éxito.

Configuración

Copia la URL del monitor

Crea un monitor cuyo periodo esperado coincida con el calendario crontab (por ejemplo cada día a las 03:15 → periodo de 24 h). Copia la URL de ping desde el panel.

https://verifagent.com/api/ping/your-ping-token

Encadena el comando real con &&

Edita crontab con crontab -e. Pon primero el comando de negocio, luego && curl para que el ping solo se ejecute si el comando termina con código 0. Un ping al inicio mentiría sobre el éxito.

# Cada día a las 03:15 — sustituye la ruta del script y la URL
15 3 * * * /usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Usa PATH absoluto y ruta completa de curl si hace falta

Cron arranca con un entorno mínimo. Prefiere rutas absolutas para binarios y scripts. Si curl no está en PATH, llama explícitamente a /usr/bin/curl.

# Trampa de entorno mínimo: define PATH o usa rutas absolutas
PATH=/usr/local/bin:/usr/bin:/bin
15 3 * * * /usr/local/bin/backup.sh && /usr/bin/curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Prueba fuera de cron primero

Ejecuta el mismo comando encadenado en tu shell una vez. Deberías ver HTTP 200 y {"ok":true}. Luego espera al siguiente tick de cron o fuerza una ejecución.

/usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Siempre haz ping después del éxito (&&), nunca antes. Ajusta el periodo esperado al intervalo crontab y el margen ligeramente por encima del peor tiempo de ejecución más desfase de reloj (a menudo 5–15 minutos).

Rutas disponibles

La URL base basta para un heartbeat. Las variantes enriquecen el historial si tu plataforma tiene varias ramas.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Verificar

Tras una ejecución encadenada correcta, abre el monitor: el estado pasa a Up. Rompe temporalmente el comando (false && curl …) y confirma que no llega ningún ping nuevo hasta que lo arregles.

Respuesta esperada: 200 {"ok":true}. El monitor pasa de Pending a Up.