Spis treści
Podczas incydentu powiadomienia e-mail i na czacie łatwo przeoczyć. Przy krytycznych alertach Echobell potrafi zamienić powiadomienia webhook z Grafany w prawdziwe połączenia telefoniczne, z eskalacją i ponawianiem prób. Ten przewodnik przeprowadzi Cię przez pełną konfigurację.
Powiązana dokumentacja:
- Czym jest Echobell → /docs/what-is-echobell
- Typy powiadomień i ponawianie → /docs/notification
- Wprowadzenie do webhooków → /docs/webhook
- Dokumentacja integracji z Grafaną → /docs/developer/grafana
Wymagania wstępne
- Konto Echobell z aktywnym kanałem i adresem URL webhooka (zob. /docs/webhook)
- Dostęp administracyjny do instancji Grafany
- Co najmniej jedna skonfigurowana reguła alertu
Konfiguracja
Krok 1 — utwórz punkt kontaktowy typu Webhook w Grafanie
- Przejdź do Alerting → Contact points
- Kliknij New contact point i wybierz Webhook
- Nadaj mu rozpoznawalną nazwę, np. „Echobell Phone Calls"
Krok 2 — dodaj adres URL webhooka Echobell
Ustaw adres URL na webhook swojego kanału:
https://hook.echobell.one/t/<channel-token>
Skopiuj go z ustawień kanału w Echobell (szczegóły w /docs/webhook). Traktuj go jak sekret i zmień, jeśli wycieknie.
Krok 3 — przetestuj integrację
Kliknij Test w Grafanie, aby wysłać przykładowy alert. W ciągu kilku sekund powinno przyjść połączenie z Echobell.
Krok 4 — podłącz go do zasad powiadamiania
- Przejdź do Alerting → Notification policies
- Utwórz lub edytuj zasadę obejmującą Twoje krytyczne alerty
- Dodaj punkt kontaktowy „Echobell Phone Calls"
Od tej chwili Grafana będzie kierować pasujące alerty do Echobell.
Dobre praktyki
- Rezerwuj połączenia telefoniczne dla alertów o wysokim priorytecie; przy niższej wadze wystarczy czat lub e-mail
- Skonfiguruj ponawianie i limity czasu w Echobell, aby ograniczyć zmęczenie alertami (/docs/notification)
- Ustaw eskalację do osób z zespołu, jeśli pierwsze połączenie zostanie nieodebrane
- Korzystaj z godzin ciszy, aby nie budzić nikogo mało pilnymi sprawami
- Udostępnij kanał zespołowi dyżurnemu i dbaj o aktualność grafiku
Opcje zaawansowane
- Udostępniaj kanały osobom z zespołu, aby zwiększyć pokrycie dyżurów
- Dostosuj odczytywaną treść do typu alertu za pomocą szablonów
- Skonfiguruj liczbę prób i ścieżki eskalacji
- Ustaw kontakty zapasowe dla większej odporności
Pełna dokumentacja: /docs/developer/grafana
Rozwiązywanie problemów
- Brak połączenia: sprawdź, czy zasada powiadamiania kieruje alerty do punktu kontaktowego Echobell
- Błąd 4xx na webhooku: zweryfikuj dokładny adres URL webhooka i to, czy kanał jest aktywny
- Zbyt wiele połączeń: zawęź zakres zasady albo podnieś progi wagi alertów
- Zbyt mało połączeń: podnieś wagę alertów albo dodaj filtry etykiet, aby krytyczne alerty pasowały do zasady
Powiązane
- Alerty z webhooków dla własnych systemów → /blog/get-notified-with-webhook-mcp
- Powiadomienia o błędach GitHub Actions → /blog/github-actions-notifications
- Dokumentacja Grafany dla programistów → /docs/developer/grafana