Aide et guides ›
Heartbeat (cron monitoring)
› Qu'est-ce qu'un heartbeat
Qu'est-ce qu'un heartbeat
3 min de lecture · Heartbeat (cron monitoring)
En bref : le moniteur heartbeat vous avertit lorsqu'une tâche (typiquement une sauvegarde nocturne, une synchronisation quotidienne ou un autre cron job) cesse de tourner. Il fonctionne à l'inverse d'un moniteur d'uptime classique - c'est vous qui envoyez un "ping" vers ePulz.io, pas nous vers votre serveur.
Quand le heartbeat est utile
- Sauvegardes nocturnes de base de données - vous voulez savoir si la sauvegarde échoue la nuit
- Synchronisation avec un service externe - import depuis CRM, comptabilité, processeur de paiement
- Facturation régulière - génération de factures, envoi de rappels
- Tâches de nettoyage - suppression des anciennes sessions, fichiers temporaires, logs
- Rapports et statistiques - rapports hebdomadaires/mensuels
- Healthcheck des workers en arrière-plan - Celery, Sidekiq, BullMQ
Comment cela fonctionne
- Dans ePulz.io, vous créez un moniteur heartbeat avec un intervalle attendu (par ex. toutes les heures, chaque nuit à 3:00, etc.)
- Vous recevez une URL heartbeat unique - elle ressemble à
https://epulz.io/heartbeat/abc123xyz - Vous ajoutez cette URL à la fin de votre script cron / tâche
- Lorsque la tâche se termine avec succès, elle "pingue" cette URL
- Si le ping n'arrive pas à temps (+ période de grace), ePulz.io vous avertit
Exemple pratique
Imaginons une sauvegarde nocturne de base de données qui tourne tous les jours à 3:00 du matin et dure environ 5 minutes :
- Vous créez un moniteur heartbeat nommé "Sauvegarde DB nocturne", intervalle 1440 minutes (24 heures), grace 15 minutes
- Dans le script de sauvegarde, vous ajoutez : après la sauvegarde réussie, appelez l'URL heartbeat
- Chaque jour après 3:05, ePulz.io attend un ping. S'il n'arrive pas avant 3:15 (intervalle + grace), il vous envoie une alerte
Principe clé :
Vous n'appelez l'URL heartbeat qu'après la réussite de la tâche. Si le script échoue, le ping ne passe pas, ePulz.io en est informé et vous avertit. Aucun ping = panne.
Intervalle vs Grace
- Intervalle - à quelle fréquence le heartbeat devrait arriver (par ex. toutes les heures = 60 minutes)
- Grace - tolérance, combien de temps attendre après l'heure prévue avant de déclencher l'alerte
Valeurs pratiques :
| Tâche | Intervalle | Grace |
|---|---|---|
| Toutes les heures | 60 min | 10 min |
| Sauvegarde quotidienne (durée moyenne 20 min) | 1440 min | 60 min |
| Rapport hebdomadaire | 10080 min | 6 heures |
| Check du worker toutes les 5 minutes | 5 min | 2 min |
Commencez
À l'étape suivante, nous vous montrons la procédure exacte pour créer un moniteur heartbeat dans le tableau de bord ePulz.io.