Nápověda a návody ›
Heartbeat (cron monitoring)
› Co je heartbeat a kdy ho použít
Co je heartbeat a kdy ho použít
3 min čtení · Heartbeat (cron monitoring)
Ve zkratce: Heartbeat monitor vás upozorní, když nějaká úloha (typicky noční backup, denní sync nebo jiný cron job) přestane běžet. Funguje opačně než klasický uptime monitor - vy posíláte "ping" směrem na ePulz.io, ne my na váš server.
Kdy je heartbeat užitečný
- Noční backupy databáze - chcete vědět, pokud v noci backup selže
- Synchronizace s externí službou - import z CRM, accounting, payment processor
- Pravidelná fakturace - generování faktur, odesílání připomínek
- Cleanup úlohy - mazání starých session, dočasných souborů, logů
- Reporty a statistiky - týdenní/měsíční reporty
- Healthcheck background workerů - Celery, Sidekiq, BullMQ
Jak to funguje
- V ePulz.io vytvoříte heartbeat monitor s očekávaným intervalem (např. každou hodinu, každou noc ve 3:00 atd.)
- Dostanete unikátní heartbeat URL - vypadá jako
https://epulz.io/heartbeat/abc123xyz - Tuto URL přidáte na konec svého cron skriptu / úlohy
- Když úloha úspěšně doběhne, "pingne" tuto URL
- Pokud ping nepřijde v očekávaném čase (+ grace perioda), ePulz.io vás upozorní
Praktický příklad
Představme si noční backup databáze který běží každý den ve 3:00 ráno a trvá ~5 minut:
- Vytvoříte heartbeat monitor s názvem "Noční DB backup", interval 1440 minut (24 hodin), grace 15 minut
- Do backup skriptu přidáte: po úspěšném backupu zavolejte heartbeat URL
- Každý den po 3:05 ePulz.io očekává ping. Pokud nepřijde do 3:15 (interval + grace), pošle vám alert
Klíčový princip:
Heartbeat URL voláte pouze po úspěšném dokončení úlohy. Pokud skript selže, ping neprojde, ePulz.io se o tom dozví a upozorní vás. Žádný ping = výpadek.
Interval vs Grace
- Interval - jak často by měl heartbeat přijít (např. každou hodinu = 60 minut)
- Grace - tolerance, jak dlouho čekat po očekávaném čase, než spustíme alert
Praktické hodnoty:
| Úloha | Interval | Grace |
|---|---|---|
| Každou hodinu | 60 min | 10 min |
| Denní backup (průměrně 20 min trvá) | 1440 min | 60 min |
| Týdenní report | 10080 min | 6 hodin |
| Každých 5 minut worker check | 5 min | 2 min |
Začněte
V dalším kroku ukazujeme přesný postup jak heartbeat monitor vytvořit v ePulz.io dashboardu.