NRDPClient
NRDPClient
— NRDPClient¶NRDP client can be used both from command line and from queries to check remote systes via NRDP
Queries (Overview):
A list of all available queries (check commands)
Command | Description |
---|---|
submit_nrdp |
Submit information to the remote NRDP Server. |
Commands (Overview):
TODO: Add a list of all external commands (this is not check commands)
Configuration (Overview):
Common Keys:
Path / Section | Key | Description |
---|---|---|
/settings/NRDP/client |
channel |
CHANNEL |
/settings/NRDP/client |
hostname |
HOSTNAME |
/settings/NRDP/client/targets/default |
address |
TARGET ADDRESS |
/settings/NRDP/client/targets/default |
retries |
RETRIES |
/settings/NRDP/client/targets/default |
timeout |
TIMEOUT |
Advanced keys:
Path / Section | Key | Default Value | Description |
---|---|---|---|
/settings/NRDP/client/targets/default |
host |
TARGET HOST | |
/settings/NRDP/client/targets/default |
port |
TARGET PORT |
Sample keys:
Path / Section | Key | Default Value | Description |
---|---|---|---|
/settings/NRDP/client/targets/sample |
address |
TARGET ADDRESS | |
/settings/NRDP/client/targets/sample |
host |
TARGET HOST | |
/settings/NRDP/client/targets/sample |
port |
TARGET PORT | |
/settings/NRDP/client/targets/sample |
retries |
RETRIES | |
/settings/NRDP/client/targets/sample |
timeout |
TIMEOUT |
A quick reference for all available queries (check commands) in the NRDPClient module.
submit_nrdp
¶NRDPClient
submit_nrdp
Usage:
Option | Default Value | Description | ||
---|---|---|---|---|
help |
N/A | Show help screen (this screen) | ||
help-pb |
N/A | Show help screen as a protocol buffer payload | ||
show-default |
N/A | Show default values for a given command | ||
help-short |
N/A | Show help screen (short format). | ||
host |
The host of the host running the server | |||
port |
The port of the host running the server | |||
address |
The address (host:port) of the host running the server | |||
timeout |
Number of seconds before connection times out (default=10) | |||
target |
Target to use (lookup connection info from config) | |||
retry |
Number of times ti retry a failed connection attempt (default=2) | |||
retries |
legacy version of retry | |||
source-host |
Source/sender host name (default is auto which means use the name of the actual host) | |||
sender-host |
Source/sender host name (default is auto which means use the name of the actual host) | |||
command |
The name of the command that the remote daemon should run | |||
alias |
Same as command | |||
message |
Message | |||
result |
Result code either a number or OK, WARN, CRIT, UNKNOWN | |||
separator |
Separator to use for the batch command (default is | ) | ||
batch |
Add multiple records using the separator format is: command | result | message | |
key |
The security token | |||
password |
The security token | |||
source-host |
Source/sender host name (default is auto which means use the name of the actual host) | |||
sender-host |
Source/sender host name (default is auto which means use the name of the actual host) | |||
token |
The security token |
help
(NRDPClient, submit_nrdp)¶help-pb
(NRDPClient, submit_nrdp)¶show-default
(NRDPClient, submit_nrdp)¶help-short
(NRDPClient, submit_nrdp)¶host
(NRDPClient, submit_nrdp)¶port
(NRDPClient, submit_nrdp)¶address
(NRDPClient, submit_nrdp)¶timeout
(NRDPClient, submit_nrdp)¶target
(NRDPClient, submit_nrdp)¶retry
(NRDPClient, submit_nrdp)¶retries
(NRDPClient, submit_nrdp)¶source-host
(NRDPClient, submit_nrdp)¶sender-host
(NRDPClient, submit_nrdp)¶command
(NRDPClient, submit_nrdp)¶alias
(NRDPClient, submit_nrdp)¶message
(NRDPClient, submit_nrdp)¶result
(NRDPClient, submit_nrdp)¶batch
(NRDPClient, submit_nrdp)¶key
(NRDPClient, submit_nrdp)¶password
(NRDPClient, submit_nrdp)¶source-host
(NRDPClient, submit_nrdp)sender-host
(NRDPClient, submit_nrdp)token
(NRDPClient, submit_nrdp)¶/settings/NRDP/client
(NRDPClient)¶SMTP CLIENT SECTION
Section for SMTP passive check module.
Key Default Value Description channel
NRDP CHANNEL hostname
auto HOSTNAME Sample:
# SMTP CLIENT SECTION # Section for SMTP passive check module. [/settings/NRDP/client] channel=NRDP hostname=auto
channel
(NRDPClient, /settings/NRDP/client)¶CHANNEL
The channel to listen to.Path: /settings/NRDP/client
Key: channel
Default value: NRDP
Used by:
NRDPClient
Sample:
[/settings/NRDP/client] # CHANNEL channel=NRDP
hostname
(NRDPClient, /settings/NRDP/client)¶HOSTNAME
The host name of the monitored computer.Set this to auto (default) to use the windows name of the computer.auto Hostname${host} Hostname${host_lc}Hostname in lowercase${host_uc} Hostname in uppercase${domain} Domainname${domain_lc} Domainname in lowercase${domain_uc} Domainname in uppercasePath: /settings/NRDP/client
Key: hostname
Default value: auto
Used by:
NRDPClient
Sample:
[/settings/NRDP/client] # HOSTNAME hostname=auto
/settings/NRDP/client/handlers
(NRDPClient)¶CLIENT HANDLER SECTION
Sample:
# CLIENT HANDLER SECTION # [/settings/NRDP/client/handlers]
/settings/NRDP/client/targets
(NRDPClient)¶REMOTE TARGET DEFINITIONS
Sample:
# REMOTE TARGET DEFINITIONS # [/settings/NRDP/client/targets]
/settings/NRDP/client/targets/default
(NRDPClient)¶TARGET
Target definition for: default
Key Default Value Description address
TARGET ADDRESS host
TARGET HOST port
TARGET PORT retries
3 RETRIES timeout
30 TIMEOUT Sample:
# TARGET # Target definition for: default [/settings/NRDP/client/targets/default] address= host= port= retries=3 timeout=30
address
(NRDPClient, /settings/NRDP/client/targets/default)¶TARGET ADDRESS
Target host addressPath: /settings/NRDP/client/targets/default
Key: address
Default value:
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/default] # TARGET ADDRESS address=
host
(NRDPClient, /settings/NRDP/client/targets/default)¶TARGET HOST
The target server to report results to.Advanced (means it is not commonly used)
Path: /settings/NRDP/client/targets/default
Key: host
Default value:
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/default] # TARGET HOST host=
port
(NRDPClient, /settings/NRDP/client/targets/default)¶TARGET PORT
The target server portAdvanced (means it is not commonly used)
Path: /settings/NRDP/client/targets/default
Key: port
Default value:
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/default] # TARGET PORT port=
retries
(NRDPClient, /settings/NRDP/client/targets/default)¶RETRIES
Number of times to retry sending.Path: /settings/NRDP/client/targets/default
Key: retries
Default value: 3
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/default] # RETRIES retries=3
timeout
(NRDPClient, /settings/NRDP/client/targets/default)¶TIMEOUT
Timeout when reading/writing packets to/from sockets.Path: /settings/NRDP/client/targets/default
Key: timeout
Default value: 30
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/default] # TIMEOUT timeout=30
/settings/NRDP/client/targets/sample
(NRDPClient)¶TARGET
Target definition for: sample
Key Default Value Description address
TARGET ADDRESS host
TARGET HOST port
TARGET PORT retries
3 RETRIES timeout
30 TIMEOUT Sample:
# TARGET # Target definition for: sample [/settings/NRDP/client/targets/sample] address= host= port= retries=3 timeout=30
address
(NRDPClient, /settings/NRDP/client/targets/sample)¶TARGET ADDRESS
Target host addressPath: /settings/NRDP/client/targets/sample
Key: address
Default value:
Sample key: This key is provided as a sample to show how to configure objects
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/sample] # TARGET ADDRESS address=
host
(NRDPClient, /settings/NRDP/client/targets/sample)¶TARGET HOST
The target server to report results to.Advanced (means it is not commonly used)
Path: /settings/NRDP/client/targets/sample
Key: host
Default value:
Sample key: This key is provided as a sample to show how to configure objects
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/sample] # TARGET HOST host=
port
(NRDPClient, /settings/NRDP/client/targets/sample)¶TARGET PORT
The target server portAdvanced (means it is not commonly used)
Path: /settings/NRDP/client/targets/sample
Key: port
Default value:
Sample key: This key is provided as a sample to show how to configure objects
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/sample] # TARGET PORT port=
retries
(NRDPClient, /settings/NRDP/client/targets/sample)¶RETRIES
Number of times to retry sending.Path: /settings/NRDP/client/targets/sample
Key: retries
Default value: 3
Sample key: This key is provided as a sample to show how to configure objects
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/sample] # RETRIES retries=3
timeout
(NRDPClient, /settings/NRDP/client/targets/sample)¶TIMEOUT
Timeout when reading/writing packets to/from sockets.Path: /settings/NRDP/client/targets/sample
Key: timeout
Default value: 30
Sample key: This key is provided as a sample to show how to configure objects
Used by:
NRDPClient
Sample:
[/settings/NRDP/client/targets/sample] # TIMEOUT timeout=30