Netdata alerts reach the person on duty as an SMS or a phone call. SMSEagle sends them over its own cellular connection, so they don’t depend on internet access or a cloud service.
Netdata supports SMSEagle natively. You enter the device address and API token in the notification settings, and alerts start arriving by SMS or as a call.
Netdata sends alerts to the recipients set for each role, so every team gets only its own alerts.
SMSEagle sends alerts through its own SIM card straight to the mobile network, so they don’t depend on internet access or a cloud SMS provider.
A Netdata health alarm fires when a monitored metric crosses its configured threshold.
Netdata’s agent-dispatched notification system sends an HTTP API request to the SMSEagle device over your local network.
SMSEagle delivers the alert over its own cellular connection, not through a third-party service, as an SMS or a phone call to the recipient’s phone.
The configuration is fast and easy – it should take about five to ten minutes to have it up and running. Generate an API token in SMSEagle, edit Netdata’s health_alarm_notify.conf, and you’re done.
SMSEagle sends Netdata alerts as an SMS, a ring-only call or a call that reads the alert aloud, all from a single device.
On devices with two SIM cards from different operators, SMSEagle switches to the second one when the first operator’s network is down.
Two SMSEagle devices can work as an HA cluster: if one fails, the other takes over sending.
Before using the API, you’ll need to enable API access on your SMSEagle device by following these steps:
The configuration file name for this integration is health_alarm_notify.conf.
You can edit the configuration file using the edit-config script from the Netdata config directory.
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config health_alarm_notify.conf
The following options can be defined for this notification.
| Name | Description | Default | Required |
|---|---|---|---|
| DEFAULT_RECIPIENT_SMSEAGLE | If a role’s recipients are not configured, a notification will be sent to this SMS recipient (empty = do not send a notification for unconfigured roles). Multiple recipients can be given like this: “PHONE1,PHONE2…” | yes | |
| SMSEAGLE_API_URL | yes | ||
| SMSEAGLE_API_ACCESSTOKEN | yes | ||
| SMSEAGLE_MSG_TYPE | sms | yes | |
| SMSEAGLE_CALL_DURATION | 10 | yes | |
| SMSEAGLE_VOICE_ID | 10 | yes |
All roles will default to this variable if left unconfigured.
You can then have different recipients per role, by editing DEFAULT_RECIPIENT_SMSEAGLE with the number you want, in the following entries at the bottom of the same file:
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"
The url of the SMSEagle device accessible from NetData, e.g https://192.168.0.101
An access token for the user created at SMSEagle device
Choose a type of message/call. Available types: sms, mms, ring (wake-up call), tts (text-to-speech call), tts_advanced (multilanguage text-to-speech call). Be aware that some types require additional parameters to be set.
Call duration, parameter required for Ring, TTS and TTS Advanced.
ID of the voice model, required for TTS Advanced.
#------------------------------------------------------------------------------
# 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"
# 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"
Note that this will test all alert mechanisms for the selected role.
SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.
After registering to a demo you get a remote access to our physical device NXS-9750.
