Zabbix sms alerts – integration manual

Here we describe how to use SMSEagle for Zabbix SMS alerts. The configuration is very straightforward – it should take you about 5 min to have it up and running.

SMSEagle is an offline hardware SMS gateway. Therefore no external connection to 3rd party system is required. All notifications are generated on-premise and sent directly to a cellular network. This solution can be used in secure installations without Internet access.

SMSEagle Setup

Create a new user for this script in SMSEagle.

Zabbix Setup

1. Download latest version of Zabbix script from our repository: https://bitbucket.org/proximus/smseagle-zabbix

2. Edit following lines in the script:

//Set the following three values:
$smseagle_ip     = "192.168.0.102";
$login           = "smseagleuser";
$password        = "smseaglepassword";

3. Put the script in the directory, you specified in the zabbix_server.conf, key AlertScriptsPath:
Location for custom alert scripts AlertScriptsPath=/etc/zabbix/alertscripts</code> and ensure that it’s executable (chmod 755 cli_smseagle.php).

4. Test the script, by running:
./cli_smseagle.php 0048123456789 “Test message”

After a few seconds, you should receive an SMS.

5. In Zabbix goto Administration > Media Types > Add a new media. Fill in required fields:

• Name “SMS via smseagle” (or any other description)
• Type “Script”
• Script name “cli_smseagle.php”
• Script parameters: add parameters  {ALERT.SENDTO} and {ALERT.MESSAGE}
• check “Enabled”

6. Finally, in Zabbix, Administration, Users, click on a user, and add a new media called “SMS via smseagle”. Enter destination phone number, and press Save.

Zabbix Template (Optional)

If you would like to add a ready-to-use Zabbix template for monitoring your SMSEagle device in Zabbix:

1. Download the yaml template file from the repository: https://bitbucket.org/proximus/smseagle-zabbix/downloads/
2. Import the template file to Zabbix:  menu Configuration > Templates > Import.
3. Assign the template to your device in Zabbix.