GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TORRUS_ACTION_NOTIFY (7)

.ds Aq ’

NAME

action_notify - Generic notification handler for Torrus monitor

CONTENTS

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

/usr/local/etc/torrus/conf/notify-siteconfig.pl Notification policies configuration

SEE ALSO

torrus(1)

NOTES

See more documentation at Torrus home page: http://torrus.org

AUTHOR

Stanislav Sinyagin <ssinyagin@yahoo.com>
Search for    or go to Top of page |  Section 7 |  Main Index


torrus 2.07 TORRUS_ACTION_NOTIFY (7) 2016-04-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.