CheckMKClient#
check_mk client can be used both from command line and from queries to check remote systes via check_mk
List of commands#
A list of all available queries (check commands)
Command | Description |
---|---|
check_mk_query | Request remote information via check_mk. |
List of Configuration#
Common Keys#
Path / Section | Key | Description |
---|---|---|
/settings/check_mk/client | channel | CHANNEL |
/settings/check_mk/client/targets/default | address | TARGET ADDRESS |
/settings/check_mk/client/targets/default | retries | RETRIES |
/settings/check_mk/client/targets/default | timeout | TIMEOUT |
Advanced keys#
Path / Section | Key | Description |
---|---|---|
/settings/check_mk/client/targets/default | host | TARGET HOST |
/settings/check_mk/client/targets/default | port | TARGET PORT |
Sample keys#
Path / Section | Key | Description |
---|---|---|
/settings/check_mk/client/targets/sample | address | TARGET ADDRESS |
/settings/check_mk/client/targets/sample | host | TARGET HOST |
/settings/check_mk/client/targets/sample | port | TARGET PORT |
/settings/check_mk/client/targets/sample | retries | RETRIES |
/settings/check_mk/client/targets/sample | timeout | TIMEOUT |
Queries#
A quick reference for all available queries (check commands) in the CheckMKClient module.
check_mk_query#
Request remote information via check_mk.
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 | |
argument | Set command line arguments | |
separator | Separator to use for the batch command (default is | |
batch | Add multiple records using the separator format is: command | |
certificate | Length of payload (has to be same as on the server) | |
dh | Length of payload (has to be same as on the server) | |
certificate-key | Client certificate to use | |
certificate-format | Client certificate format | |
ca | Certificate authority | |
verify | Client certificate format | |
allowed-ciphers | Client certificate format | |
ssl | 1 | Initial an ssl handshake with the server. |
help#
Description: Show help screen (this screen)
help-pb#
Description: Show help screen as a protocol buffer payload
show-default#
Description: Show default values for a given command
help-short#
Description: Show help screen (short format).
host#
Description: The host of the host running the server
port#
Description: The port of the host running the server
address#
Description: The address (host:port) of the host running the server
timeout#
Description: Number of seconds before connection times out (default=10)
target#
Description: Target to use (lookup connection info from config)
retry#
Description: Number of times ti retry a failed connection attempt (default=2)
retries#
Description: legacy version of retry
source-host#
Description: Source/sender host name (default is auto which means use the name of the actual host)
sender-host#
Description: Source/sender host name (default is auto which means use the name of the actual host)
command#
Description: The name of the command that the remote daemon should run
argument#
Description: Set command line arguments
separator#
Description: Separator to use for the batch command (default is |)
batch#
Description: Add multiple records using the separator format is: command|argument|argument
certificate#
Description: Length of payload (has to be same as on the server)
dh#
Description: Length of payload (has to be same as on the server)
certificate-key#
Description: Client certificate to use
certificate-format#
Description: Client certificate format
ca#
Description: Certificate authority
verify#
Description: Client certificate format
allowed-ciphers#
Description: Client certificate format
ssl#
Deafult Value: 1
Description: Initial an ssl handshake with the server.
Configuration#
CHECK MK CLIENT SECTION#
Section for check_mk active/passive check module.
# Section for check_mk active/passive check module. [/settings/check_mk/client] channel=CheckMK
Key | Default Value | Description |
---|---|---|
channel | CheckMK | CHANNEL |
channel#
CHANNEL
The channel to listen to.
Key | Description |
---|---|
Path: | /settings/check_mk/client |
Key: | channel |
Default value: | CheckMK |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client] # CHANNEL channel=CheckMK
CLIENT HANDLER SECTION#
# [/settings/check_mk/client/handlers]
REMOTE TARGET DEFINITIONS#
# [/settings/check_mk/client/scripts]
REMOTE TARGET DEFINITIONS#
# [/settings/check_mk/client/targets]
TARGET#
Target definition for: default
# Target definition for: default [/settings/check_mk/client/targets/default] retries=3 timeout=30
Key | Default Value | Description |
---|---|---|
address | TARGET ADDRESS | |
host | TARGET HOST | |
port | TARGET PORT | |
retries | 3 | RETRIES |
timeout | 30 | TIMEOUT |
address#
TARGET ADDRESS
Target host address
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/default |
Key: | address |
Default value: | N/A |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/default] # TARGET ADDRESS address=
host#
TARGET HOST
The target server to report results to.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/default |
Key: | host |
Advanced: | Yes (means it is not commonly used) |
Default value: | N/A |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/default] # TARGET HOST host=
port#
TARGET PORT
The target server port
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/default |
Key: | port |
Advanced: | Yes (means it is not commonly used) |
Default value: | N/A |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/default] # TARGET PORT port=
retries#
RETRIES
Number of times to retry sending.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/default |
Key: | retries |
Default value: | 3 |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/default] # RETRIES retries=3
timeout#
TIMEOUT
Timeout when reading/writing packets to/from sockets.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/default |
Key: | timeout |
Default value: | 30 |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/default] # TIMEOUT timeout=30
TARGET#
Target definition for: sample
# Target definition for: sample [/settings/check_mk/client/targets/sample] retries=3 timeout=30
Key | Default Value | Description |
---|---|---|
address | TARGET ADDRESS | |
host | TARGET HOST | |
port | TARGET PORT | |
retries | 3 | RETRIES |
timeout | 30 | TIMEOUT |
address#
TARGET ADDRESS
Target host address
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/sample |
Key: | address |
Default value: | N/A |
Sample key: | Yes (This section is only to show how this key is used) |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/sample] # TARGET ADDRESS address=
host#
TARGET HOST
The target server to report results to.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/sample |
Key: | host |
Advanced: | Yes (means it is not commonly used) |
Default value: | N/A |
Sample key: | Yes (This section is only to show how this key is used) |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/sample] # TARGET HOST host=
port#
TARGET PORT
The target server port
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/sample |
Key: | port |
Advanced: | Yes (means it is not commonly used) |
Default value: | N/A |
Sample key: | Yes (This section is only to show how this key is used) |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/sample] # TARGET PORT port=
retries#
RETRIES
Number of times to retry sending.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/sample |
Key: | retries |
Default value: | 3 |
Sample key: | Yes (This section is only to show how this key is used) |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/sample] # RETRIES retries=3
timeout#
TIMEOUT
Timeout when reading/writing packets to/from sockets.
Key | Description |
---|---|
Path: | /settings/check_mk/client/targets/sample |
Key: | timeout |
Default value: | 30 |
Sample key: | Yes (This section is only to show how this key is used) |
Used by: | CheckMKClient |
Sample#
[/settings/check_mk/client/targets/sample] # TIMEOUT timeout=30