Home > Nagios > Default Nagios Check Commands

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_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 (is problematic, see this post)

check_users

check_vsz

check_wave

[top]

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)


[top]

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


[top]

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


[top]

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.


[top]

check_dummy

Usage: ./check_dummy <integer state>

This plugin will simply return the state corresponding to the numeric value
of the <state> argument.


[top]

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


[top]

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


[top]

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.


[top]

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


[top]

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


[top]

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"


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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.


[top]

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.


[top]

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).


[top]

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/


[top]

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


[top]

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


[top]

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


[top]

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


[top]

check_sensors

This plugin checks hardware status using the lm_sensors package.


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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


[top]

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]


[top]

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.


[top]

Categories: Nagios Tags:
Comments are closed.