Default Nagios Check Commands
July 12th, 2009
These are specified in the $NAGIOSHOME/etc/checkcommands.cfg file. Where there are parameters available for a command, these can be passed through from services.cfg.
Configuring nagios commands
Configure nagios commands
In a standard install of nagios, from platform independent source files there are the following check commands/plugins installed by default:-
| check_by_ssh | check_load | check_ping | check_time |
check_by_ssh
This plugin will execute a command on a remote host using SSH
Usage:
check_by_ssh [-f46] [-t timeout] [-i identity] [-l user] -H <host> -C <command>
[-n name] [-s servicelist] [-O outputfile] [-p port]
check_by_ssh -V prints version info
check_by_ssh -h prints more detailed help
Options:
-H, --hostname=HOST
name or IP address of remote host
-C, --command='COMMAND STRING'
command to execute on the remote machine
-f tells ssh to fork rather than create a tty
-t, --timeout=INTEGER
specify timeout (default: 10 seconds) [optional]
-p, --port=PORT
port to connect to on remote system [optional]
-l, --logname=USERNAME
SSH user name on remote host [optional]
-i, --identity=KEYFILE
identity of an authorized key [optional]
-O, --output=FILE
external command file for nagios [optional]
-s, --services=LIST
list of nagios service names, separated by ':' [optional]
-n, --name=NAME
short name of host in nagios configuration [optional]
-4, --use-ipv4
tell ssh to use IPv4
-6, --use-ipv6
tell ssh to use IPv6
The most common mode of use is to refer to a local identity file with
the '-i' option. In this mode, the identity pair should have a null
passphrase and the public key should be listed in the authorized_keys
file of the remote host. Usually the key will be restricted to running
only one command on the remote server. If the remote SSH server tracks
invocation agruments, the one remote program may be an agent that can
execute additional commands as proxy
To use passive mode, provide multiple '-C' options, and provide
all of -O, -s, and -n options (servicelist order must match '-C'
options)
check_disk
This plugin will check the percent of used disk space on a mounted
file system and generate an alert if percentage is above one of the
threshold values.
Usage: check_disk -w limit -c limit [-p path] [-t timeout] [-m] [--verbose]
check_disk (-h|--help)
check_disk (-V|--version)
Options:
-w, --warning=INTEGER
Exit with WARNING status if less than INTEGER kilobytes of disk are free
-w, --warning=PERCENT%
Exit with WARNING status if more than PERCENT of disk space is free
-c, --critical=INTEGER
Exit with CRITICAL status if less than INTEGER kilobytes of disk are free
-c, --critical=PERCENT%
Exit with CRITCAL status if more than PERCENT of disk space is free
-p, --path=PATH, --partition=PARTTION
Path or partition (checks all mounted partitions if unspecified)
-m, --mountpoint
Display the mountpoint instead of the partition
-v, --verbose
Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_disk_smb
This plugin will check the percent of used disk space on a mounted
file system and generate an alert if percentage is above one of the
threshold values.
Usage: check_disk -w limit -c limit [-p path] [-t timeout] [-m] [--verbose]
check_disk (-h|--help)
check_disk (-V|--version)
Options:
-w, --warning=INTEGER
Exit with WARNING status if less than INTEGER kilobytes of disk are free
-w, --warning=PERCENT%
Exit with WARNING status if more than PERCENT of disk space is free
-c, --critical=INTEGER
Exit with CRITICAL status if less than INTEGER kilobytes of disk are free
-c, --critical=PERCENT%
Exit with CRITCAL status if more than PERCENT of disk space is free
-p, --path=PATH, --partition=PARTTION
Path or partition (checks all mounted partitions if unspecified)
-m, --mountpoint
Display the mountpoint instead of the partition
-v, --verbose
Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_dns
Usage: check_dns -H host [-s server] [-a expected-address] [-t timeout]
check_dns --help
check_dns --version
-H, --hostname=HOST
The name or address you want to query
-s, --server=HOST
Optional DNS server you want to use for the lookup
-a, --expected-address=IP-ADDRESS
Optional IP address you expect the DNS server to return
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-h, --help
Print detailed help
-V, --version
Print version numbers and license information
This plugin uses the nslookup program to obtain the IP address
for the given host/domain query. A optional DNS server to use may
be specified. If no DNS server is specified, the default server(s)
specified in /etc/resolv.conf will be used.
check_dummy
Usage: ./check_dummy <integer state> This plugin will simply return the state corresponding to the numeric value of the <state> argument.
check_flexlm
Check available flexlm license managers Usage: check_flexlm -F <filename> [--verbose] check_flexlm --help check_flexlm --version -F, --filename=FILE Name of license file -v, --verbose Print some extra debugging information (not advised for normal operation) -V, --version Show version and license information -h, --help Show this help screen
check_ftp
This plugin tests FTP connections with the specified host.
Usage: check_ftp -H host -p port [-w warn_time] [-c crit_time] [-s send]
[-e expect] [-W wait] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-s, --send=STRING
String to send to the server
-e, --expect=STRING
String to expect in server response -W, --wait=INTEGER
Seconds to wait between sending string and polling for response
-w, --warning=DOUBLE
Response time to result in warning status (seconds)
-c, --critical=DOUBLE
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-v Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_http
This plugin tests the HTTP service on the specified host. It can test
normal (http) and secure (https) servers, follow redirects, search for
strings and regular expressions, check connection times, and report on
certificate expiration times.
Usage:
check_http (-H <vhost> | -I <IP-address>) [-u <uri>] [-p <port>]
[-w <warn time>] [-c <critical time>] [-t <timeout>] [-L]
[-a auth] [-f <ok | warn | critcal | follow>] [-e <expect>]
[-s string] [-r <regex> | -R <case-insensitive regex>]
[-P string]
check_http (-h | --help) for detailed help
check_http (-V | --version) for version information
NOTE: One or both of -H and -I must be specified
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (virtual host)
-I, --IP-address=ADDRESS
IP address or name (use numeric address if possible to bypass DNS lookup).
-e, --expect=STRING
String to expect in first (status) line of server response (default: HTTP/1.)
If specified skips all other status line logic (ex: 3xx, 4xx, 5xx processing)
-s, --string=STRING
String to expect in the content
-u, --url=PATH
URL to GET or POST (default: /)
-p, --port=INTEGER
Port number (default: 80)
-P, --post=STRING
URL encoded http POST data
-w, --warning=INTEGER
Response time to result in warning status (seconds)
-c, --critical=INTEGER
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-a, --authorization=AUTH_PAIR
Username:password on sites with basic authentication
-L, --link=URL
Wrap output in HTML link (obsoleted by urlize)
-f, --onredirect=<ok|warning|critical|follow>
How to handle redirected pages
-S, --ssl
Connect via SSL
-C, --certificate=INTEGER
Minimum number of days a certificate has to be valid.
(when this option is used the url is not checked.)
-v, --verbose
Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
This plugin can also check whether an SSL enabled web server is able to
serve content (optionally within a specified time) or whether the X509
certificate is still valid for the specified number of days.
CHECK CONTENT: check_http -w 5 -c 10 --ssl www.verisign.com
When the 'www.verisign.com' server returns its content within 5 seconds, a
STATE_OK will be returned. When the server returns its content but exceeds
the 5-second threshold, a STATE_WARNING will be returned. When an error occurs,
a STATE_CRITICAL will be returned.
CHECK CERTIFICATE: check_http www.verisign.com -C 14
When the certificate of 'www.verisign.com' is valid for more than 14 days, a
STATE_OK is returned. When the certificate is still valid, but for less than
14 days, a STATE_WARNING is returned. A STATE_CRITICAL will be returned when
the certificate is expired.
check_imap
This plugin tests IMAP connections with the specified host.
Usage: check_imap -H host -p port [-w warn_time] [-c crit_time] [-s send]
[-e expect] [-W wait] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-s, --send=STRING
String to send to the server
-e, --expect=STRING
String to expect in server response -W, --wait=INTEGER
Seconds to wait between sending string and polling for response
-w, --warning=DOUBLE
Response time to result in warning status (seconds)
-c, --critical=DOUBLE
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-v Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_ircd
Perl Check IRCD plugin for Nagios Usage: check_ircd -H <host> [-w <warn>] [-c <crit>] [-p <port>] -H, --hostname=HOST Name or IP address of host to check -w, --warning=INTEGER Number of connected users which generates a warning state (Default: 50) -c, --critical=INTEGER Number of connected users which generates a critical state (Default: 100) -p, --port=INTEGER Port that the ircd daemon is running on <host> (Default: 6667) -v, --verbose Print extra debugging information
check_load
This plugin tests the current system load average.
Usage: check_load -w WLOAD1,WLOAD5,WLOAD15 -c CLOAD1,CLOAD5,CLOAD15
check_load --version
check_load --help
Options:
-w, --warning=WLOAD1,WLOAD5,WLOAD15
Exit with WARNING status if load average exceeds WLOADn
-c, --critical=CLOAD1,CLOAD5,CLOAD15
Exit with CRITICAL status if load average exceed CLOADn
-h, --help
Print detailed help screen
-V, --version
Print version information
the load average format is the same used by "uptime" and "w"
check_log
Usage: check_log -F logfile -O oldlog -q query Usage: check_log --help Usage: check_log --version Log file pattern detector plugin for Nagios
check_mailq
Usage: check_mailq [-w <warn>] [-c <crit>] [-t <timeout>] [-v verbose] Checks the number of messages in the mail queue Feedback/patches to support non-sendmail mailqueue welcome -w (--warning) = Min. number of messages in queue to generate warning -c (--critical) = Min. number of messages in queu to generate critical alert ( w < c ) -t (--timeout) = Plugin timeout in seconds (default = 15) -h (--help) -V (--version) -v (--verbose) = deebugging output
check_mrtg
This plugin will check either the average or maximum value of one of the
two variables recorded in an MRTG log file.
Usage:
check_mrtg -F log_file -a <AVG | MAX> -v variable -w warning -c critical
[-l label] [-u units] [-e expire_minutes] [-t timeout] [-v]
check_mrtg (-h | --help) for detailed help
check_mrtg (-V | --version) for version information
Options:
-F, --logfile=FILE
The MRTG log file containing the data you want to monitor
-e, --expires=MINUTES
Minutes before MRTG data is considered to be too old
-a, --aggregation=AVG|MAX
Should we check average or maximum values?
-v, --variable=INTEGER
Which variable set should we inspect? 1 or 2?
-w, --warning=INTEGER
Threshold value for data to result in WARNING status
-c, --critical=INTEGER
Threshold value for data to result in CRITICAL status
-l, --label=STRING
Type label for data (Examples: Conns, "Processor Load", In, Out)
-u, --units=STRING
Option units label for data (Example: Packets/Sec, Errors/Sec,
"Bytes Per Second", "% Utilization")
-h, --help
Print detailed help screen
-V, --version
Print version information
If the value exceeds the <vwl> threshold, a WARNING status is returned. If
the value exceeds the <vcl> threshold, a CRITICAL status is returned. If
the data in the log file is older than <expire_minutes> old, a WARNING
status is returned and a warning message is printed.
This plugin is useful for monitoring MRTG data that does not correspond to
bandwidth usage. (Use the check_mrtgtraf plugin for monitoring bandwidth).
It can be used to monitor any kind of data that MRTG is monitoring - errors,
packets/sec, etc. I use MRTG in conjuction with the Novell NLM that allows
me to track processor utilization, user connections, drive space, etc and
this plugin works well for monitoring that kind of data as well.
Notes:
- This plugin only monitors one of the two variables stored in the MRTG log
file. If you want to monitor both values you will have to define two
commands with different values for the <variable> argument. Of course,
you can always hack the code to make this plugin work for you...
- MRTG stands for the Multi Router Traffic Grapher. It can be downloaded from
http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html
check_mrtgtraf
This plugin tests the UPS service on the specified host.
Usage: check_mrtgtraf -F <log_file> -a <AVG | MAX> -v <variable> -w <warning_pair> -c <critical_pair>
[-e expire_minutes] [-t timeout] [-v]
check_mrtgtraf --help
check_mrtgtraf --version
Options:
-F, --filename=STRING
File to read log from
-e, --expires=INTEGER
Minutes after which log expires
-a, --aggregation=(AVG|MAX)
Test average or maximum -w, --warning
Warning threshold pair "<incoming>,<outgoing>"
-c, --critical
Critical threshold pair "<incoming>,<outgoing>"
-h, --help
Print detailed help screen
-V, --version
Print version information
check_nagios
This plugin attempts to check the status of the Nagios process on the local machine. The plugin will check to make sure the Nagios status log is no older than the number of minutes specified by the <expire_minutes> option. It also uses the /bin/ps command to check for a process matching whatever you specify by the <process_string> argument. Usage: check_nagios -F <status log file> -e <expire_minutes> -C <process_string> Options: -F, --filename=FILE Name of the log file to check -e, --expires=INTEGER Seconds aging afterwhich logfile is condsidered stale -C, --command=STRING Command to search for in process table -h, --help Print this help screen -V, --version Print version information Example: ./check_nagios -H /usr/local/nagios/var/status.log -e 5 -C /usr/local/nagios/bin/nagios
check_nntp
This plugin tests NNTP connections with the specified host.
Usage: check_nntp -H host -p port [-w warn_time] [-c crit_time] [-s send]
[-e expect] [-W wait] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-s, --send=STRING
String to send to the server
-e, --expect=STRING
String to expect in server response -W, --wait=INTEGER
Seconds to wait between sending string and polling for response
-w, --warning=DOUBLE
Response time to result in warning status (seconds)
-c, --critical=DOUBLE
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-v Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_ntp
Usage: check_ntp -H <host> [-w <warn>] [-c <crit>] [-v verbose]
<warn> = Clock offset in seconds at which a warning message will be generated.
Defaults to 60.
<crit> = Clock offset in seconds at which a critical message will be generated.
Defaults to 120.
The same warning and critical values are used to check against the dispersion
column of ntpdc/xntpdc for the host being queried.
check_nwstat
This plugin attempts to contact the MRTGEXT NLM running on a Novell server
to gather the requested system information.
Usage:
check_nwstat -H host [-v variable] [-w warning] [-c critical]
[-p port] [-t timeout]
check_nwstat (-h | --help) for detailed help
check_nwstat (-V | --version) for version information
Options:
-H, --hostname=HOST
Name of the host to check
-v, --variable=STRING
Variable to check. Valid variables include:
LOAD1 = 1 minute average CPU load
LOAD5 = 5 minute average CPU load
LOAD15 = 15 minute average CPU load
CONNS = number of currently licensed connections
VPF<vol> = percent free space on volume <vol>
VKF<vol> = KB of free space on volume <vol>
LTCH = percent long term cache hits
CBUFF = current number of cache buffers
CDBUFF = current number of dirty cache buffers
LRUM = LRU sitting time in minutes
DSDB = check to see if DS Database is open
LOGINS = check to see if logins are enabled
UPRB = used packet receive buffers
PUPRB = percent (of max) used packet receive buffers
SAPENTRIES = number of entries in the SAP table
SAPENTRIES<n> = number of entries in the SAP table for SAP type <n>
OFILES = number of open files
VPP<vol> = percent purgeable space on volume <vol>
VKP<vol> = KB of purgeable space on volume <vol>
VPNP<vol> = percent not yet purgeable space on volume <vol>
VKNP<vol> = KB of not yet purgeable space on volume <vol>
ABENDS = number of abended threads (NW 5.x only)
CSPROCS = number of current service processes (NW 5.x only)
-w, --warning=INTEGER
Threshold which will result in a warning status
-c, --critical=INTEGER
Threshold which will result in a critical status
-p, --port=INTEGER
Optional port number (default: 9999)
-t, --timeout=INTEGER
Seconds before connection attempt times out (default: 10)
-o, --osversion
Include server version string in results
-h, --help
Print this help screen
-V, --version
Print version information
Notes:
- This plugin requres that the MRTGEXT.NLM file from James Drews' MRTG
extension for NetWare be loaded on the Novell servers you wish to check.
(available from http://www.engr.wisc.edu/~drews/mrtg/)
- Values for critical thresholds should be lower than warning thresholds
when the following variables are checked: VPF, VKF, LTCH, CBUFF, and LRUM.
check_overcr
This plugin attempts to contact the Over-CR collector daemon running on the
remote UNIX server in order to gather the requested system information. This
plugin requres that Eric Molitors' Over-CR collector daemon be running on the
remote server. Over-CR can be downloaded from http://www.molitor.org/overcr
(This plugin was tested with version 0.99.53 of the Over-CR collector)
Usage: check_overcr -H host [-p port] [-v variable] [-w warning] [-c critical] [-t timeout]
Options:
-H, --hostname=HOST
Name of the host to check
-p, --port=INTEGER
Optional port number (default: 2000)
-v, --variable=STRING
Variable to check. Valid variables include:
LOAD1 = 1 minute average CPU load
LOAD5 = 5 minute average CPU load
LOAD15 = 15 minute average CPU load
DPU<filesys> = percent used disk space on filesystem <filesys>
PROC<process> = number of running processes with name <process>
NET<port> = number of active connections on TCP port <port>
UPTIME = system uptime in seconds
-w, --warning=INTEGER
Threshold which will result in a warning status
-c, --critical=INTEGER
Threshold which will result in a critical status
-t, --timeout=INTEGER
Seconds before connection attempt times out (default: 10)
-h, --help
Print this help screen
-V, --version
Print version information
Notes:
- For the available options, the critical threshold value should always be
higher than the warning threshold value, EXCEPT with the uptime variable
(i.e. lower uptimes are worse).
check_ping
Use ping to check connection statistics for a remote host.
Usage:
check_ping -H <host_address> -w <wrta>,<wpl>%% -c <crta>,<cpl>%%
[-p packets] [-t timeout] [-L]
check_ping (-h | --help) for detailed help
check_ping (-V | --version) for version information
Options:
-H, --hostname=HOST
host to ping
-w, --warning=THRESHOLD
warning threshold pair
-c, --critical=THRESHOLD
critical threshold pair
-p, --packets=INTEGER
number of ICMP ECHO packets to send (Default: 5)
-t, --timeout=INTEGER
optional specified timeout in second (Default: 10)
-L, --link
show HTML in the plugin output (obsoleted by urlize)
THRESHOLD is <rta>,<pl>% where <rta> is the round trip average travel
time (ms) which triggers a WARNING or CRITICAL state, and <pl> is the
percentage of packet loss to trigger an alarm state.
This plugin uses the ping command to probe the specified host for packet loss
(percentage) and round trip average (milliseconds). It can produce HTML output
linking to a traceroute CGI contributed by Ian Cass. The CGI can be found in
the contrib area of the downloads section at http://www.nagios.org/
check_pop
This plugin tests POP connections with the specified host.
Usage: check_pop -H host -p port [-w warn_time] [-c crit_time] [-s send]
[-e expect] [-W wait] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-s, --send=STRING
String to send to the server
-e, --expect=STRING
String to expect in server response -W, --wait=INTEGER
Seconds to wait between sending string and polling for response
-w, --warning=DOUBLE
Response time to result in warning status (seconds)
-c, --critical=DOUBLE
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-v Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_procs
Check the number of currently running processes and generates WARNING or
CRITICAL states if the process count is outside the specified threshold
ranges. The process count can be filtered by process owner, parent process
PID, current state (e.g., 'Z'), or may be the total number of running
processes
Usage:
check_procs -w <range> -c <range> [-s state] [-p ppid] [-u user]
[-a argument-array] [-C command]
check_procs --version
check_procs --help
Required Arguments:
-w, --warning=RANGE
generate warning state if process count is outside this range
-c, --critical=RANGE
generate critical state if process count is outside this range
Optional Filters:
-s, --state=STATUSFLAGS
Only scan for processes that have, in the output of `ps`, one or
more of the status flags you specify (for example R, Z, S, RS,
RSZDT, plus others based on the output of your 'ps' command).
-p, --ppid=PPID
Only scan for children of the parent process ID indicated.
-u, --user=USER
Only scan for proceses with user name or ID indicated.
-a, --argument-array=STRING
Only scan for ARGS that match up to the length of the given STRING
-C, --command=COMMAND
Only scan for exact matches to the named COMMAND.
RANGEs are specified 'min:max' or 'min:' or ':max' (or 'max'). If
specified 'max:min', a warning status will be generated if the
count is inside the specified range
check_real
This plugin tests the REAL service on the specified host.
Usage: check_real -H host [-e expect] [-p port] [-w warn] [-c crit]
[-t timeout] [-v]
check_real --help
check_real --version
Options:
-H, --hostname=STRING or IPADDRESS
Check this server on the indicated host
-I, --IPaddress=STRING or IPADDRESS
Check server at this host address
-p, --port=INTEGER
Make connection on the indicated port (default: 554)
-u, --url=STRING
Connect to this url
-e, --expect=STRING
String to expect in first line of server response (default: RTSP/1.)
-w, --warning=INTEGER
Seconds necessary to result in a warning status
-c, --critical=INTEGER
Seconds necessary to result in a critical status
-t, --timeout=INTEGER
Seconds before connection attempt times out (default: 10)
-v, --verbose
Print extra information (command-line use only)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_rpc
Check if a rpc service is registered and running using
rpcinfo -H host -C rpc_command
Usage:
check_rpc -H host -C rpc_command [-p port] [-c program_version] [-u|-t] [-v]
check_rpc [-h | --help]
check_rpc [-V | --version]
<host> The server providing the rpc service
<rpc_command> The program name (or number).
<program_version> The version you want to check for (one or more)
Should prevent checks of unknown versions being syslogged
e.g. 2,3,6 to check v2, v3, and v6
[-u | -t] Test UDP or TCP
[-v] Verbose
[-v -v] Verbose - will print supported programs and numbers
check_sensors
This plugin checks hardware status using the lm_sensors package.
check_smtp
This plugin test the SMTP service on the specified host.
Usage: check_smtp -H host [-e expect] [-p port] [-f from addr] [-w warn] [-c crit] [-t timeout] [-v]
check_smtp --help
check_smtp --version
Options:
-H, --hostname=STRING or IPADDRESS
Check server on the indicated host
-p, --port=INTEGER
Make connection on the indicated port (default: 25)
-e, --expect=STRING
String to expect in first line of server response (default: 220)
-f, --from=STRING
from address to include in MAIL command (default NULL, Exchange2000 requires one)
-w, --warning=INTEGER
Seconds necessary to result in a warning status
-c, --critical=INTEGER
Seconds necessary to result in a critical status
-t, --timeout=INTEGER
Seconds before connection attempt times out (default: 10)
-v, --verbose
Print extra information (command-line use only)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_ssh
Usage: check_ssh -t [timeout] -p [port] <host> check_ssh -V prints version info check_ssh -h prints more detailed help by default, port is 22
check_swap
This plugin will check all of the swap partitions and return an
error if the the avalable swap space is less than specified.
Usage: check_swap -w <used_percentage>% -c <used_percentage>%
check_swap -w <bytes_free> -c <bytes_free>
check_swap (-V|--version)
check_swap (-h|--help)
Options:
-w, --warning=INTEGER
Exit with WARNING status if less than INTEGER bytes of swap space are free
-w, --warning=PERCENT%
Exit with WARNING status if more than PERCENT of swap space has been used
-c, --critical=INTEGER
Exit with CRITICAL status if less than INTEGER bytes of swap space are free
-c, --critical=PERCENT%
Exit with CRITCAL status if more than PERCENT of swap space has been used
-h, --help
Print detailed help screen
-V, --version
Print version information
check_tcp
This plugin tests TCP connections with the specified host.
Usage: check_tcp -H host -p port [-w warn_time] [-c crit_time] [-s send]
[-e expect] [-W wait] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-s, --send=STRING
String to send to the server
-e, --expect=STRING
String to expect in server response -W, --wait=INTEGER
Seconds to wait between sending string and polling for response
-w, --warning=DOUBLE
Response time to result in warning status (seconds)
-c, --critical=DOUBLE
Response time to result in critical status (seconds)
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-v Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_time
Check time on the specified host.
Usage:
check_time -H <host_address> [-p port] [-w variance] [-c variance]
[-W connect_time] [-C connect_time] [-t timeout]
check_time (-h | --help) for detailed help
check_time (-V | --version) for version information
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-w, --warning-variance=INTEGER
Time difference (sec.) necessary to result in a warning status
-c, --critical-variance=INTEGER
Time difference (sec.) necessary to result in a critical status
-W, --warning-connect=INTEGER
Response time (sec.) necessary to result in warning status
-C, --critical-connect=INTEGER
Response time (sec.) necessary to result in critical status
-t, --timeout=INTEGER
Seconds before connection times out (default: 10)
-p, --port=INTEGER
Port number (default: 37)
-h, --help
Print detailed help screen
-V, --version
Print version information
check_udp
This plugin tests an UDP connection with the specified host.
Usage: check_udp -H <host_address> [-p port] [-w warn_time] [-c crit_time]
[-e expect] [-s send] [-t to_sec] [-v]
Options:
-H, --hostname=ADDRESS
Host name argument for servers using host headers (use numeric
address if possible to bypass DNS lookup).
-p, --port=INTEGER
Port number
-e, --expect=STRING <optional>
String to expect in first line of server response
-s, --send=STRING <optional>
String to send to the server when initiating the connection
-w, --warning=INTEGER <optional>
Response time to result in warning status (seconds)
-c, --critical=INTEGER <optional>
Response time to result in critical status (seconds)
-t, --timeout=INTEGER <optional>
Seconds before connection times out (default: 10)
-v, --verbose <optional>
Show details for command-line debugging (do not use with nagios server)
-h, --help
Print detailed help screen and exit
-V, --version
Print version information and exit
check_users
This plugin checks the number of users currently logged in on the local
system and generates an error if the number exceeds the thresholds specified.
Usage: check_users -w <users> -c <users>
Options:
-w, --warning=INTEGER
Set WARNING status if more than INTEGER users are logged in
-c, --critical=INTEGER
Set CRITICAL status if more than INTEGER users are logged in
-h, --help
Print detailed help screen
-V, --version
Print version information
check_vsz
This plugin checks the image size of a running program and returns an
error if the number is above either of the thresholds given.
Usage: check_vsz -w <wsize> -c <csize> [-C command]
check_vsz --help
check_vsz --version
Options:
-h, --help
Print detailed help
-V, --version
Print version numbers and license information
-w, --warning=INTEGER
Program image size necessary to cause a WARNING state
-c, --critical=INTEGER
Program image size necessary to cause a CRITICAL state
-C, --command=STRING
Program to search for [optional]
check_wave
Usage: check_wave -H <host> [-w <warn>] [-c <crit>] <warn> = Signal strength at which a warning message will be generated. <crit> = Signal strength at which a critical message will be generated.
