SysUsage v2.6 - System Monitoring Tool


DESCRIPTION

SysUsage is a tool used to continuously monitor a system
and generate daily/weekly/monthly yearly graphical report
using rrdtool and sar.

It can report the following statistics:

	- Load average.
	- CPUs usage. (total, system, user, iowait, idle, steal)
	- Memory usage (with and without cache).
	- Share memory usage (POSIX /dev/shm).
	- Swap usage.
	- Page swapping.
	- Page I/O stats.
	- R/W request stats.
	- R/W block stats.
	- Created process per second.
	- Percentage of open file regarding to file-max.
	- Number of socket in use. With TCP versus UDP.
	- Any active network interface usage.
	- Errors on network interface (bad packet, dropping, collision.
	- Any mounted partition disk space usage.
	- Monitoring running process.
	- Monitoring number of file in queue directory.

You can choose which process or queue to monitor. Multiple
of each are allowed.

You can have mail report when certain monitored values are outside
max/min threshold values for all type of monitoring.


INSTALLATION

See INSTALL file.


CONFIGURATION

See INSTALL file.


USAGE

Once you have correctly installed and configured SysUsage the best
way to run it is by croni job. As it is very fast you can set running
time each minute. This is the default interval used in the graph
report tool sysusagegraph. So I recommand you to do so or to
modify this script to match you interval.

Here is how I use it with an installation with all path by default :

*/1 * * * * /INSTALL_DIR/sysusage
*/5 * * * * /INSTALL_DIR/sysusagegraph

If you have change the default installation path (/usr/local/sysusage)
you need to give these script the path to the configuration into the
command line argument using -c option. To know what arguments can be
passed use option -h or --help.

ALARMS

Sysusage use an external perl script to send SMTP alert 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:

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 curr_value  : Current value monitored by sysusage.
        -v thres_value : Threshold value used.
        -s smtp_srv    : SMTP server name or ip address where to send email.
        -f from        : Sender email address of the alarm message.
        -d to          : Email address of the recipient of the alarm message.
        -b host_bin    : Path to program hostname. Default is /bin/hostname.
        -h             : Output this message and exit

When you have set all things correctly and it is running for some minutes
take your favorite browser and take a look !


BUGS

Please report any bugs to <gilles@darold.net>

LICENCE

Copyright (C) 2003-2007 Gilles Darold - Groupe SAMSE

This program is provided WITHOUT WARRANTY of any kind, either
expressed or implied. It is free software, and you are welcome
to modify or re-distribute it under same terms of Perl itself.

AUTHOR

Gilles Darold <gilles@darold.net>
