Pomoc i poradniki ›
Heartbeat (monitoring cron)
› Co to heartbeat i kiedy używać
Co to heartbeat i kiedy używać
3 min czytania · Heartbeat (monitoring cron)
W skrócie: Heartbeat monitor ostrzeże Cię, gdy jakieś zadanie (typowo nocny backup, dzienny sync lub inny cron job) przestanie działać. Działa odwrotnie niż klasyczny monitor uptime - to Ty wysyłasz "ping" do ePulz.io, a nie my do Twojego serwera.
Kiedy heartbeat jest przydatny
- Nocne backupy bazy danych - chcesz wiedzieć, jeśli w nocy backup zawiedzie
- Synchronizacja z usługą zewnętrzną - import z CRM, accounting, payment processor
- Regularna fakturacja - generowanie faktur, wysyłanie przypomnień
- Zadania cleanup - usuwanie starych sesji, plików tymczasowych, logów
- Raporty i statystyki - raporty tygodniowe/miesięczne
- Healthcheck background workerów - Celery, Sidekiq, BullMQ
Jak to działa
- W ePulz.io tworzysz monitor heartbeat z oczekiwanym interwałem (np. co godzinę, każdej nocy o 3:00 itd.)
- Otrzymujesz unikalny heartbeat URL - wygląda jak
https://epulz.io/heartbeat/abc123xyz - Ten URL dodajesz na końcu swojego skryptu cron / zadania
- Gdy zadanie zakończy się pomyślnie, "pingnie" ten URL
- Jeśli ping nie przyjdzie w oczekiwanym czasie (+ okres grace), ePulz.io Cię powiadomi
Praktyczny przykład
Wyobraź sobie nocny backup bazy danych, który uruchamia się codziennie o 3:00 rano i trwa ~5 minut:
- Tworzysz monitor heartbeat o nazwie "Nocny backup DB", interwał 1440 minut (24 godziny), grace 15 minut
- Do skryptu backupu dodajesz: po udanym backupie wywołaj heartbeat URL
- Każdego dnia po 3:05 ePulz.io oczekuje pinga. Jeśli nie przyjdzie do 3:15 (interwał + grace), wyśle Ci alert
Kluczowa zasada:
Heartbeat URL wywołujesz wyłącznie po udanym zakończeniu zadania. Jeśli skrypt zawiedzie, ping nie przejdzie, ePulz.io się o tym dowie i powiadomi Cię. Brak pinga = awaria.
Interwał vs Grace
- Interwał - jak często ma przyjść heartbeat (np. co godzinę = 60 minut)
- Grace - tolerancja, ile czekać po oczekiwanym czasie, zanim wyślemy alert
Wartości praktyczne:
| Zadanie | Interwał | Grace |
|---|---|---|
| Co godzinę | 60 min | 10 min |
| Dzienny backup (średnio 20 min trwa) | 1440 min | 60 min |
| Raport tygodniowy | 10080 min | 6 godz |
| Co 5 minut worker check | 5 min | 2 min |
Zacznij
W kolejnym kroku pokazujemy dokładną procedurę utworzenia monitora heartbeat w dashboardzie ePulz.io.