Guide cron

Surveiller un cron Linux avec Verifagent

Cron est le cas le plus courant côté serveur. Enchaînez un appel Verifagent après la commande métier : le silence signifie que le job n’a pas tourné ou a échoué avant le ping.

Avant de commencer

Créez un monitor avec la fréquence réelle de votre workflow, puis copiez son URL depuis le dashboard. Son token est secret : ne le publiez pas.

Module à utiliser : crontab + curl. Placez-le après la dernière action utile du chemin de succès.

Installation

Copiez l’URL du monitor

Créez un monitor dont la période attendue correspond au crontab (par ex. tous les jours à 03:15 → période 24 h). Copiez l’URL de ping depuis le dashboard.

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

Enchaînez la vraie commande avec &&

Éditez le crontab avec crontab -e. Placez d’abord la commande métier, puis && curl pour ne pinger que si le code de sortie est 0. Un ping en tête mentirait sur le succès.

# Tous les jours à 03:15 : remplacez le chemin du script et l’URL
15 3 * * * /usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

PATH absolu et chemin complet de curl si besoin

Cron démarre avec un environnement minimal. Préférez des chemins absolus pour binaires et scripts. Si curl n’est pas dans le PATH, appelez /usr/bin/curl.

# Piège d’environnement minimal : définissez PATH ou utilisez des chemins absolus
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"

Testez d’abord hors cron

Exécutez une fois la même chaîne dans votre shell. Vous devez voir HTTP 200 et {"ok":true}. Attendez ensuite le prochain tick cron ou forcez une exécution.

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

Pingez toujours après succès (&&), jamais avant. Réglez la période attendue sur l’intervalle crontab et la grâce un peu au-dessus du runtime pire cas plus le décalage d’horloge (souvent 5–15 minutes).

Routes disponibles

L’URL de base suffit pour un heartbeat. Les variantes enrichissent l’historique si votre plateforme gère plusieurs branches.

GET https://VOTRE_URL_DE_PING

POST https://VOTRE_URL_DE_PING/success

POST https://VOTRE_URL_DE_PING/fail?msg=Erreur

Vérification

Après une chaîne réussie, ouvrez le monitor : le statut passe à Up. Casquez temporairement la commande (false && curl …) et vérifiez qu’aucun nouveau ping n’arrive.

Réponse attendue : 200 {"ok":true}. Le monitor passe de Pending à Up.