Home / Integracje i pluginy / Checkmk – SMS Integration

Checkmk – instrukcja integracji SMS

Wysyłaj alerty i powiadomienia z Checkmk za pomocą sprzętowej bramki SMS SMSEagle.
 

SMSEagle umożliwia niezawodne wysyłanie alertów SMS bezpośrednio z własnej infrastruktury, bez konieczności korzystania z zewnętrznych rozwiązań chmurowych. Wiadomości są wysyłane przez fizyczne urządzenie on‑premise za pośrednictwem sieci komórkowej, dzięki czemu integracja doskonale sprawdza się w środowiskach o podwyższonych wymaganiach bezpieczeństwa, w sieciach przemysłowych oraz w instalacjach z ograniczonym lub zerowym dostępem do Internetu.

Aktualna integracja z Checkmk opiera się na skrypcie powiadomień dla Checkmk 2.x i wykorzystuje APIv2 SMSEagle z uwierzytelnianiem tokenowym. Rozwiązanie jest proste we wdrożeniu, działa natywnie z mechanizmem powiadomień Checkmk i umożliwia elastyczną konfigurację zarówno na poziomie reguł, jak i poszczególnych użytkowników.

Wymagania

Przed rozpoczęciem upewnij się, że Twoje środowisko spełnia następujące wymagania:

    • Checkmk 2.x (CEE, CRE lub CME)
    • Firmware SMSEagle z obsługą APIv2 (wersja 5.0 lub nowsza)
    • Zainstalowane narzędzie curl na serwerze Checkmk

Krok 1: Konfiguracja SMSEagle

    1. Zaloguj się do interfejsu webowego SMSEagle
    2. Przejdź do Users
    3. Utwórz nowego użytkownika lub użyj istniejącego
    4. Włącz dostęp do API dla tego użytkownika
    5. Włącz APIv2
    6. Wygeneruj token dostępu
    7. Włącz uprawnienie do wysyłania SMS
    8. Skopiuj token – będzie potrzebny później w Checkmk
    9. Przejdź do Settings > SSL i ustaw Forward HTTP to HTTPS na No

Krok 2: Instalacja skryptu powiadomień w Checkmk

Skopiuj skrypt powiadomień SMSEagle do swojego środowiska Checkmk i nadaj mu uprawnienia do uruchomienia:

# Przełącz się na użytkownika swojej instancji Checkmk
su – mysite

# Skopiuj skrypt do katalogu z powiadomieniami
cp check_mk_smseagle-notify.sh ~/local/share/check_mk/notifications/

# Nadaj uprawnienia do uruchomienia
chmod 755 ~/local/share/check_mk/notifications/check_mk_smseagle-notify.sh

# Zrestartuj instancję
omd restart


To proces instalacji opisany w aktualnym repozytorium SMSEagle dla Checkmk.

Krok 3: Utworzenie reguły powiadomień w Checkmk

W Checkmk:

  • Przejdź do Setup > Events > Notifications
  • Kliknij Add rule
  • Ustaw Notification Method na SMSEagle
  • Uzupełnij wymagane parametry:
    • SMSEagle device URL
      Przykład: https://192.168.0.100
    • API Access Token
      Token APIv2 wygenerowany w SMSEagle
Parametry opcjonalne:
  • Verify SSL – tak lub nie
  • SMS priority – wartość od 0 do 9
  • Encoding – standard lub unicode
  • Modem number – opcjonalnie, dla urządzeń z wieloma modemami

Krok 4: Definicja odbiorców

W sekcji Contact selection wybierz użytkowników lub grupy kontaktów, którzy mają otrzymywać alerty SMS. Upewnij się, że każdy kontakt ma uzupełnione pole Pager poprawnym numerem telefonu w formacie międzynarodowym, np. +48123456789

 
Opcjonalnie: użycie niestandardowych atrybutów użytkownika
 
Jeśli potrzebujesz większej elastyczności, możesz zdefiniować ustawienia SMSEagle per kontakt, korzystając z Custom User Attributes w Checkmk zamiast parametrów na poziomie reguły.
 
Obsługiwane atrybuty:
  • SMSEAGLE_URL
  • SMSEAGLE_TOKEN
  • SMSEAGLE_VERIFY_SSL
  • SMSEAGLE_PRIORITY
  • SMSEAGLE_ENCODING
  • SMSEAGLE_MODEM_NO
Zdefiniowane atrybuty mają pierwszeństwo przed parametrami reguły powiadomień. Jest to przydatne, gdy różni użytkownicy lub zespoły powinni korzystać z różnych urządzeń, priorytetów lub ustawień SSL.

Uwaga dotycząca SSL

Integracja wykorzystuje komunikację HTTPS pomiędzy Checkmk a urządzeniem SMSEagle. Jeśli urządzenie SMSEagle korzysta z certyfikatu z podpisem własnym, możesz dodać ten certyfikat do zaufanych na serwerze Checkmk lub wyłączyć weryfikację SSL w parametrach powiadomień.

Rozwiązywanie problemów

Aby sprawdzić szczegółowe logi powiadomień, przejrzyj log powiadomień Checkmk:

tail -f ~/var/log/notify.log

Wpisy debugowania są oznaczone prefiksem DEBUG:, a błędy prefiksem ERROR:.

Instalacje legacy

Starsze środowiska mogą nadal korzystać ze skryptu Python notify_smseagle.py, który opiera się na starszym HTTP API SMSEagle. Wersja ta jest utrzymywana wyłącznie ze względu na kompatybilność wsteczną i znajduje się w katalogu obsolete w repozytorium.
 
Dla nowych wdrożeń zalecane jest korzystanie z aktualnej integracji Checkmk 2.x z uwierzytelnianiem tokenowym APIv2.

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowe i programowe, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po zarejestrowaniu się w wersji demonstracyjnej otrzymasz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

  • 14-dniowy bezpłatny okres próbny
  • Dostęp do ponad 20 funkcjonalności

Latests posts