Sie befinden sich hier: eisfair / Pack-Eis
News News News

Content

Dateianzeige für nagios-plugins (2.6.1)

usr/share/doc/nagios-plugins/nagios-plugins.txt
nagios-plugins - package for eisfair ==================================== Version 2.2.4 Stand 2017-01-31 =============================== Die Nagios-Plugins werden fuer die Pakete nrpe und Nagios benoetigt. Nagios ueberwacht mit der Hilfe der Plugins Hosts und Services auf Verfuegbarkeit. Die Plugins sind im Ordner /usr/local/nagios/plugins/ abgelegt. Welche Optionen Sie bieten kann mit der Option --help abgefragt werden. Die Nagios-Plugins haben die Version 2.1.4 Informationen rund ums Nagios bekommt man bei: http://www.nagios.org Liste der Plugins: check_apt check_breeze This plugin reports the signal strength of a Breezecom wireless equipment Usage: check_breeze -H [-C community] -w -c -H, --hostname=HOST Name or IP address of host to check -C, --community=community SNMPv1 community (default public) -w, --warning=INTEGER Percentage strength below which a WARNING status will result -c, --critical=INTEGER Percentage strength below which a CRITICAL status will result check_by_ssh This plugin uses SSH to execute commands on a remote host Usage: check_by_ssh -H -C [-fqv] [-1|-2] [-4|-6] [-S [lines]] [-E [lines]] [-t timeout] [-i identity] [-l user] [-n name] [-s servicelist] [-O outputfile] [-p port] [-o ssh-option] [-F configfile] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -1, --proto1 tell ssh to use Protocol 1 [optional] -2, --proto2 tell ssh to use Protocol 2 [optional] -S, --skip-stdout[=n] Ignore all or (if specified) first n lines on STDOUT [optional] -E, --skip-stderr[=n] Ignore all or (if specified) first n lines on STDERR [optional] -f tells ssh to fork rather than create a tty [optional]. This will always return OK if ssh is executed -C, --command='COMMAND STRING' command to execute on the remote machine -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] -o, --ssh-option=OPTION Call ssh with '-o OPTION' (may be used multiple times) [optional] -F, --configfile Tell ssh to use this configfile [optional] -q, --quiet Tell ssh to suppress warning and diagnostic messages [optional] -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) 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 arguments, 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) Examples: $ check_by_ssh -H localhost -n lh -s c1:c2:c3 -C uptime -C uptime -C uptime -O /tmp/foo $ cat /tmp/foo [1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c1;0; up 2 days [1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c2;0; up 2 days [1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c3;0; up 2 days check_clamd -> check_tcp This plugin tests CLAMD connections with the specified host (or unix socket). Usage: check_clamd -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_cluster Host/Service Cluster Plugin for Nagios 2 Usage: check_cluster (-s | -h) -d val1[,val2,...,valn] [-l label] [-w threshold] [-c threshold] [-v] [--help] Options: --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -s, --service Check service cluster status -h, --host Check host cluster status -l, --label=STRING Optional prepended text output (i.e. "Host cluster") -w, --warning=THRESHOLD Specifies the range of hosts or services in cluster that must be in a non-OK state in order to return a WARNING status level -c, --critical=THRESHOLD Specifies the range of hosts or services in cluster that must be in a non-OK state in order to return a CRITICAL status level -d, --data=LIST The status codes of the hosts or services in the cluster, separated by commas -v, --verbose Show details for command-line debugging (Nagios may truncate output) Notes: See: https://www.nagios-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for THRESHOLD format and examples. Examples: check_cluster -s -d 2,0,2,0 -c @3: Will alert critical if there are 3 or more service data points in a non-OK state. check_dhcp check_dhcp -s 192.168.0.1 -i eth0 -s, --serverip=IPADDRESS IP address of DHCP server that we must hear from -i, --interface=STRING Interface to to use for listening (i.e. eth0) Anmerkung: Ist Nagios und der DHCP-Server je weilst auf einer DomU Installiert, funktioniert der Check des DHCP-Server nicht! Nagios (auf Domu) --> SoHo Router mit DHCP-Server = Funktioniert. Nagios (keine VM) --> DHCP-Server (auf DomU)= Funktioniert. check_dig check_dig -l [-H ] -l, --query_address=STRING Machine name to lookup -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) check_disk check_disk -w 20% -c 10% -p /dev/hda1 -w, --warning=PERCENT% Exit with WARNING status if less than PERCENT of disk space is free -c, --critical=INTEGER Exit with CRITICAL status if less than INTEGER units of disk are free -p, --path=PATH, --partition=PARTITION Path or partition (may be repeated) check_disk_smb Perl Check SMB Disk plugin for Nagios Usage: check_disk_smb -H -s -u -p -w -c [-W ] [-P ] [-a ] -H, --hostname=HOST NetBIOS name of the server -s, --share=STRING Share name to be tested -W, --workgroup=STRING Workgroup or Domain used (Defaults to "WORKGROUP") -a, --address=IP IP-address of HOST (only necessary if HOST is in another network) -u, --user=STRING Username to log in to server. (Defaults to "guest") -p, --password=STRING Password to log in to server. (Defaults to an empty password) -w, --warning=INTEGER or INTEGER[kMG] Percent of used space at which a warning will be generated (Default: 85%) -c, --critical=INTEGER or INTEGER[kMG] Percent of used space at which a critical will be generated (Defaults: 95%) -P, --port=INTEGER Port to be used to connect to. Some Windows boxes use 139, others 445 (Defaults to smbclient default) If thresholds are followed by either a k, M, or G then check to see if that much disk space is available (kilobytes, Megabytes, Gigabytes) Warning percentage should be less than critical Warning (remaining) disk space should be greater than critical. check_dns This plugin uses the nslookup program to obtain the IP address for the given host/domain query. An 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. Usage: check_dns -H host [-s server] [-q type ] [-a expected-address] [-A] [-n] [-t timeout] [-w warn] [-c crit] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=HOST The name or address you want to query -s, --server=HOST Optional DNS server you want to use for the lookup -q, --querytype=TYPE Optional DNS record query type where TYPE =(A, AAAA, SRV, TXT, MX, ANY) The default query type is 'A' (IPv4 host entry) -a, --expected-address=IP-ADDRESS|HOST Optional IP-ADDRESS you expect the DNS server to return. HOST must end with a dot (.). This option can be repeated multiple times (Returns OK if any value match). If multiple addresses are returned at once, you have to match the whole string of addresses separated with commas (sorted alphabetically). If you would like to test for the presence of a cname, combine with -n param. -A, --expect-authority Optionally expect the DNS server to be authoritative for the lookup -n, --accept-cname Optionally accept cname responses as a valid result to a query The default is to ignore cname responses as part of the result -w, --warning=seconds Return warning if elapsed time exceeds value. Default off -c, --critical=seconds Return critical if elapsed time exceeds value. Default off -t, --timeout=INTEGER: Seconds before connection times out (default: 10) Optional ":" can be a state integer (0,1,2,3) or a state STRING check_dummy This plugin will simply return the state corresponding to the numeric value of the argument with optional text Usage: check_dummy [optional text] check_file_age Usage: check_file_age [-w ] [-c ] [-W ] [-C ] [-i] -f check_file_age [-h | --help] check_file_age [-V | --version] -i | --ignore-missing : return OK if the file does not exist File must be no more than this many seconds old (default: warn 240 secs, crit 600) File must be at least this many bytes long (default: crit 0 bytes) check_flexlm Check available flexlm license managers Usage: check_flexlm -F [-v] [-t] [-V] [-h] check_flexlm --help check_flexlm --version -F, --filename=FILE Name of license file (usually "license.dat") -v, --verbose Print some extra debugging information (not advised for normal operation) -t, --timeout Plugin time out in seconds (default = 15 ) -V, --version Show version and license information -h, --help Show this help screen Flexlm license managers usually run as a single server or three servers and a quorum is needed. The plugin return OK if 1 (single) or 3 (triple) servers are running, CRITICAL if 1(single) or 3 (triple) servers are down, and WARNING if 1 or 2 of 3 servers are running check_fping This plugin will use the fping command to ping the specified host for a fast check Note that it is necessary to set the suid flag on fping. Usage: check_fping -w limit -c limit [-b size] [-n number] [-T number] [-i number] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -H, --hostname=HOST name or IP Address of host to ping (IP Address bypasses name lookup, reducing system load) -w, --warning=THRESHOLD warning threshold pair -c, --critical=THRESHOLD critical threshold pair -b, --bytes=INTEGER size of ICMP packet (default: 56) -n, --number=INTEGER number of ICMP packets to send (default: 1) -T, --target-timeout=INTEGER Target timeout (ms) (default: fping's default for -t) -i, --interval=INTEGER Interval (ms) between sending packets (default: fping's default for -p) -S, --sourceip=HOST name or IP Address of sourceip -I, --sourceif=IF source interface name -v, --verbose Show details for command-line debugging (Nagios may truncate output) THRESHOLD is ,%% where is the round trip average travel time (ms) which triggers a WARNING or CRITICAL state, and is the percentage of packet loss to trigger an alarm state. IPv4 is used by default. Specify -6 to use IPv6. check_ftp -> check_tcp This plugin tests FTP connections with the specified host (or unix socket). Usage: check_ftp -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_hpjd This plugin tests the STATUS of an HP printer with a JetDirect card. Net-snmp must be installed on the computer running the plugin. Usage: check_hpjd -H host [-C community] [-p port] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -C, --community=STRING The SNMP community name (default=public) -p, --port=STRING Specify the port to check (default=161) 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 | -I [-u ] [-p ] [-J ] [-K ] [-w ] [-c ] [-t ] [-L] [-E] [-a auth] [-b proxy_auth] [-f ] [-e ] [-d string] [-s string] [-l] [-r | -R ] [-P string] [-m :] [-4|-6] [-N] [-M ] [-A string] [-k string] [-S ] [--sni] [-C [,]] [-T ] [-j method] NOTE: One or both of -H and -I must be specified Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name argument for servers using host headers (virtual host) Append a port to include it in the header (eg: example.com:5000) -I, --IP-address=ADDRESS IP address or name (use numeric address if possible to bypass DNS lookup). -p, --port=INTEGER Port number (default: 80) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -S, --ssl=VERSION Connect via SSL. Port defaults to 443. VERSION is optional, and prevents auto-negotiation (1 = TLSv1, 2 = SSLv2, 3 = SSLv3). --sni Enable SSL/TLS hostname extension support (SNI) -C, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. Port defaults to 443 (when this option is used the URL is not checked.) -J, --client-cert=FILE Name of file that contains the client certificate (PEM format) to be used in establishing the SSL session -K, --private-key=FILE Name of file containing the private key (PEM format) matching the client certificate -e, --expect=STRING Comma-delimited list of strings, at least one of them is expected in the first (status) line of the server response (default: HTTP/1.) If specified skips all other status line logic (ex: 3xx, 4xx, 5xx processing) -d, --header-string=STRING String to expect in the response headers -s, --string=STRING String to expect in the content -u, --url=PATH URL to GET or POST (default: /) -P, --post=STRING URL encoded http POST data -j, --method=STRING (for example: HEAD, OPTIONS, TRACE, PUT, DELETE) Set HTTP method. -N, --no-body Don't wait for document body: stop reading after headers. (Note that this still does an HTTP GET or POST, not a HEAD.) -M, --max-age=SECONDS Warn if document is more than SECONDS old. the number can also be of the form "10m" for minutes, "10h" for hours, or "10d" for days. -T, --content-type=STRING specify Content-Type header media type when POSTing -l, --linespan Allow regex to span newlines (must precede -r or -R) -r, --regex, --ereg=STRING Search page for regex STRING -R, --eregi=STRING Search page for case-insensitive regex STRING --invert-regex Return CRITICAL if found, OK if not -a, --authorization=AUTH_PAIR Username:password on sites with basic authentication -b, --proxy-authorization=AUTH_PAIR Username:password on proxy-servers with basic authentication -A, --useragent=STRING String to be sent in http header as "User Agent" -k, --header=STRING Any other tags to be sent in http header. Use multiple times for additional headers -E, --extended-perfdata Print additional performance data -L, --link Wrap output in HTML link (obsoleted by urlize) -f, --onredirect= How to handle redirected pages. sticky is like follow but stick to the specified IP address. stickyport also ensures port stays the same. -m, --pagesize=INTEGER<:INTEGER> Minimum page size required (bytes) : Maximum page size required (bytes) -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) Notes: This plugin will attempt to open an HTTP connection with the host. Successful connects return STATE_OK, refusals and timeouts return STATE_CRITICAL other errors return STATE_UNKNOWN. Successful connects, but incorrect reponse messages from the host result in STATE_WARNING return values. If you are checking a virtual server that uses 'host headers' you must supply the FQDN (fully qualified domain name) as the [host_name] argument. 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. Please note that this plugin does not check if the presented server certificate matches the hostname of the server, or if the certificate has a valid chain of trust to one of the locally installed CAs. Examples: CHECK CONTENT: check_http -w 5 -c 10 --ssl -H 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 -H 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 CERTIFICATE: check_http -H www.verisign.com -C 30,14 When the certificate of 'www.verisign.com' is valid for more than 30 days, a STATE_OK is returned. When the certificate is still valid, but for less than 30 days, but more than 14 days, a STATE_WARNING is returned. A STATE_CRITICAL will be returned when certificate expires in less than 14 days check_icmp Usage: check_icmp [options] [-H] host1 host2 hostN Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H specify a target -w warning threshold (currently 200.000ms,40%) -c critical threshold (currently 500.000ms,80%) -s specify a source IP address or device name -n number of packets to send (currently 5) -i max packet interval (currently 80.000ms) -I max target interval (currently 0.000ms) -m number of alive hosts required for success -l TTL on outgoing packets (currently 0) -t timeout value (seconds, currently 10) -b Number of icmp data bytes to send Packet size will be data bytes + icmp header (currently 56 + 8) -v verbose Notes: The -H switch is optional. Naming a host (or several) to check is not. Threshold format for -w and -c is 200.25,60% for 200.25 msec RTA and 60% packet loss. The default values should work well for most users. You can specify different RTA factors using the standardized abbreviations us (microseconds), ms (milliseconds, default) or just plain s for seconds. The -v switch can be specified several times for increased verbosity. check_ide_smart This plugin checks a local hard drive with the (Linux specific) SMART interface [http://smartlinux.sourceforge.net/smart/index.php]. Usage: check_ide_smart [-d ] [-i ] [-q quiet] [-1 ] [-O ] [-n ] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -d, --device=DEVICE Select device DEVICE Note: if the device is selected with this option, _no_ other options are accepted -i, --immediate Perform immediately offline tests -q, --quiet-check Returns the number of failed tests -1, --auto-on Turn on automatic offline tests -0, --auto-off Turn off automatic offline tests -n, --nagios Output suitable for Nagios check_ifoperstatus check_ifstatus check_imap -> check_tcp This plugin tests IMAP connections with the specified host (or unix socket). Usage: check_imap -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_ircd Perl Check IRCD plugin for Nagios Usage: check_ircd -H [-w ] [-c ] [-p ] -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 (Default: 6667) -v, --verbose Print extra debugging information check_jabber -> check_tcp This plugin tests JABBER connections with the specified host (or unix socket). Usage: check_jabber -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_ldap Usage: check_ldap (-H |-U ) -b [-p ] [-a ] [-D ] [-P ] [-w ] [-c ] [-t timeout] [-2|-3] [-4|-6] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: 389) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -a [--attr] ldap attribute to search (default: "(objectclass=*)" -b [--base] ldap base (eg. ou=my unit, o=my org, c=at -D [--bind] ldap bind DN (if required) -P [--pass] ldap password (if required) -T [--starttls] use starttls mechanism introduced in protocol version 3 -S [--ssl] use ldaps (ldap v2 ssl method). this also sets the default port to 636 -2 [--ver2] use ldap protocol version 2 -3 [--ver3] use ldap protocol version 3 (default protocol version: 2) -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) Notes: If this plugin is called via 'check_ldaps', method 'STARTTLS' will be implied (using default port 389) unless --port=636 is specified. In that case 'SSL on connect' will be used no matter how the plugin was called. This detection is deprecated, please use 'check_ldap' with the '--starttls' or '--ssl' flags to define the behaviour explicitly instead. check_ldaps -> check_ldap Usage: check_ldaps (-H |-U ) -b [-p ] [-a ] [-D ] [-P ] [-w ] [-c ] [-t timeout] [-2|-3] [-4|-6] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: 389) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -a [--attr] ldap attribute to search (default: "(objectclass=*)" -b [--base] ldap base (eg. ou=my unit, o=my org, c=at -D [--bind] ldap bind DN (if required) -P [--pass] ldap password (if required) -T [--starttls] use starttls mechanism introduced in protocol version 3 -S [--ssl] use ldaps (ldap v2 ssl method). this also sets the default port to 636 -2 [--ver2] use ldap protocol version 2 -3 [--ver3] use ldap protocol version 3 (default protocol version: 2) -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) Notes: If this plugin is called via 'check_ldaps', method 'STARTTLS' will be implied (using default port 389) unless --port=636 is specified. In that case 'SSL on connect' will be used no matter how the plugin was called. This detection is deprecated, please use 'check_ldap' with the '--starttls' or '--ssl' flags to define the behaviour explicitly instead. check_load This plugin tests the current system load average. Usage: check_load [-r] -w WLOAD1,WLOAD5,WLOAD15 -c CLOAD1,CLOAD5,CLOAD15 check_load -w 15,10,5 -c 30,25,20 Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -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 the load average format is the same used by "uptime" and "w" -r, --percpu Divide the load averages by the number of CPUs (when possible) check_log Log file pattern detector plugin for Nagios Usage: check_log -F logfile -O oldlog -q query Usage: check_log --help Usage: check_log --version Aditional parameter: -w (--max_warning) If used, determines the maximum matching value to return as warning, when finding more matching lines than this parameter will return as critical. If not used, will consider as default 0 (any matching will consider as critical) Usage: check_log -F logfile -O oldlog -q query -w check_mailq 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 -v variable -w warning -c critical [-l label] [-u units] [-e expire_minutes] [-t timeout] [-v] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -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") If the value exceeds the threshold, a WARNING status is returned. If the value exceeds the threshold, a CRITICAL status is returned. If the data in the log file is older than 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 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 will check the incoming/outgoing transfer rates of a router, switch, etc recorded in an MRTG log. If the newest log entry is older than , a WARNING status is returned. If either the incoming or outgoing rates exceed the or thresholds (in Bytes/sec), a CRITICAL status results. If either of the rates exceed the or thresholds (in Bytes/sec), a WARNING status results. Usage check_mrtgtraf -F -a -w -c [-e expire_minutes] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -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 , -c, --critical Critical threshold pair , -v, --verbose Verbose output durring plugin runtime. Notes: - MRTG stands for Multi Router Traffic Grapher. It can be downloaded from http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html - While MRTG can monitor things other than traffic rates, this plugin probably won't work with much else without modification. - The calculated i/o rates are a little off from what MRTG actually reports. I'm not sure why this is right now, but will look into it for future enhancements of this plugin. check_nagios This plugin checks 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 expires option. It also checks the process table for a process matching the command argument. Usage: check_nagios -F -t -e -C Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -F, --filename=FILE Name of the log file to check -e, --expires=INTEGER Minutes aging after which logfile is considered stale -C, --command=STRING Substring to search for in process arguments -t, --timeout=INTEGER Timeout for the plugin in seconds -v, --verbose Show details for command-line debugging (Nagios may truncate output) Examples: ./check_nagios -t 20 -e 5 -F /var/lib/nagios/nagios.log -C /usr/local/bin/nagios NAGIOS OK: 6 processes, status log updated 11 seconds ago check_nntp -> check_tcp This plugin tests NNTP connections with the specified host (or unix socket). Usage: check_nntp -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_nntps -> check_tcp This plugin tests NNTPS connections with the specified host (or unix socket). Usage: check_nntps -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ][-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D [,]] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: none) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -E, --escape Can use \n, \r, \t or \\ in send or quit string. Must come before send or quit option Default: nothing added to send, \r\n added to end of quit -s, --send=STRING String to send to the server -e, --expect=STRING String to expect in server response (may be repeated) -A, --all All expect strings need to occur in server response. Default is any -q, --quit=STRING String to send server to initiate a clean close of the connection -r, --refuse=ok|warn|crit Accept TCP refusals with states ok, warn, crit (default: crit) -M, --mismatch=ok|warn|crit Accept expected string mismatches with states ok, warn, crit (default: warn) -j, --jail Hide output from TCP socket -m, --maxbytes=INTEGER Close connection once more than this number of bytes are received -d, --delay=INTEGER Seconds to wait between sending string and polling for response -D, --certificate=INTEGER[,INTEGER] Minimum number of days a certificate has to be valid. 1st is #days for warning, 2nd is critical (if not specified - 0). -S, --ssl Use SSL for the connection. -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) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) check_nt This plugin collects data from the NSClient service running on a Windows NT/2000/XP/2003 server. Usage: check_nt -H host -v variable [-p port] [-w warning] [-c critical] [-l params] [-d SHOWALL] [-u](DEPRECATED) [-t timeout] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. Options: -H, --hostname=HOST Name of the host to check -p, --port=INTEGER Optional port number (default: 1248) -s, --secret= Password needed for the request -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: -l, --params= Parameters passed to specified check (see below) -d, --display={SHOWALL} Display options (currently only SHOWALL works) -u, --unknown-timeout (DEPRECATED) Return UNKNOWN on timeouts10) -h, --help Print this help screen -V, --version Print version information -v, --variable=STRING Variable to check Valid variables are: CLIENTVERSION = Get the NSClient version If -l is specified, will return warning if versions differ. CPULOAD = Average CPU load on last x minutes. Request a -l parameter with the following syntax: -l ,,. should be less than 24*60. Thresholds are percentage and up to 10 requests can be done in one shot. ie: -l 60,90,95,120,90,95 UPTIME = Get the uptime of the machine. -l = seconds, minutes, hours, or days. (default: minutes) Thresholds will use the unit specified above. USEDDISKSPACE = Size and percentage of disk use. Request a -l parameter containing the drive letter only. Warning and critical thresholds can be specified with -w and -c. MEMUSE = Memory use. Warning and critical thresholds can be specified with -w and -c. SERVICESTATE = Check the state of one or several services. Request a -l parameters with the following syntax: -l ,,,... You can specify -d SHOWALL in case you want to see working services in the returned string. PROCSTATE = Check if one or several process are running. Same syntax as SERVICESTATE. COUNTER = Check any performance counter of Windows NT/2000. Request a -l parameters with the following syntax: -l "\\\\counter"," The parameter is optional and is given to a printf output command which requires a float parameter. If does not include "%%", it is used as a label. Some examples: "Paging file usage is %%.2f %%%%" "%%.f %%%% paging file used." INSTANCES = Check any performance counter object of Windows NT/2000. Syntax: check_nt -H -p -v INSTANCES -l is a Windows Perfmon Counter object (eg. Process), if it is two words, it should be enclosed in quotes The returned results will be a comma-separated list of instances on the selected computer for that object. The purpose of this is to be run from command line to determine what instances are available for monitoring without having to log onto the Windows server to run Perfmon directly. It can also be used in scripts that automatically create Nagios service configuration files. Some examples: check_nt -H 192.168.1.1 -p 1248 -v INSTANCES -l Process Notes: - The NSClient service should be running on the server to get any information (http://nsclient.ready2run.nl). - Critical thresholds should be lower than warning thresholds - Default port 1248 is sometimes in use by other services. The error output when this happens contains "Cannot map xxxxx to protocol number". One fix for this is to change the port to something else on check_nt and on the client service it's connecting to. check_ntp This plugin checks the selected ntp server WARNING: check_ntp is deprecated. Please use check_ntp_peer or check_ntp_time instead. Usage: check_ntp -H [-w ] [-c ] [-j ] [-k ] [-4|-6] [-v verbose] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: 123) -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -w, --warning=THRESHOLD Offset to result in warning status (seconds) -c, --critical=THRESHOLD Offset to result in critical status (seconds) -j, --jwarn=THRESHOLD Warning threshold for jitter -k, --jcrit=THRESHOLD Critical threshold for jitter -t, --timeout=INTEGER: Seconds before connection times out (default: 10) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) Notes: See: https://www.nagios-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for THRESHOLD format and examples. Examples: Normal offset check: ./check_ntp -H ntpserv -w 0.5 -c 1 Check jitter too, avoiding critical notifications if jitter isn't available (See Notes above for more details on thresholds formats): ./check_ntp -H ntpserv -w 0.5 -c 1 -j -1:100 -k -1:200 Send email to help@nagios-plugins.org if you have questions regarding use of this software. To submit patches or suggest improvements, send email to devel@nagios-plugins.org WARNING: check_ntp is deprecated. Please use check_ntp_peer or check_ntp_time instead. check_ntp_peer This plugin checks the selected ntp server Usage: check_ntp_peer -H [-4|-6] [-w ] [-c ] [-W ] [-C ] [-j ] [-k ] [-v verbose] Options: -h, --help Print detailed help screen -V, --version Print version information --extra-opts=[section][@file] Read options from an ini file. See https://www.nagios-plugins.org/doc/extra-opts.html for usage and examples. -4, --use-ipv4 Use IPv4 connection -6, --use-ipv6 Use IPv6 connection -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: 123) -q, --quiet Returns UNKNOWN instead of CRITICAL or WARNING if server isn't synchronized -w, --warning=THRESHOLD Offset to result in warning status (seconds) -c, --critical=THRESHOLD Offset to result in critical status (seconds) -W, --swarn=THRESHOLD Warning threshold for stratum of server's synchronization peer -C, --scrit=THRESHOLD Critical threshold for stratum of server's synchronization peer -j, --jwarn=THRESHOLD Warning threshold for jitter -k, --jcrit=THRESHOLD Critical threshold for jitter -m, --twarn=THRESHOLD Warning threshold for number of usable time sources ("truechimers") -n, --tcrit=THRESHOLD Critical threshold for number of usable time sources ("truechimers") -t, --timeout=INTEGER: Seconds before connection times out (default: 10) Optional ":" can be a state integer (0,1,2,3) or a state STRING -v, --verbose Show details for command-line debugging (Nagios may truncate output) This plugin checks an NTP server independent of any commandline programs or external libraries. Notes: Use this plugin to check the health of an NTP server. It supports checking the offset with the sync peer, the jitter and stratum. This plugin will not check the clock offset between the local host and NTP server; please use check_ntp_time for that purpose. See: https://www.nagios-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for THRESHOLD format and examples. Examples: Simple NTP server check: ./check_ntp_peer -H ntpserv -w 0.5 -c 1 Check jitter too, avoiding critical notifications if jitter isn't available (See Notes above for more details on thresholds formats): ./check_ntp_peer -H ntpserv -w 0.5 -c 1 -j -1:100 -k -1:200 Only check the number of usable time sources ("truechimers"): ./check_ntp_peer -H ntpserv -m @5 -n @3 Check only stratum: ./check_ntp_peer -H ntpserv -W 4 -C 6 check_ntp_time This plugin checks the clock offset with the ntp server Usage: check_ntp_time -H [-4|-6] [-w ] [-c ] [-v verbose] [-o