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