Home / Integracje i pluginy / Integracja SMS z Shinken

+

Wysyłaj alerty SMS z Shinken

Alerty z Shinken docierają do osoby na dyżurze SMS-em. SMSEagle wysyła je przez własne połączenie komórkowe, więc nie zależą od internetu ani usługi w chmurze.

Gotowy skrypt do pobrania

Skrypt pobierasz z repozytorium SMSEagle na GitHubie i kopiujesz na serwer Shinken, bez pisania własnego kodu.

Wiesz, co przestało działać

Osobne powiadomienia dla serwerów i usług sprawiają, że z treści SMS-a od razu wiesz, gdzie jest problem.

Działa bez internetu

SMSEagle wysyła alerty przez własną kartę SIM prosto do sieci komórkowej, więc nie zależą od internetu ani dostawcy SMS w chmurze.

Jak to działa?

1

Zdarzenie

Shinken wykrywa zmianę stanu hosta lub usługi, na przykład przejście serwera w stan DOWN albo monitorowanej usługi w stan CRITICAL.

2

Komunikacja

Shinken wysyła zapytanie HTTP API bezpośrednio do SMSEagle w Twojej sieci lokalnej.

3

Alert

SMSEagle dostarcza alert przez własne połączenie komórkowe, bez pośrednictwa zewnętrznego serwisu, jako SMS do telefonu odbiorcy.

Konfiguracja w około 10 minut

Uruchomienie integracji zajmuje około pięciu minut. Wygeneruj token API w SMSEagle, zdefiniuj komendy powiadomień w Shinken – i gotowe.

SMSEagle wysyła alerty z Shinken do właściwej osoby SMS-em, o każdej porze.

Bez opłat za każdą wiadomość

SMSEagle wysyła SMS-y przez zwykłą kartę SIM, więc płacisz tylko za abonament u operatora.

Alerty działają przy awarii operatora

Na urządzeniach z dwiema kartami SIM różnych operatorów SMSEagle przełącza się na drugą, gdy sieć pierwszego operatora nie działa.

Alerty działają nawet przy awarii jednego urządzenia

Dwa urządzenia SMSEagle mogą pracować w klastrze HA: gdy jedno ulegnie awarii, drugie przejmuje wysyłkę.

Konfiguracja SMSEagle

  1. Utwórz nowego użytkownika dla tego skryptu w interfejsie webowym SMSEagle: menu System > Users.
  2. Utwórz klucz API dla tego użytkownika w Settings > Global settings > API, na stronie API v1:
    • a) kliknij Create API key, wpisz nazwę w polu Key name i wskaż tego użytkownika w polu Owner
    • b) ustaw uprawnienia APIv1 wymienione niżej, potem kliknij Create key
Token dostępu jest pokazywany tylko raz, zaraz po zapisaniu. Token ten w dalszej części będzie oznaczany jako SMSEAGLEAPITOKEN – zamień go w skrypcie na swoją wartość.

  • W formularzu klucza dodaj uprawnienia dla metod APIv1, z których chcesz korzystać:
    • Send SMS => sms
    • Ring call => ring
    • Text-to-speech call => tts
    • Advanced text-to-speech call => tts_adv

Konfiguracja Shinken

1. Pobierz najnowszą wersję skryptu notify_eagle_sms.pl z naszego repozytorium: https://github.com/smseagle/smseagle-nagios
Umieść wtyczkę w katalogu wtyczek Shinken.

2. Utwórz polecenia powiadomień SMS (zwykle w pliku commands.cfg).
Zamień SMSEAGLEURL na adres URL swojego urządzenia SMSEagle (na przykład: http://192.168.50.150)
Zamień SMSEAGLEAPITOKEN na swój token API do SMSEagle (na przykład: NZg2yNmWYb5Q7I3Y3Ifnk5E)

Zdefiniuj poniższe polecenia:

define command {
        command_name notify-by-sms 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($SERVICEOUTPUT$) Date($SHORTDATETIME$)" 
} 

define command { 
        command_name host-notify-by-sms 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-ring-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-ring-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-tts-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-tts-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-tts-adv-call
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -dstaddr $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-tts-adv-call
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -dstaddr $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

3. W kontaktach Shinken (zwykle w pliku contacts.cfg) dodaj kontakt. Pole „pager” powinno zawierać numer telefonu do alertów SMS w pełnym formacie międzynarodowym, bez znaku + na początku, na przykład: 48xxxxxxxxx (jeśli Twój operator wymaga znaku + w numerze, wpisz zamiast niego 00)

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowo-programowe, które gwarantuje szybkie dostarczenie wiadomości do wskazanych odbiorców – niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po rejestracji do wersji demo otrzymujesz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

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

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle