Aide et guidesHeartbeat (cron monitoring) › Créer moniteur heartbeat

Créer moniteur heartbeat

3 min de lecture · Heartbeat (cron monitoring)

Objectif : créer un moniteur heartbeat et obtenir l'URL de ping à insérer dans le cron job.

Étape 1 : ouvrez la création du moniteur

  1. Dans le tableau de bord ePulz.io, cliquez sur + Nouveau moniteur
  2. Choisissez le type Heartbeat (cron)

Étape 2 : nommez le moniteur

Utilisez un nom descriptif qui vous rappellera ce que vous surveillez. Exemples :

  • Sauvegarde DB nocturne
  • Sync CRM (horaire)
  • Facturation hebdomadaire
  • Nettoyage des anciennes sessions

Étape 3 : définissez l'intervalle

Intervalle en minutes, à quelle fréquence le heartbeat doit arriver :

  • 5 = toutes les 5 minutes (jobs courts, healthcheck)
  • 60 = chaque heure
  • 1440 = quotidien (24 x 60)
  • 10080 = hebdomadaire (7 x 24 x 60)

Étape 4 : définissez la période de grace

Le grace est la tolérance après l'heure prévue. Les crons peuvent avoir un léger décalage (NTP, réseau, ou la tâche dure plus longtemps que d'habitude).

Recommandations :

  • Cron court (5-60 min) : grace 2-10 minutes
  • Cron horaire : grace 10-15 minutes
  • Cron quotidien : grace 30-60 minutes
  • Cron hebdomadaire : grace 6+ heures

Étape 5 : notifications

Activez quels canaux doivent recevoir l'alerte en cas de heartbeat manqué :

  • Email
  • Telegram (nécessite un bot connecté)
  • Webhook (Slack, Discord, endpoint personnalisé)

Étape 6 : enregistrez et obtenez l'URL

Cliquez sur Créer le moniteur. Le détail du moniteur s'affiche avec votre URL heartbeat unique :

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

Vous ajoutez cette URL à votre script cron ou tâche. ePulz.io attendra désormais un ping toutes les [intervalle] minutes.

Astuce : L'URL est secrète - qui la connaît peut prétendre que votre cron tourne. Ne la partagez pas, ne la mettez pas dans des dépôts publics.

État du moniteur

Après création, le moniteur est en état Pending (attend le premier heartbeat). Après le premier ping réussi, il passe à OK. Si le heartbeat n'arrive pas dans la fenêtre attendue, il passe à Down et envoie une alerte.

Étape suivante :

Ajoutez l'URL heartbeat à votre cron job (exemples bash, Python, Node.js).

Ajout au cron job