Home / Integracje i pluginy / Netdata SMS Integration

Wysyłka SMS, MMS i wykonywanie połączeń głosowych z Netdata dzięki SMSEagle - instrukcja intregracji

Poniżej znajdziesz opis jak zintegrować Netdata z urządzeniem SMSEagle, w celu obsługi SMS/MMS. Proces integracji jest prosty i powinien zająć nie więcej niż 10 minut.

Proces konfiguracji opisano także w dokumentacji Netdata.

SMSEagle to sprzętowa bramka SMS. Działa bez dostępu do internetu. Dzięki temu nie jest wymagane połączenie z zewnętrznymi usługodawcami. Wszystkie alerty i powiadomienia generowane są lokalnie i wysyłane bezpośrednio przez sieć komórkową. Urządzenia SMSEagle są wykorzystywane przede wszystkim, gdy istnieje konieczność zachowania wysokiego poziomu bezpieczeństwa, oraz w środowiskach izolowanych.

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 Użytkownicy.
  2. Utwórz nowego użytkownika: + Dodaj Użytkownika, poziom dostępu: Użytkownik.
  3. Przy nowym użytkowniku kliknij Dostęp do API.
  4. Zaznacz APIv2 i kliknij Wygeneruj nowy token, aby utworzyć token dostępu.
  5. Ustaw uprawnienia w sekcji APIv2 Permission:
    • 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.

Uwaga: Połączenia budzące i połączenia z konwersją tekstu na mowę są dostępne wyłącznie dla użytkowników, którzy zakupili dodatek Głosowy dla urządzenia SMSEagle.

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle

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