Home Directory Plugins Notifications SMSEagle SMS Notification Plugin

Search Exchange

Search All Sites

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com

Login

Remember Me

SMSEagle SMS Notification Plugin

Current Version
1.0
Last Release Date
2013-02-21
Compatible With
  • Nagios 2.x
  • Nagios 3.x
  • Nagios XI
License
BSD
Hits
3954
Files:
FileDescription
smseagle_nagios_plugin.tar.gzsmseagle_nagios_plugin.tar.gz
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
This plugin allows to send SMS notifications from Nagios to your mobile phone using SMSEagle (http://www.smseagle.eu). SMSEagle is a hardware SMS gateway for IT professionals. Using it with Nagios allows to send SMS alerts on host or service breakdowns. The device sends SMS messages directly to GSM network, thus making you independent from 3rd party services (or broken Internet connection). SMSEagle has extended SNMP capabilities, that allow monitoring device status, GSM signal, SMS sending queue, sending errors, etc. directly from Nagios. The device is designed with focus on reliability and stability. It has a Linux on-board, modern responsive web-interface, database backend, and built-in GSM modem with fail-over mechanisms (based on software watchdog).
Plugin for Nagios to send SMS Text Message notifications with SMSEagle - hardware sms gateway.


This plugin setup should take about 5 minutes.


SMSEAGLE SETUP

Create a new user for this script in SMSEagle.
This user will be referenced below as: SMSEAGLEUSER and SMSEAGLEPASSWORD
Replace SMSEAGLEUSER and SMSEAGLEPASSWORD in script below with your values.



NAGIOS SETUP

1. Create the SMS notification commands. (Commonly found in commands.cfg)
Replace SMSEAGLEIP with IP Address of your SMSEagle device.
Replace SMSEAGLEUSER and SMSEAGLEPASSWORD with your user/password to SMSEagle.

Define two commands:

define command {
command_name notify-by-sms
command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEIP -u SMSEAGLEUSER -p SMSEAGLEPASSWORD -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($SERVICEOUTPUT$) Date($SHORTDATETIME$)"
}

define command {
command_name host-notify-by-sms
command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEIP -u SMSEAGLEUSER -p SMSEAGLEPASSWORD -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
}


2. In your nagios contacts (Commonly found on contacts.cfg) add
the contact. Field "pager" should contain a mobile number for sms alerts in
full international format e.g. 48xxxxxxxxx

define contact {
contact_name engineer
alias Support Engineer
service_notification_period 24x7
host_notification_period 24x7
service_notification_options w,u,c,r
host_notification_options d,u,r
service_notification_commands notify-by-email,notify-by-sms
host_notification_commands host-notify-by-email,host-notify-by-sms
email engineer@somedomain.com
pager 48xxxxxxxx
}

That's it!

Notice for Nagios XI users: If you encounter perl error, please add the path to the perl executable at the start of the command in Nagios.