NAME

nagios-stat - nagios-statd client

SYNOPSIS

nagios-stat [OPTION] check server

DESCRIPTION

nagios-stat (nagios-stat client) is the client program for nagios-statd(8). These programs together comprise a systems monitoring tool for various platforms. It is designed to be integrated with the Nagios monitoring tool, although this is not a requirement.

nagios-stat is the client that connects to the nagios-statd server. It then sends the daemon which check it wants to run, parses the data, prints a result, and then exits appropriately.

OPTIONS

-c, --critical=LEVEL
LEVEL is the what level of data will cause the client program to exit with a critical error. The defaults are dependent upon the check below, and are documented below.

-d, --disk=DISK
A specific disk to check when running the disk check. It is only valid for this check, and will be ignored for all other checks.

-D, --ignoredisk=DISK
A comma delimited list of disks (device names) to ignore when running the disk check. It is only valid for this check, and will be ignored for all other checks.

-l, --lt
Reverse how the proc check exits on criticality and warnings. Instead of going critical/warning when the number of processes is greater than -c/-w, it now goes critical/warning when the number of processes is less than -c/-w.

-m, --mount=MOUNT
A specific mount point to check when running the disk check. It is only valid for this check, and will be ignored for all other checks.

-M, --ignoremount=MOUNT
A comma delimited list of mount points to ignore when running the disk check. It is only valid for this check, and will be ignored for all other checks.

-n, --processname=NAME
Name of a specific process to check for when running the proc check. It is only valid for this check, and will be ignored for all other checks.

-P, --perfdata
Enables output of nagios performance data.

-p, --port=PORT
Port to connect to on remote nagios-statd(8) server.

-s, --state=STATE
Process states to check for (such as ZW, or just Z, etc.) when running the proc check. It is only valid for this check, and will be ignored for all other checks.

-v, --verbose
Gives verbose output for checks. Currently, it causes the disk check to always print out utilization information.

-w, -warning=LEVEL
LEVEL is the what level of data will cause the client program to exit with a warning error. The defaults are dependent upon the check below, and are documented below.

-V, --version
Output version information and exit.

-x, --debug
Prints out raw data that nagios-stat(1) receives from the nagios-statd(8) server. Useful for debugging connection issues.

-h, --help
Print short option information and exit.

CHECKS

disk (warning: 90%; critical: 95%)
The disk check allows you to check to see if a disks' utilization is above a specified percentage. You can use the -d/-m to check a specific disk/mount, or you can use the -D/-M options to ignore certain disks/mount points (like /cdrom). By default, the disk check will check all disks on a machine. Note that -d/-m and (-D/-M) are exclusive options, although -D and -M are not. Also, if you specify a disk/mount and it isn't found, then nagios-stat(1) will exit at a critical level.

load (warning: 2; critical: 5)
The load check allows you to check to see if a machines' load average is above a specified 5-minute load average).

proc (warning: 100; critical: 200) / (warning: -1; critical: 1 if using -l/--lt)
The proc check allows you to check to see if a machine is running more than the specified number of processes. You can use the -s option to restrict the results to processes running in a specified state. Be warned: Using the -s check with a state that the process check will run in may result in an off-by-one error. There is no workable way to fix this. You can also use the -n option to only look at certain processes as they appear in the process table. This matches the beginning of the processes name, so -n ora would match "oracle", "orablob", and "orafreep -n". Interpreted programs often find their command line modified (especially in Linux). For example, running "./foo.pl" will result in a process name of "/usr/bin/perl ./foo.pl". An easy solution (in Perl, for example) is to add "$0 = $0;" at the beginning of your programs.

swap (warning: 75%; critical: 90%)
The swap check allows you to check to see if a machines' swap utilization is above a specified percentage. Due to the difficulty of ascertaining this information, your platform may not be supported for this check.

user (warning: 20; critical: 30)
The user check allows you to check to see if more than a specified number of users are currently logged in.

version (warning: nagios-stat(1) version - .01; critical: none)
The version check allows you to check what version of nagios-statd(8) that the remote server is running. This is useful for organizations that are running a large quantity of servers to make sure they are always up-to-date.

EXAMPLES

Check to see if /dev/hda is under 60%/80% full on server.domain.net:

nagios-stat -d /dev/hda -w 60 -c 80 disk server.domain.net

Check to see if all mounts except /cdrom and /tmp are under 75%/85% full:

nagios-stat -M /cdrom,/tmp -w 75 -c 85 disk server.domain.net

Check to see if the load average is below 2.5/10:

nagios-stat -w 2.5 -c 10 load server.domain.net

Check and warn if load is above 1 (only):

nagios-stat -w 1 -c 10000 load server.domain.net

Check to see if there are more than 5/10 zombie processes:

nagios-stat -w 5 -c 10 -s Z proc server.domain.net

Check and critical if more than 20 Z or N or W processes:

nagios-stat -w 10000 -c 20 -s NWZ proc server.domain.net

Check to see if cron is running - critical if it isn't:

nagios-stat -l -n '/usr/sbin/cron' proc server.domain.net

Check 'oracle' processes running, critical if less than 3, warn less than 5:

nagios-stat -l -n 'oracle' -c 3 -w 5 proc server.domain.net

Check if swap utilization is above 50%/75%:

nagios-stat -w 50 -c 75 swap server.domain.net

Check to see if there are more than 250/500 users connected:

nagios-stat -w 250 -c 500 user server.domain.net

Check and critical if server is running nagios-statd 3.05 or lower:

nagios-stat -w 10000 -c 3.05 version server.domain.net

EXIT CODES

To comply with Nagios specifications, the following exit codes are used:
0 : OK
1 : Warning
2 : Critical
3 : Invalid command line options, unable to check status (Unknown)

BUGS

There is a general lack of feedback for the more obscure platforms. As such their behavior might not always be particularly deterministic. Feedback is always welcome. Redhat Linux contains Python 1.x as /usr/bin/python. This program requires Python 2.x to function. Either change the shebang at the top of the program to point to /usr/bin/python2, or change /usr/bin/python to be Python 2.x.

AUTHOR

April King http://www.twoevils.org
E-mail: april at twoevils dot org

COPYRIGHT

This is free software, there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. This program is licensed under the BSD license. More information is available in the LICENSE file included with this program.

Nagios is a trademark of Ethan Galstad.