Wirehive Nagios Plugins

This repository is a set of Nagios plugins that have been either built from scratch or improved by Wirehive. At Wirehive we make heavy use of the Nagios Core product in the core of our monitoring platform. This by no means represents the entirety of the plugins we use, however we will release mroe as the become tidy and fit for consumption :)

check_memcached

Sets and retrieves a value from a memcached instance to test both availability and responsiveness. Requires netcat to be installed.

define command{
        command_name check_memcached
        command_line $USER1$/check_memcached -H $HOSTADDRESS$
}

check_domain

Check the expiration on a domain name. We use this as the check_command with a special host template specifically for domains.

define command{
        command_name check_domain
        command_line $USER1$/check_domain -d $HOSTADDRESS$
}

define host{
        name                            domain
        use                             generic-host
        check_period                    24x7
        check_interval                  10   #Check every 10 minutes
        retry_interval                  1
        max_check_attempts              3
        check_command                   check_domain
        notification_period             24x7
        notification_interval           240
        notification_options            d,r
        contact_groups                  admins
        register                        0
}

send_android

This is used in conjunction with the Notify My Android app (http://www.notifymyandroid.com/). You will need a developer key from them. Example given of use on a contact.

define command{
        command_name notify-host-by-android
        command_line $USER1$/send_android -d $ARG1$ -f "Wirehive Monitoring" -H "$HOSTNAME$" -S $HOSTSTATE$ -p 2
}

define command{
        command_name notify-service-by-android
        command_line $USER1$/send_android -d $ARG1$ -f "Wirehive Monitoring" -s $SERVICESTATE$ -H "$HOSTNAME$" -D $SERVICEDESC$ -p 2
}

define contact{
        contact_name                    simonANDROID
        use                             generic-contact
        alias                           Simon Green NMA
        service_notification_options    c
        host_notification_options       d,u
        service_notification_commands   notify-service-by-android!USERS-NMA-KEY
        host_notification_commands      notify-host-by-android!USERS-NMA-KEY
}

send_irc

Used in conjunction with irccat (https://github.com/Wirehive/irccat) to send a message to an IRC channel. We add on the unusual flapping and maintenance window notifications to the contact as well.

define command{
        command_name    notify-host-by-irc
        command_line    $USER1$/send_irc -H "$HOSTNAME$" -a "$HOSTALIAS$" -S "$HOSTSTATE$" -O "$HOSTOUTPUT$" -t "$NOTIFICATIONTYPE$"
}

define command{
        command_name    notify-service-by-irc
        command_line    $USER1$/send_irc -s "$SERVICESTATE$" -H "$HOSTNAME$" -a "$HOSTALIAS$" -S "$HOSTSTATE$" -D "$SERVICEDESC$" -O "$SERVICEOUTPUT$" -t "$NOTIFICATIONTYPE$"
}

define contact{
        contact_name                    irc
        alias                           IRC
        service_notification_period     24x7
        host_notification_period        24x7
        service_notification_options    w,u,c,r,f
        host_notification_options       d,u,r,s,f
        service_notification_commands   notify-service-by-irc
        host_notification_commands      notify-host-by-irc
}

send_prowl

Sends a push notification via the iOS app Prowl (http://www.prowlapp.com/) for notifying Apple iDevices

define command{
        command_name notify-host-by-prowl
        command_line $USER1$/send_prowl -d $ARG1$ -f "Monitoring" -H "$HOSTNAME$" -S $HOSTSTATE$ -P YourProviderKey -p 2
}

define command{
        command_name notify-service-by-prowl
        command_line $USER1$/send_prowl -d $ARG1$ -f "Monitoring" -s $SERVICESTATE$ -H "$HOSTNAME$" -D $SERVICEDESC$ -P YourProviderKey -p 2
}

define contact{
        contact_name                    simonProwl
        use                             prowl-contact
        alias                           Simon Green Prowl
        service_notification_options    c
        host_notification_options       d,u
        service_notification_commands   notify-service-by-prowl!YourRecipientKey
        host_notification_commands      notify-host-by-prowl!YourRecipientKey
}

send_twilio_sms

Sends an SMS via Twilio. Mobile number should be entered with country code, eg +44123412345678

define contact{
        contact_name                    simonSMS
        use                             sms-contact
        alias                           Simon Green SMS
        service_notification_options    c
        host_notification_options       d,u
        service_notification_commands   notify-service-by-sms!+441234123456
        host_notification_commands      notify-host-by-sms!+441234123456
}

define command{
        command_name notify-host-by-sms
        command_line $USER1$/send_twilio_sms -d $ARG1$ -H $HOSTNAME$ -S $HOSTSTATE$ -O "$HOSTOUTPUT$"
}
define command{
        command_name notify-service-by-sms
        command_line $USER1$/send_twilio_sms -d $ARG1$ -s $SERVICESTATE$ -H "$HOSTNAME$" -D $SERVICEDESC$ -O "$SERVICEOUTPUT$"
}

send_twilio_phone

Sends a text to speech notification to a PSTN phone number via Twilio.

1. Create a /phonealerts web route on your Nagios server for Twilio to hit with a callback.

   $ mkdir /var/www/phonealerts

2. Update the base settings in the send_twilio_phone script. Set CALLBACKURL to the new phonealerts route on your Nagios server.

   CALLBACKURL="http://nagios.acme.com/phonealerts"

3. Set CALLBACKPATH to the DocumentRoot location of your phonealerts route.

   CALLBACKPATH="/var/www/phonealerts"

4. Set the Twilio Account SID and Auth Token found in your account settings.

   TWIMLSID="TWILIO-ACCOUNT-SID"
   TWIMLTOKEN="TWILIO-AUTH-TOKEN"

define contact{
        contact_name                    simonPhone
        use                             phone-contact
        alias                           Simon Green Phone
        service_notification_options    c
        host_notification_options       d,u
        service_notification_commands   notify-service-by-phone!+441234123456
        host_notification_commands      notify-host-by-phone!+441234123456
}

define command{
        command_name notify-host-by-phone
        command_line $USER1$/send_twilio_phone -d $ARG1$ -H $HOSTNAME$ -S $HOSTSTATE$ -O "$HOSTOUTPUT$"
}

define command{
        command_name notify-service-by-phone
        command_line $USER1$/send_twilio_phone -d $ARG1$ -s $SERVICESTATE$ -H "$HOSTNAME$" -D $SERVICEDESC$ -O "$SERVICEOUTPUT$"
}

Check SNMP time in UTC

Checks remote server time in UTC and compares to local system time in UTC

define command{
        command_name snmp_remote_time_utc
        command_line $USER1$/snmp_remote_time_utc -H $HOSTADDRESS$ -C $ARG1$ -w $ARG2$ -c $ARG3$
}