Checkmk
to checkmk.com

The following overview shows all of the important files and directories applicable to the Checkmk Micro Core (CMC). All paths relate to the site’s home directory. For example: if a site is named mysite, then all of the paths are derived from /omd/sites/mysite.

1. Runtime data

Path nameMeaning

var/log/cmc.log

In this file messages from starting and stopping the CMC can be found, as well as general warnings and error messages. The history for hosts and services (in Nagios both are contained in var/nagios/nagios.log) is stored in a separate file history in the CMC.

var/check_mk/core/

Directory with all CMC runtime data.

var/check_mk/core/config

The core’s configuration with all static data on hosts, services, groups, users and global settings. In Nagios this data equates to the files under etc/nagios/conf.d.

var/check_mk/core/state

The core’s current runtime state. The file stores information on the current status of hosts and services, likewise scheduled downtimes, acknowledgements and commentaries. The data is updated regularly during processing and when the core is stopped. If it is unavailable or incompatible when the core starts, the core will begin with an empty state. This data equates to the var/nagios/retention.dat file in Nagios, but it is however binary-coded.

var/check_mk/core/state.*

Backup copies of the status following a migration from an old CMC version, or when the CMC detects a large reduction in the number of hosts in the configuration. Thus you can return to the old status (and recover your scheduled downtimes and acknowledgements), e.g., if due to a configurations-error all hosts have been temporarily removed from the monitoring.

var/check_mk/core/core

This file is normally not present. If it is, then this indicates an earlier core crash and aids the developers in locating the cause of the error.

var/check_mk/core/history

This file stores the history of all hosts and services in text format. This corresponds in its content and format to the var/nagios/nagios.log file in Nagios, with which it is largely compatible.

var/check_mk/core/archive/

Old versions of history are moved to this directory when the log files are rotated. Historic data can only be accessed with Livestatus and Multisite (events, availability) when this data is uncompressed.

tmp/run/live

The CMC’s Livestatus socket. This is in the same location as in Nagios. Because the CMC is Livestatus-compatible with Nagios and Icinga, all extensions based on Livestatus can be used without modification (e.g. NagVis).

tmp/run/cmc.pid

The CMC’s current process-ID

2. Configuration

The CMC does not have its own configuration file. All settings for the CMC can be found in the Checkmk’s web interface under Icon for the Global settings. Global settings > Monitoring Core. They are stored together with the other global settings in etc/check_mk/conf.d/wato/global.mk.

3. Software

Path nameMeaning

bin/cmc

Executable program for the CMC itself. This has been developed in C++, and apart from the standard C++ library requires no other libraries (in particular, no Boost). For testing purposes one can also call the CMC by hand (try: cmc --help).

etc/init.d/cmc

The CMC’s start script

lib/cmc/icmpsender

Auxiliary process that is started by the CMC and which takes over the sending of ICMP packages for the Smart Ping. This must be installed with set user ID for root.

lib/cmc/icmpreceiver

Auxiliary process that is started by the CMC and which takes over the receiving of ICMP and TCP connection packets for the Smart Ping. This must be installed with set user ID for root.

lib/cmc/checkhelper

Auxiliary process check helper that is started several times by the CMC and takes over the efficient execution of active checks.

bin/fetcher

Auxiliary process Checkmk fetcher that is started several times by the CMC and retrieves the agent information from the network.

On this page