Nápověda a návodyHeartbeat (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

  1. V ePulz.io vytvoříte heartbeat monitor s očekávaným intervalem (např. každou hodinu, každou noc ve 3:00 atd.)
  2. Dostanete unikátní heartbeat URL - vypadá jako https://epulz.io/heartbeat/abc123xyz
  3. Tuto URL přidáte na konec svého cron skriptu / úlohy
  4. Když úloha úspěšně doběhne, "pingne" tuto URL
  5. 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:

  1. Vytvoříte heartbeat monitor s názvem "Noční DB backup", interval 1440 minut (24 hodin), grace 15 minut
  2. Do backup skriptu přidáte: po úspěšném backupu zavolejte heartbeat URL
  3. 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:

ÚlohaIntervalGrace
Každou hodinu60 min10 min
Denní backup (průměrně 20 min trvá)1440 min60 min
Týdenní report10080 min6 hodin
Každých 5 minut worker check5 min2 min

Začněte

V dalším kroku ukazujeme přesný postup jak heartbeat monitor vytvořit v ePulz.io dashboardu.

Další krok:

Vytvoření heartbeat monitoru v ePulz.io.

Vytvořit heartbeat monitor →