Threshold notification

SMTP alert

Sysusage use an external perl script to send SMTP alert and/or Nagios checks when a max or min threshold is reached. This program is named sysusagewarn. All options of the configuration file in section [ALARM] are use by sysusage to call this program. If they are correctly set you don't have to take care of the parameters given to this program. If you want to use this program outside sysusage, here are the command line options it understand:

        Usage: sysusagewarn -t subject -c current_value -v threshold_value
                        [-s smtp_srv] [-f from] [-d to] [-b hostname_prog]

        -t subject : Subject of the alarm
        -c value   : Current value monitored by sysusage.pl
        -v value   : Threshold value used.
        -s host    : SMTP server name or ip where to send email.
        -f from    : Sender email address of the alarm message.
        -d to      : Destination address of the alarm message.
        -b path    : Path to program hostname. Default is /bin/hostname
        -n path    : Path to Nagios program submit_check_result. Default none. 
        -l value   : Alarm level (0=OK,1=WARNING,2=CRITICAL). Default: 1. 
        -r service : Nagios service name to used. Must be any sysusage type of
                     monitoring defined in the configuration file.
        -u url     : Url to HTML sysusage output to include in email.
                     Default: http://hostname.domain/sysusage/
        -h         : Output this message and exit

NAGIOS alert

SysUsage send check message to Nagios through an external command (submit_check_result). So you need to create the host and associate all sysusage service that you want to monitor with Nagios. The services name correspond to the type of monitoring. For example, if you have enable alarm on memory usage the service sent is 'mem'. There's also specials case with type of monitoring with multiple instance like network monitoring. You need to create a service per instance. For example type 'net' will have 'net_eth0' and 'net_lo' and more if you have more network interface. To see if your sysusage alarm messages are well understood by Nagios take a look at the nagios.log file (default to /usr/local/nagios/var/nagios.log).

To desactivate automatically an alarm reported to Nagios, SysUsage will send each time it run an OK request if every thing is correct for the monitored type.