SysUsage v2.10 - 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.
	- Hard drive temperature monitoring if your hardward support it.
	- MotherBoard/CPU/Remote temperature reported by sensors.
	- Fan RPM reported by sensors.
	- CPU usage per device.
	- Amount of memory need for current workload.

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

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

You can now send nagios report message through the nsca client.

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 cron 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 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 smtp_srv : SMTP server name or ip where to send email. Default localhost
 -f from : Sender email address of the alarm message. Default root@localhost
 -d to : Destination email address the alarm message. Default root@localhost
 -b path : Path to program hostname. Default is /bin/hostname
 -n path  : Path to Nagios program submit_check_result. Default is none. 
 -l value : Alarm level type (0=OK,1=WARNING,2=CRITICAL,3=UNKNOWN). Default: 1. 
 -r service : Nagios service name to used. Must be any sysusage type of
              monitoring defined in the configuration file.
 -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 _|_At_|_ darold _|_DoT_|_ net>

LICENCE

Copyright (C) 2003-2009 Gilles Darold

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 _|_At_|_ darold _|_DoT_|_ net>
