Archived community.zenoss.org | full text search
Skip navigation
Currently Being Moderated

How to send Zenoss alerts by SMS or voice call

VERSION 3  Click to view document history
Created on: Oct 19, 2010 7:47 AM by bob.sauvage - Last Modified:  May 4, 2011 6:03 AM by bob.sauvage

I found a very simple solution to achieve this ! TeamTILT for Zenoss ! (www.teamtilt.com)

 

The TeamTILT client for Zenoss is a light Java application that enables the relaying of your Zenoss notifications to the TeamTILT platform. The alert can then be sent to multiple media types, SMS, voice call, email or iPhone push notification, without any additional hardware !

 

This application is without any contract. Email and iPhone push alerts are  free of charge. Buy SMS and Voice alerts credits as you need them.


The prices are correct, here the price list (1 credit = 1 SMS or Voice call) :

 

TeamTILT for Zenoss200 alert units32,00 Eur
TeamTILT for Zenoss1.000 alert units130,00 Eur
TeamTILT for Zenoss5.000 alert units550,00 Eur

 

In addition, you have a very nice heartbeat function ! The heartbeat feature guarantees an ongoing connectivity check between  the TeamTILT client and TeamTILT servers. Receive an alert directly from  TeamTILT in case of a connectivity loss.

 

This guide is based on a distribution like RedHat/Fedora. If you use a  distribution like Debian/Ubuntu, do not set yourself as root. Use  instead the sudo command before launching all commands.

 

1. To start, set yourself as root user to install the client :

1.su -

 

2. Unpack the archive containing the the installer folder :

 

1.tar xzvf TeamTILTClientForZenoss_CL_JRE_32.tar.gz
2.tar xzvf TeamTILTClientForZenoss_CL_JRE_64.tar.gz

 

3.  A directory named « TeamTILTForZenoss » will be created and the owner  of this directory set to Zenoss. The client will later be run as Zenoss  user. If you have no Zenoss user defined, the client will be run as root  user.

 

4. Download the file named 'License.txt' : Connect to the  TeamTILT web interface and click on "TeamTILT with 3rd party". Then move  this file to the TeamTILT installation directory and change the owner  to Zenoss.

 

1.cd TeamTILTForZenoss/
2.mv /home/login/Download/License.txt .
3.chown nagios: License.txt

NOTE: several possibilities for you to download the license file. Either via wget or via the scp command. Do not hesitate to contact support if you experience difficulties.

 

5. Change the current directory to the newly created one and start the « runTeamTILT.sh » script :

1../runTeamTILT.sh

NOTE: If  you receive an error like "zenoss user doesn't have an appropriate  connection shell.", just add a bash shell to the zenoss user. Edit the  file "/etc/passwd", find the line beginning with "zenoss". On this line, change "/bin/nologin" with "/bin/bash".

 

6.  You can find our terms and conditions in this directory, open the file named « Licence-TeamTILTClientForZenoss.txt ».

 

7. A communication test between the client and the TeamTILT platform will be performed to verify the connectivity.

 

NOTE: The port 80 must be opened to the internet !

 

8.  The client will check if you have the latest version of the client, and  offer the possibility to download it shouldn’t it be the case.
9. After the account creation, the client is started and a cron task is added to restart the client if a problem occurs.

1.crontab –e –u zenoss
# --------- TEAMTILT CLIENT START ---------
# Added by Nagios at Thu Jul 29 14:53:23 CEST 2010
*/5 * * * */usr/local/TeamTILTforZenoss/ClientManager/sh_scripts/startTTService.sh/usr/local/TeamTILTforZenoss >>
usr/local/TeamTILTforZenoss/ClientCommunication/logs/TeamTILT_ClientCommunication.log
# --------- TEAMTILT CLIENT END ---------

 

10. Indicate the correct Zenoss initialization scipts path (default  paths are provided). A directory "eventfiles" must be created, it stores  the alerts before sending.

 

11. The client installation is now finished.

 

ZENOSS CONFIGURATION

 

1. Go to the Zenoss web interface, we will add a new notification command:

 

01.Click on Events - Event Manager - Commands
02.Name it "TeamTILT_Notification" and click on Add
03.Command:  /usr/bin/printf "Destination: AllContacts \nSubject: **Severity:  ${evt/severity} for ${evt/component} on ${evt/device} **\nBody:  ${evt/summary} on ${evt/device} at ${evt/firstTime}.\n\n" > `mktemp  -p /usr/local/TeamTILTforZenoss/eventfiles/ zenosseventfile_XXXXXXXXX`
04.Clear  Command: /usr/bin/printf "Destination: AllContacts \nSubject: **CLEAR  ${evt/component} on ${evt/device} **\nBody: ${evt/summary} on  ${evt/device} at ${evt/firstTime}.\n\n" > `mktemp -p  /usr/local/TeamTILTforZenoss/eventfiles/ zenosseventfile_XXXXXXXXX`
05.Where: - Add filter
06.Production state >= Production
07.Severity > Info
08.Event State = New
09.Set the option "enabled" to True

 

IMPORTANT

*  It is important that this command line has no carriage return in it  (just do a copy&paste of the above) and that the "notification"  option is checked.

*  Insert the path to "eventfiles" directory as  configured during the installation procedure (step 2). It must be the  same for the two notification commands (mktemp -p xxx). If unsure, check  in the /ClientManager/data/teamTILTclient.properties, in the 'zenoss  output file path settings' for something like  'zenoss.outputfile.path=/tmp/eventfiles'. You can of course set the  'where' according to your own needs. In the example above, the  notification will be triggered in case of a new event from a device in  'production' state and having a severity higher than info.

 

2. Click on "save" to save the modification.

 

3. The configuration is now complete. Go to http://www.teamtilt.net

and login using the email address (login) and the password provided during the client installation.

 

4. By  default, alerts are sent to all contacts. If you want to modifiy this  behavior, see article "Send alerts to specific contact groups".

 

5. Search your contact and configure a telephone number for voice calls and the SMS messages.

 

6.  Deactivate a service on your monitored server and test if you will  receive an alert on your phone. In the TeamTILT web interface, click on  the « Action history » button to see a list of all alerts that were  generated.

 

 

You can find any additional informations here :


www.teamtilt.com

www.teamtilt.com/BLOG


Comments (1)

More Like This

  • Retrieving data ...

More by bob.sauvage