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.
Przed użyciem API włącz dostęp do API na urządzeniu SMSEagle.
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ń.
| Nazwa | Opis | Domyślnie | Wymagane |
|---|---|---|---|
| DEFAULT_RECIPIENT_SMSEAGLE | Jeś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 | sms | tak | |
| SMSEAGLE_CALL_DURATION | 10 | tak | |
| SMSEAGLE_VOICE_ID | 10 | tak |
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"
#------------------------------------------------------------------------------
# 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"
#------------------------------------------------------------------------------
# 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.
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.