Połącz rozbudowany system alertów Grafana z niezawodnością sprzętowej bramki SMSEagle. Zyskaj pewność, że jako pierwszy dowiesz się o krytycznym incydencie, nawet wtedy, gdy awarii ulegnie sieć, od której zależy Twoje środowisko monitoringu.
Grafana skutecznie wykrywa anomalie, lecz wysyłka alertów zależy zwykle od internetu, poczty lub dostawców chmurowych. Jeśli którykolwiek z tych elementów zawiedzie, alert nigdy do Ciebie nie dotrze. SMSEagle wysyła alerty bezpośrednio przez sieć komórkową, gwarantując ich dostarczenie nawet przy całkowitej awarii łącza.
Grafana oraz monitorowane przez nią systemy często działają na tej samej infrastrukturze, tym samym hoście Docker lub tym samym klastrze maszyn wirtualnych. Jeśli środowisko wirtualne ulegnie awarii, system alertowania również przestanie działać. SMSEagle to niezależne urządzenie fizyczne z własną kartą SIM, w pełni odporne na awarie monitorowanych serwerów.
SMSEagle działa w modelu lokalnym (on-premises). To oznacza, że treść Twoich alertów nie trafia do zewnętrznych dostawców SaaS ani chmurowych bramek SMS. Urządzenie wysyła wiadomości bezpośrednio do operatora GSM, zapewniając pełną kontrolę nad danymi.
Reguła alertów Grafana analizuje metryki lub logi i wykrywa stan alarmowy (np. min (smseagle_modem_signal_strength) <30 lub dowolny warunek oparty na Prometheus lub Loki).
Punkt kontaktowy (Contact point) typu Webhook w Grafanie przesyła powiadomienie do smseagle-alert-webhook – niewielkiego adaptera open source działającego obok Grafany, który przekazuje alert do SMSEagle za pośrednictwem APIv2.
SMSEagle wysyła wiadomość SMS lub wykonuje połączenie głosowe z syntezą mowy (Text-to-Speech) do odbiorców przypisanych do danego alertu.
Punkt kontaktowy (Contact point) typu Webhook w Grafanie nie może komunikować się bezpośrednio z API SMSEagle. Potrzebny jest niewielki pośrednik. Taką rolę pełni smseagle-alert-webhook – darmowy adapter open-source, który można uruchomić za pomocą jednego polecenia “docker compose up”. Wystarczy skierować do niego punkt kontaktowy Webhook w Grafanie, a wszystkie istniejące reguły alertów będą mogły wysyłać powiadomienia SMS oraz wykonywać połączenia głosowe. Nie wymaga to żadnych zmian w skonfigurowanych regułach alertów.
Nie każdy alert wymaga połączenia głosowego i nie każde połączenie powinno trafiać do tej samej osoby. Dodaj „smseagle_channel: call” do alertu o wysokim priorytecie, a SMSEagle zamiast wysyłać SMS wykona połączenie głosowe i odczyta treść alertu za pomocą syntezy mowy. To rozwiązanie znacznie trudniej przeoczyć, szczególnie w środku nocy. Możesz również dodać „smseagle_to: +3712…,+3712…”, aby skierować konkretny alert do innej grupy odbiorców. Konfiguracja odbywa się bezpośrednio w sekcji Labels reguły alertu, bez modyfikacji kodu i bez ponownego wdrażania adaptera.
Nie każdy alert musi trafiać do wszystkich, ale żaden nie może zostać zignorowany.SMSEagle umożliwia tworzenie grup odbiorców, dzięki którym każde powiadomienie trafia do właściwego zespołu. Eskalacja zapewnia, że jeśli pierwsza osoba nie potwierdzi otrzymania alertu, zostanie on automatycznie przekazany do kolejnego dyżurującego. W połączeniu z harmonogramami dyżurów powiadomienia trafiają zawsze do osób, które są aktualnie odpowiedzialne za reakcję, zamiast być na stałe przypisane do jednego numeru telefonu.
Kto pilnuje strażnik? Jeśli serwer Grafana przestanie działać, nie będzie w stanie wysłać ani jednego alertu, a Ty możesz dowiedzieć się o problemie dopiero wtedy, gdy będzie już za późno. Dzięki wbudowanej w SMSEagle funkcji Network Monitoring, bramka niezależnie sprawdza system Grafana i wysyła SMS-a lub wykonuje połączenie głosowe w momencie, gdy przestanie on odpowiadać. W ten sposób Twoja platforma monitorująca zyskuje własny, niezależny nadzór.
SMSEagle to sprzętowa bramka SMS, która umożliwia wysyłanie i odbieranie powiadomień bezpośrednio przez sieć komórkową. Działa lokalnie, dzięki czemu wszystkie dane pozostają pod pełną kontrolą użytkownika.
Dowiedz się, jak zintegrować Grafanę z SMSEagle i dostarczać alerty za pomocą wiadomości SMS oraz połączeń głosowych. Tutorial krok po kroku pokazuje, jak skonfigurować token API, wdrożyć adapter webhook, utworzyć punkt kontaktowy, skonfigurować reguły alertów oraz przetestować powiadomienia SMS i głosowe w praktyce.
Zanim zaczniesz: to rozwiązanie jest przeznaczone wyłącznie dla środowisk hostowanych lokalnie. Silnik alertów Grafana musi mieć możliwość komunikacji z adapterem, a adapter musi mieć dostęp do urządzenia SMSEagle w sieci lokalnej. Najlepszym rozwiązaniem jest więc lokalnie hostowana instancja Grafana działająca w tej samej sieci co urządzenie SMSEagle. Grafana Cloud nie może komunikować się bezpośrednio z prywatnymi adresami w sieci LAN. W takim przypadku zalecamy skorzystanie z funkcji Email-to-SMS Poller dostępnej w SMSEagle.
git clone https://github.com/dmitrylambert/grafana-monitoring.git
cd grafana-monitoring/smseagle-alert-webhook
cp .env.example .env
Edytuj plik .env:
SMSEAGLE_API_URL – adres IP lub nazwa hosta urządzenia SMSEagle.SMSEAGLE_ACCESS_TOKEN – token APIv2 utworzony w kroku 1.SMSEAGLE_SMS_TO-domyślny numer lub numery odbiorców powiadomień (można je nadpisać dla poszczególnych alertów, patrz niżej).SMSEAGLE_TEST_MODE=true, dopóki nie zweryfikujesz poprawnego działania integracji od początku do końca.docker compose up -d --build
curl http://localhost:9099/healthz # -> okSMSEagleWebhookhttp://host.docker.internal:9099/, jeśli Grafana działa w Dockerze na tym samym hoście).POSTSMSEAGLE_TEST_MODE=true), aby zweryfikować konfigurację bez wysyłania rzeczywistej wiadomości SMS.
smseagle_channel: call, aby alert został dostarczony jako połączenie głosowe (aby wysłać wiadomość SMS, pomiń to pole lub ustaw wartość sms). Opcjonalnie możesz również dodać smseagle_to: +3712..., aby określić innych odbiorców dla tego konkretnego alertu.
Jeśli korzystasz z GitOps i chcesz mieć możliwość łatwego odtworzenia konfiguracji, skopiuj przykładowe pliki contactpoints.yaml, policies.yaml, and alert-rule.example.yamldo katalogu provisioning w Grafanie, a następnie uruchom Grafanę ponownie. Przed restartem zaktualizuj wartość parametru url: w pliku contactpoints.yaml, wskazując adres uruchomionego adaptera.
Uwaga: plik policies.yaml tworzy główną politykę powiadomień. Po jego zaimportowaniu wszystkie alerty będą domyślnie kierowane do SMSEagle, a sekcja Notification Policies w interfejsie Grafana stanie się dostępna tylko do odczytu. Jeśli chcesz wysyłać do SMSEagle tylko wybrane alerty, pomiń plik policies.yaml i skonfiguruj odpowiednią regułę routingu w interfejsie użytkownika Grafana (zobacz krok 3a).
Pozostaw ustawienie SMSEAGLE_TEST_MODE=true na czas konfiguracji i testów. W tym trybie SMSEagle weryfikuje każde przychodzące żądanie, ale nie wysyła rzeczywistych powiadomień (testowa wysyłka zwraca id: 0). Uruchom regułę alertu testowego i sprawdź jej przetworzenie za pomocą polecenia:docker compose logs -f.
SMSEAGLE_TEST_MODE na false, a następnie przebuduj i uruchom ponownie kontener, aby włączyć wysyłanie rzeczywistych powiadomień.message, summary lub description. Komunikat jest wysyłany lub odczytywany dokładnie w takiej formie, w jakiej został zdefiniowany, z prefiksem PROBLEM. lub RESOLVED.. Powiadomienie nie zawiera dodatkowych etykiet, liczników ani innych automatycznie generowanych informacji, dzięki czemu odbiorca otrzymuje dokładnie taką treść, jaką skonfigurowano w regule alertu.Szczegółowy przewodnik integracji przygotowany przez Dmitry’ego Lamberta jest dostępny w serwisie Github.
SMSEagle to urządzenie z wbudowanym oprogramowaniem, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie czy są to powiadomienia, alerty czy ważne aktualizacje.
Wypełnij formualarz i uzyskaj dostep do fizycznego urządzenia demonstracyjnego.
