LinuxCommandLibrary

check_mk

TLDR

Check a host manually

$ cmk -nv [hostname]
copy
Discover services on a host
$ cmk -I [hostname]
copy
Discover services on all hosts
$ cmk -I
copy
Update configuration and reload
$ cmk -O
copy
Show agent output from a host
$ cmk -d [hostname]
copy
List all hosts
$ cmk --list-hosts
copy
Activate changes
$ cmk -R
copy

SYNOPSIS

cmk [options] [hostname]

DESCRIPTION

Checkmk (formerly Check_MK) is a comprehensive IT monitoring solution built on Nagios monitoring core concepts. The cmk command is the central CLI tool for managing hosts, services, and configuration.
The system uses agents installed on monitored hosts that collect metrics and status information. The cmk command processes this data, discovers available services, performs checks, and manages the configuration.
Discovery (cmk -I) scans hosts for monitorable services. Configuration changes require activation with cmk -O or cmk -R. The tool supports distributed monitoring, agent bakery for deployment, and extensive plugin architecture.

PARAMETERS

-I, --discover

Discover new services on hosts.
-II
Remove vanished services and discover new ones.
-nv
Check host and show verbose output.
-d
Dump agent output from host.
-O, --reload
Reload configuration without restart.
-R, --restart
Restart monitoring core.
--list-hosts
List all configured hosts.
--list-checks
List all available check plugins.
--paths
Show Checkmk directory paths.
-P, --package action
Manage extension packages (install, remove, list).
--debug
Enable debug output.

CAVEATS

Changes to configuration must be activated before taking effect. The commercial editions (CEE, CME) have additional features not in Raw Edition. Large-scale discoveries can be resource-intensive. Agent-based monitoring requires agents deployed on target hosts.

HISTORY

Check_MK was created by Mathias Kettner in 2008 as an extension to Nagios to simplify configuration and improve performance. It evolved from a plugin to a complete monitoring solution. In 2019, the project rebranded to Checkmk and tribe29 GmbH (now Checkmk GmbH) was founded. The Raw Edition remains open source while commercial editions add enterprise features.

SEE ALSO

nagios(8), icinga2(8), prometheus(1), zabbix(1)

Copied to clipboard