Home / Integracje i pluginy / Integracja SMS z Netdata

+

Wysyłaj alerty SMS/głosowe z Netdata

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

Natywna obsługa SMSEagle w Netdata

Netdata natywnie obsługuje SMSEagle. Wpisujesz adres urządzenia i token API w ustawieniach powiadomień, a alerty zaczynają przychodzić SMS-em albo jako połączenie.

Alerty dla każdego zespołu

Netdata wysyła alerty do odbiorców ustawionych dla każdej roli, więc każdy zespół dostaje tylko swoje alerty.

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

Alarm kondycji (health alarm) w Netdata uruchamia się, gdy monitorowana metryka przekroczy skonfigurowany próg.

2

Komunikacja

System powiadomień Netdata, wysyłany bezpośrednio przez agenta, wysyła żądanie HTTP API do urządzenia 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 albo połączenie na telefon odbiorcy.

Konfiguracja w około 10 minut

Konfiguracja jest szybka i prosta – uruchomienie całości zajmuje około pięciu do dziesięciu minut. Wygeneruj token API w SMSEagle, edytuj plik health_alarm_notify.conf w Netdata – i gotowe.

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

SMS-y i połączenia głosowe z jednego urządzenia

SMSEagle wysyła alerty z Netdata jako SMS, sam dzwonek albo połączenie, w którym odczytuje alert na głos, wszystko z jednego urządzenia.

Fill-in-the-call-6

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

Przed użyciem API włącz dostęp do API na urządzeniu SMSEagle.

  1. Przejdź do Web-GUI i otwórz menu System > Users.
  2. Utwórz nowego użytkownika, poziom dostępu: Użytkownik.
  3. Przejdź do Settings > Global settings > API i otwórz stronę API v2.
  4. Kliknij Create API key, wpisz nazwę w polu Key name i wskaż tego użytkownika w polu Owner.
  5. Ustaw uprawnienia w sekcji Permissions, a potem kliknij Create key – token dostępu jest pokazywany tylko raz, zaraz po zapisaniu:
    • Messages: Send SMS.
    • Calls: Make a ring call, Make a TTS call, Make a TTS Advanced call, jeśli planujesz alerty głosowe.

Konfiguracja Netdata

Plik

Nazwa pliku konfiguracyjnego: health_alarm_notify.conf.

Edytuj plik za pomocą edit-config z katalogu konfiguracyjnego Netdata.

				
					cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config health_alarm_notify.conf
				
			

Opcje

Poniższe opcje można zdefiniować dla tego mechanizmu powiadomień.

NazwaOpisDomyślnieWymagane
DEFAULT_RECIPIENT_SMSEAGLEJeśli rola nie ma skonfigurowanych odbiorców, powiadomienie trafi na ten numer. Puste oznacza brak powiadomienia dla niekonfigurowanych ról. Można podać wielu odbiorców w formacie „PHONE1,PHONE2…”. yes
SMSEAGLE_API_URL  tak
SMSEAGLE_API_ACCESSTOKEN  tak
SMSEAGLE_MSG_TYPE smstak
SMSEAGLE_CALL_DURATION 10tak
SMSEAGLE_VOICE_ID 10tak

DEFAULT_RECIPIENT_SMSEAGLE –
Wszystkie role domyślnie użyją tej zmiennej, jeśli pozostaną nieskonfigurowane. Możesz zdefiniować różnych odbiorców per rola, edytując wpisy na dole tego samego pliku:

				
					role_recipients_smseagle[sysadmin]="+11222333444"
role_recipients_smseagle[domainadmin]="+11222333445"
role_recipients_smseagle[dba]="+11222333446"
role_recipients_smseagle[webmaster]="+11222333447"
role_recipients_smseagle[proxyadmin]="+11222333448"
role_recipients_smseagle[sitemgr]="+11222333449"
				
			

SMSEAGLE_API_URL
Adres URL urządzenia SMSEagle dostępnego z Netdata, np. https://192.168.0.101. Wymagane: tak.

SMSEAGLE_API_ACCESSTOKEN
Token dostępu dla utworzonego użytkownika SMSEagle. Wymagane: tak.

SMSEAGLE_MSG_TYPE
Typ wysyłki. Dostępne: sms, mms, ring, tts, tts_advanced. Niektóre typy wymagają dodatkowych parametrów. Domyślnie: sms. Wymagane: tak.

SMSEAGLE_CALL_DURATION
Czas trwania połączenia. Wymagane dla ring, tts i tts_advanced. Domyślnie: 10. Wymagane: tak.

SMSEAGLE_VOICE_ID
ID modelu głosu. Wymagane dla tts_advanced. Domyślnie: 10. Wymagane: tak.

Przykłady
Konfiguracja dla SMS

				
					#------------------------------------------------------------------------------
# SMSEagle options

SEND_SMSEAGLE="YES"
SMSEAGLE_API_URL="XXXXXXXX"
SMSEAGLE_API_ACCESSTOKEN="XXXXXXX"
SMSEAGLE_MSG_TYPE="sms"
DEFAULT_RECIPIENT_SMSEAGLE="+11222333444"
				
			

Konfiguracja dla alertu Wake-up Call (ring only)

				
					#------------------------------------------------------------------------------
# SMSEagle options

SEND_SMSEAGLE="YES"
SMSEAGLE_API_URL="XXXXXXXX"
SMSEAGLE_API_ACCESSTOKEN="XXXXXXX"
SMSEAGLE_MSG_TYPE="ring"
SMSEAGLE_CALL_DURATION="15"
DEFAULT_RECIPIENT_SMSEAGLE="+11222333444"
				
			

Konfiguracja dla alertu Głosowego (text-to-speech)

				
					#------------------------------------------------------------------------------
# SMSEagle options

SEND_SMSEAGLE="YES"
SMSEAGLE_API_URL="XXXXXXXX"
SMSEAGLE_API_ACCESSTOKEN="XXXXXXX"
SMSEAGLE_MSG_TYPE="tts_advanced"
SMSEAGLE_CALL_DURATION="15"
SMSEAGLE_VOICE_ID="1"
DEFAULT_RECIPIENT_SMSEAGLE="+11222333444"
				
			

Rozwiązywanie problemów
Test powiadomień

				
					# become user netdata
sudo su -s /bin/bash netdata

# enable debugging info on the console
export NETDATA_ALARM_NOTIFY_DEBUG=1

# send test alarms to sysadmin
/usr/libexec/netdata/plugins.d/alarm-notify.sh test

# send test alarms to any role
/usr/libexec/netdata/plugins.d/alarm-notify.sh test "ROLE"
				
			

Powyższe testuje wszystkie mechanizmy powiadomień dla wybranej roli.

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