Send sms by gateway¶

Shinken can be used to send sms to you and other people when you got an alert.

I will tell you how to do it with ovh gateway. If you need for another one you need to modify a little bit the information.

1. you need to go to your contact file which is for linux in /etc/shinken/contacts/¶

For each user you need to add her phone number in the pager line. (For ovh you need to do it with 0032 for example and not +32 , all phone number must be with the international prefix).

In the same file you need also to add these lines in each contact you want that I receive ams.

host_notifications_enabled      1                    // This will activate the notifications for the hosts
notificationways SMS                                 // This is the name of your notifications ways ( You can write what you want but remember what you set )


Then you need to add this at the end of the contacts.cfg

define notificationway{
notificationway_name            SMS           // Here you need to put the name of the notifications ways you write up
service_notification_period     24x7          // Here I will receive ams all the time, If you want to receive them for only the night replace 24x7 by night.
host_notification_period        24x7          // Same as above
service_notification_options    w,c,r         // It tell that I want receive a sms for the hosts who are in warning / critical / recovery
host_notification_options         d,r          // It tell that I want receive a sms for the services who are down and recovery
}


2. you need to go to your commands file which is in /etc/shinken/commands/¶

And add these line at the end.

# Notify Service by SMS-OVH
define command {
command_name        notify-service-by-ovhsms     // Should be the same as in the contacts.cfg
command_line        $PLUGINSDIR$/ovhsms.sh  $CONTACTPAGER$ $NOTIFICATIONTYPE$ $SERVICEDESC$ $HOSTNAME$ $SE$ // Tell which script shinken as to use to send sms. We will create it after.
}

# Notify host by SMS-OVH
define command {
command_name        notify-host-by-ovhsms      * * Should be the same as in the contacts.cfg
command_line        $PLUGINSDIR$/ovhsms.sh $CONTACTPAGER$ $NOTIFICATIONTYPE$ $SERVICEDESC$ $HOSTNAME$ $SER$ // Tell which script shinken as to use to send sms. We will create it after.
}


First you need to be the shinken user so do a : su shinken do a : cd /var/lib/shinken/libexec/ and then create and edit your new script with the name you set above : nano -w ovhsms.sh

#!/bin/bash

date > ~/datesms

NOTIFICATIONTYPE=$2 HOSTALIAS=$3
SERVICEDESC=$4 SERVICESTATE=$5
textesms="**"$NOTIFICATIONTYPE" alerte - "$HOSTALIAS"/"$SERVICEDESC" is "$SERVICESTATE" **" // This is the message who will be send. You can add something if you want.
wget -o ~/logenvoisms -O ~/response "https://www.ovh.com/cgi-bin/sms/http2sms.cgi?smsAccount=sms-XXXXXXXX-1&login=XXXXXXXX&password=XXXXXXXX&from=XXXXXXXXXXX&to=$1&contentType=text/xml&message=$textesms"     // This is the command who will send the sms. You need to adapt it with you gateway settings.

exit 0


4. Test It¶

Save your file and do : “exit” To exit the shinken user. Then set down one of your host or service to test if you receive it.

Versions
latest
documentation
PDF
HTML
Epub
Project Home
Builds

Free document hosting provided by Read the Docs.