Share this page : facebooktwitterlinkedinmailfacebooktwitterlinkedinmail
Built in command

check_nt v2.2.git (monitoring-plugins 2.2)
Copyright (c) 2000 Yves Rubin ([email protected])
Copyright (c) 2000-2007 Monitoring Plugins Development Team
    <[email protected]>

This plugin collects data from the NSClient service running on a
Windows NT/2000/XP/2003 server.

check_nt -H host -v variable [-p port] [-w warning] [-c critical]
[-l params] [-d SHOWALL] [-u] [-t timeout]

 -h, --help
    Print detailed help screen
 -V, --version
    Print version information
    Read options from an ini file. See
    for usage and examples.
 -H, --hostname=HOST
   Name of the host to check
 -p, --port=INTEGER
   Optional port number (default: 1248)
 -s, --secret=<password>
   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>
   Parameters passed to specified check (see below) -d, --display={SHOWALL}
   Display options (currently only SHOWALL works) -u, --unknown-timeout
   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 <version> is specified, will return warning if versions differ.
  Average CPU load on last x minutes.
  Request a -l parameter with the following syntax:
  -l <minutes range>,<warning threshold>,<critical threshold>.
  <minute range> 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
  Get the uptime of the machine.
  -l <unit> 
  <unit> = seconds, minutes, hours, or days. (default: minutes)
  Thresholds will use the unit specified above.
  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.
  Memory use.
  Warning and critical thresholds can be specified with -w and -c.
  Check the state of one or several services.
  Request a -l parameters with the following syntax:
  -l <service1>,<service2>,<service3>,...
  You can specify -d SHOWALL in case you want to see working services
  in the returned string.
  Check if one or several process are running.
  Same syntax as SERVICESTATE.
  Check any performance counter of Windows NT/2000.
    Request a -l parameters with the following syntax:
    -l "\\<performance object>\\counter","<description>
    The <description> parameter is optional and is given to a printf 
  output command which requires a float parameter.
  If <description> does not include "%%", it is used as a label.
  Some examples:
  "Paging file usage is %%.2f %%%%"
  "%%.f %%%% paging file used."
  Check any performance counter object of Windows NT/2000.
  Syntax: check_nt -H <hostname> -p <port> -v INSTANCES -l <counter object>
  <counter object> 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 the monitoring service
   configuration files.
  Some examples:
  check_nt -H -p 1248 -v INSTANCES -l Process

Show a drive usage, we take C drive as example:

check_nt!USEDDISKSPACE! -l c -w 80 -c 90

to check other drive, simply change the “c” after the -l into the drive letter you want to check.

check_nt can check the local drive, if you want to check the network drive, such as NAS, you can use the check_disk_smb, which is talked about below.

Third party plugin

Such as the check_disk_smb, there is no command defined as this. You need to define the command and arguments first, then use it in the host configuration file.

 Commands that can be defined include service checks, service notifications, service event handlers, host checks, host notifications, and host event handlers. Command definitions can contain macros, but you must make sure that you include only those macros that are “valid” for the circumstances when the command will be used. More information on what macros are available and when they are “valid” can be found here. The different arguments to a command definition are outlined below.

Definition Format:

Note: Directives in red are required, while those in black are optional.

define command{
command_name command_name
command_line command_line

Example Definition:

define command{
        command_name    check_disk_smb
        command_line    $USER1$/check_disk_smb -H $ARG1$ -s $ARG2$ -w $ARG3$ -c $ARG4$

If I want to check the free space of the smb share located on (NAS box), and the shared volume is “Data” , and the Windows client (win2012Svr) mapped the smb share as a drive Z:.   Then in the windows Server host configuration file(windowscfg).define the service as follow:

define service{
        use                     generic-service
        host_name               win2012Svr
        service_description     z:\ Diskstation Space
        check_command           check_disk_smb!!Data!75!90


Directive Descriptions:

command_name: This directive is the short name used to identify the command. It is referenced in contact, host, and service definitions (in notification, check, and event handler directives), among other places.
command_line: This directive is used to define what is actually executed by Nagios when the command is used for service or host checks, notifications, or event handlers. Before the command line is executed, all valid macros are replaced with their respective values. See the documentation on macros for determining when you can use different macros. Note that the command line is not surrounded in quotes. Also, if you want to pass a dollar sign ($) on the command line, you have to escape it with another dollar sign.

NOTE: You may not include a semicolon (;) in the command_line directive, because everything after it will be ignored as a config file comment. You can work around this limitation by setting one of the $USER$ macros in your resource file to a semicolon and then referencing the appropriate $USER$ macro in the command_line directive in place of the semicolon.

If you want to pass arguments to commands during runtime, you can use $ARGn$ macros in the command_line directive of the command definition and then separate individual arguments from the command name (and from each other) using bang (!) characters in the object definition directive (host check command, service event handler command, etc) that references the command. More information on how arguments in command definitions are processed during runtime can be found in the documentation on macros.

Error in check_http

To check the http status:

/usr/local/nagios/libexec/check_http -H

Error message:

SERVICE ALERT: nagios-linuxclient;HTTP;WARNING;HARD;4;HTTP WARNING: HTTP/1.1 403 Forbidden – 5168 bytes in 0.077 second response time

Reason: the /var/www/html/ directory is empty, try the following command:

$ touch /var/www/html/index.html
$ chmod 755 /var/www/html/index.html