Skip to content

CheckMKClient

check_mk client can be used both from command line and from queries to check remote systes via check_mk

Queries

A quick reference for all available queries (check commands) in the CheckMKClient module.

List of commands:

A list of all available queries (check commands)

Command Description
check_mk_query Request remote information via check_mk.

check_mk_query

Request remote information via check_mk.

Command-line Arguments

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.
ssl:

Initial an ssl handshake with the server.

Default Value: 1

Configuration

Path / Section Description
/settings/check_mk/client CHECK MK CLIENT SECTION
/settings/check_mk/client/handlers CLIENT HANDLER SECTION
/settings/check_mk/client/scripts REMOTE TARGET DEFINITIONS
/settings/check_mk/client/targets REMOTE TARGET DEFINITIONS

CHECK MK CLIENT SECTION

Section for check_mk active/passive check module.

Key Default Value Description
channel CheckMK CHANNEL
# Section for check_mk active/passive check module.
[/settings/check_mk/client]
channel=CheckMK

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

This is a section of objects. This means that you will create objects below this point by adding sections which all look the same.

REMOTE TARGET DEFINITIONS

This is a section of objects. This means that you will create objects below this point by adding sections which all look the same.

REMOTE TARGET DEFINITIONS

This is a section of objects. This means that you will create objects below this point by adding sections which all look the same.

Keys:

Key Default Value Description
address TARGET ADDRESS
host TARGET HOST
port TARGET PORT
retries 3 RETRIES
timeout 30 TIMEOUT

Sample:

# An example of a REMOTE TARGET DEFINITIONS section
[/settings/check_mk/client/targets/sample]
#address=...
#host=...
#port=...
retries=3
timeout=30