SYNOPSISnagios-stat [OPTION] check server
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.
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.
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.
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.
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.
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.
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.
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.
Enables output of nagios performance data.
Port to connect to on remote nagios-statd(8) server.
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.
Gives verbose output for checks. Currently, it causes the disk check to always print out utilization information.
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.
Output version information and exit.
Print short option information and exit.
CHECKSdisk (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.
(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).
(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.
(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.
(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 - .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.
EXAMPLESCheck 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 CODESTo 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)
BUGSThere 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.
AUTHORApril King http://www.twoevils.org
E-mail: april at twoevils dot org
COPYRIGHTCopyright (C) 2002-2005 April King.
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.