Configure nagios Plugins
or 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_disk
check_disk_smb
check_dns
check_dummy
check_flexlm
check_ftp
check_http
check_imap
check_ircd
check_load
check_log
check_mailq
check_mrtg
check_mrtgtraf
check_nagios
check_nntp
check_ntp
check_nwstat
check_overcr
check_ping
check_pop
check_procs
check_real
check_rpc
check_sensors
check_smtp
check_ssh
check_swap
check_tcp
check_time
check_udp
check_ups
check_users
check_vsz
check_wave
We will deal with each in turn and how you might like to specify
them in the $NAGIOSHOME/etc/checkcommands.cfg file. Where there
are parameters available for a command, these can be passed
through from services.cfg
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.debian.org
When the 'www.debian.org'
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.debian.org
-C 14
When the certificate of 'www.debian.org'
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
here
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.