debian man page for torrus_action_notify

Query: torrus_action_notify

OS: debian

Section: 7

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

TORRUS_ACTION_NOTIFY(7) 					      torrus						   TORRUS_ACTION_NOTIFY(7)

NAME
action_notify - Generic notification handler for Torrus monitor
SYNOPSIS
<action name="notify"> <param name="action-type" value="exec" /> <param name="command"> $TORRUS_BIN/action_notify </param> <param name="launch-when" value="set" /> </action>
DESCRIPTION
This program is designed for usage from a monitor action only. It takes the arguments from environment variables, as described in action- type "exec" in Torrus XML Configuration Guide. The handler reads its configuration from <notify-siteconfig.pl>, a small Perl file which defines the notification paths for various conditions. Example: %Torrus::Notify::programs = ( 'mailto' => '$TORRUS_BIN/action_printemail | /usr/bin/mail $ARG1', 'page' => '/usr/bin/echo $TORRUS_NODEPATH:$TORRUS_MONITOR ' . '>> /tmp/monitor.$ARG1.log' ); %Torrus::Notify::policies = ( 'CUST_A' => { 'match' => sub { $ENV{'TORRUS_P_notify_policy'} eq 'A' }, 'severity' => { '3' => [ 'mailto:aaa@domain.com', 'mailto:bbb@domain.com' ], '5' => [ 'page:1234', 'mailto:boss@domain.com' ] } } ); In this example, we define two message handlers: e-mail sender and a dummy replacement for a pager program. Then we define the notification policies. For the customer A, we define the policy so that the parameter "notify-policy" should match the name "A". The parameter is defined in the datasource tree and marks only those leaves that belong to this customer. Then, depending on the monitor severity, different notification paths are defined. For severity values higher or equal 3, aaa@domain.com and bbb@domain.com will receive the email notifications, and for severity higher than or equal 5 all recipients will receive the notification. The "match" argument is a Perl subroutine, and can depend on various parameters, such as time of day or day of the week, the tree name, and so on.
FILES
/etc/torrus/conf/notify-siteconfig.pl Notification policies configuration
SEE ALSO
torrus(8)
NOTES
See more documentation at Torrus home page: http://torrus.org
AUTHOR
Stanislav Sinyagin <ssinyagin@yahoo.com> torrus 2.03 2013-07-26 TORRUS_ACTION_NOTIFY(7)
Related Man Pages
torrus_action_printemail(7) - debian
torrus_action_snmptrap(7) - debian
torrus_collector(8) - debian
torrus_devdiscover(8) - debian
torrus_snmpfailures(8) - debian
Similar Topics in the Unix Linux Community
how to get filename from directory
Adding one string at the beginning of each line in a file
using nawk
How to grep the words with space between?
Several exec on find send all the output to the last redirection