Kanały alertów

HelloCron może powiadamiać Cię o zdarzeniach monitorów (awarie, pominięte uruchomienia, timeouty, powroty do działania) przez kilka kanałów. Możesz skonfigurować dowolną liczbę kanałów i wybrać, o których typach zdarzeń każdy z nich informuje.

Kanałami zarządzasz w panelu w sekcji Ustawienia -> Kanały powiadomień. Każdy kanał ma przycisk Test, który wysyła testowe powiadomienie wyłącznie na ten kanał, dzięki czemu możesz zweryfikować konfigurację, zanim na niej polegniesz.

Email

Najprostszy kanał. Pozostaw pole adresu puste, aby użyć emaila konta, albo podaj inny adres (np. alias zespołowy).

Telegram

Alerty na Telegramie są darmowe i natychmiastowe, a podłączenie to jedno kliknięcie.

1. W panelu dodaj kanał typu Telegram i kliknij Połącz z Telegramem.
2. Zeskanuj kod QR telefonem (albo kliknij Otwórz w Telegramie) i wciśnij Start w otwartym czacie. Dla grupy wybierz Dodaj do grupy i wskaż grupę.
3. Formularz uzupełni się sam i pokaże „Połączono”. Zapisz kanał i kliknij Test.

Alerty dostarcza oficjalny bot HelloCrona. Bez tokenów, bez chat ID, bez szukania czegokolwiek.

Zaawansowane: własny bot. Jeśli wolisz, żeby alerty przychodziły od bota pod Twoją kontrolą, rozwiń w formularzu Zaawansowane: własny bot: załóż bota przez @BotFather (/newbot, skopiuj token w formacie 123456789:AAF...), pobierz chat ID z https://api.telegram.org/bot<TOKEN>/getUpdates (ID grup są ujemne) i wypełnij oba pola. Kanał z własnym tokenem zawsze wysyła przez tego bota. HelloCron przechowuje token wyłącznie do wysyłki i nigdy nie zapisuje go w logach.

Discord

Alerty na Discordzie korzystają z webhooków kanału, bot nie jest potrzebny.

1. W Discordzie otwórz ustawienia docelowego kanału: Integracje -> Webhooki -> Nowy webhook.
2. Skopiuj adres URL webhooka (zaczyna się od https://discord.com/api/webhooks/).
3. W panelu dodaj kanał typu Discord i wklej adres URL.
4. Kliknij Test. Alerty przychodzą jako embedy, zielone dla powrotów do działania i czerwone dla awarii.

Slack

1. Utwórz incoming webhook w swoim workspace Slacka.
2. W panelu dodaj kanał typu Slack i wklej adres URL webhooka (zaczyna się od https://hooks.slack.com/services/).
3. Kliknij Test.

PagerDuty

Alerty PagerDuty korzystają z Events API v2: awarie otwierają incydenty, a powroty do zdrowia automatycznie je rozwiązują.

1. W PagerDuty utwórz usługę (lub otwórz istniejącą) i dodaj integrację Events API v2: Service -> Integrations -> Add integration -> Events API v2.
2. Skopiuj Integration Key (nazywany też routing key, 32 znaki).
3. W panelu dodaj kanał typu PagerDuty i wklej klucz.
4. Kliknij Test.

Jak mapują się zdarzenia:

• Failed, Missed i Timeout wyzwalają incydent z severity critical; Degraded i Still failing używają warning.
• Recovered rozwiązuje incydent otwarty dla danego monitora dzięki wspólnemu kluczowi deduplikacji, więc niestabilny monitor nie zasypuje Cię incydentami.
• Każdy incydent zawiera link do monitora w panelu HelloCron.

Webhook

Wysyła payload JSON na dowolny endpoint HTTP, przydatne do integracji z własnymi systemami, narzędziami on-call lub automatyzacją.

{
  "id": 123,
  "type": "failed",
  "monitor_name": "db-backup",
  "message": "Monitor db-backup failed",
  "metadata": {},
  "occurred_at": "2026-07-24T18:00:00+00:00"
}

• Metoda: POST (domyślna) lub GET (payload jako parametry zapytania).
• Własne nagłówki: jeden na linię jako Nazwa-Nagłówka: wartość, np. nagłówek Authorization dla Twojego endpointu.
• Adresy webhooków Slack i Discord są tu celowo odrzucane: ich API oczekują innego formatu payloadu. Użyj dedykowanego typu kanału Slack lub Discord.

Grupy powiadomień

Grupa powiadomień to nazwany zestaw kanałów. Monitor przypisany do grupy alarmuje wyłącznie jej kanały; monitory bez grupy zachowują się domyślnie i alarmują wszystkie włączone kanały konta.

Typowy układ: grupa „backupy” wskazująca dedykowany czat Telegrama i grupa „www” wskazująca webhook dyżurny. Konto może mieć kilka kanałów tego samego typu, więc każda grupa może celować we własny czat Telegrama.

Grupami zarządzasz w Ustawienia -> Kanały powiadomień -> Zarządzaj grupami: tworzysz grupę, zaznaczasz jej kanały i na tej samej stronie przypinasz monitory (ping oraz checki HTTP/SSL). Grupę można też wybrać w edycji pojedynczego monitora.

Dwa szczegóły warte uwagi:

• Grupa bez kanałów wycisza swoje monitory poza panelem (dzwonek w aplikacji nadal działa). Panel o tym ostrzega.
• Usunięcie grupy niczego poza nią nie kasuje: jej monitory wracają do wszystkich kanałów konta.

W manifestach config-as-code grupa podróżuje jako notification_group (nazwa grupy). Pominięcie klucza odpina grupę; nieznane nazwy są odrzucane z kodem błędu notification_group_invalid.

Typy zdarzeń

Każdy kanał subskrybuje wybrane typy zdarzeń: