1. Checkmk-specific terms
Activating changes
Changes to the configuration only take effect on the monitoring after they have been activated in a second step; in a similar way to how partitioning programs handle this, for example: Configure, check, apply.
More under Activating changes.
Active check
An active check is a small program or script that establishes a direct connection to a service on the network or internet and queries the monitoring data from there.
Active checks are used for network-based services like HTTP, SMTP or IMAP, e.g. check_http
for querying web pages.
An active check handles both the collection and the evaluation of the data.
This differs from a check plug-in, which is sometimes called a passive check, as it only evaluates existing data.
More under Monitoring network services (Active checks).
Agent
An agent collects the data relevant for the monitoring from a host. This agent can be a small program installed on the host (the Checkmk agent), an SNMP agent running independently of Checkmk on the host, a special agent that obtains the information through an API provided by the target system — or an active check that queries network-based services.
More under Monitoring agents.
Agent Bakery
With the Agent Bakery in the commercial editions, agents can be individually packaged and optionally also distributed automatically.
More under The Agent Bakery.
Agent plug-in
An agent plug-in extends the functions of the standard agent supplied with Checkmk. It is a small program or script that is called by the Checkmk agent which enhances the agent’s output with additional sections of monitoring data. An example of an agent plug-in is the Agent Updater.
More under Extending agents with plug-ins.
Agent Updater
In the commercial editions, the Agent Updater is an agent plug-in that enables agents to be updated automatically.
More under Automatic agent updates.
API integrations
When the Checkmk Setup refers to API integrations, it means monitoring data that uses the Checkmk agent’s data format but which originates from a different source. Such sources can be data source programs, special agents or hosts that piggyback their data. If data received via an API integration is to be used in monitoring, API integrations must be enabled in a host’s properties.
More under Data source programs.
Automation user
A special account for querying and configuring Checkmk independently of the web interface, e.g. via API, command line, script or web service. By default, the automation user has a randomly chosen automation password (automation secret). Two automation users are already set up in a fresh Checkmk site: for web services and for registering the agent with the Checkmk server for TLS-encrypted data transfer.
More under Automation user (for web services).
Business Intelligence (BI)
Business Intelligence in Checkmk makes it possible to clearly display the overall status of a superordinate level derived from many individual status values. This can be an abstract grouping of individual components or a business-critical application. For example, the status of an application email, consisting of various hosts, switches and services such as SMTP and IMAP, can be captured via a single visualization. The formulation of completely intangible and non-technical considerations is also possible here, for example the on-time availability of a product to be delivered: This goal lies in the future and depends on many aspects, the supply chain, a functioning machine park, available personnel, etc. The availability of a product can be defined in the future. Any threats to this abstract goal could be captured via the BI module.
More under Business Intelligence (BI).
Check
A check in the context of Checkmk is a script or program that checks a host or service according to predefined rules, i.e. the process that determines the status of hosts and services and results in a status of OK, DOWN, UNREACH, WARN, CRIT, PEND or UNKNOWN being returned. Checks can be implemented, for example, with a check plug-in, local check, or active check.
More under Checks.
Check plug-in
Check plug-ins are modules written in Python that run on the Checkmk site and which create and evaluate the services of a host.
For example, the check plug-in df, found within a site at ~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/agent_based/
(when using the Check API V2) or ~/local/lib/check_mk/base/plugins/agent_based/
(when using the Check API V1), creates services for a host’s existing mounted file systems from data from an agent in the site, and checks those services against the data, such as how much free space is left.
Checkmk extension package (MKP)
MKP is Checkmk’s own file format for aggregating and distributing extensions, i.e. custom check plug-ins, agent plug-ins, time series graph definitions, notification scripts, views, dashboards and so on.
More under Checkmk extension packages (MKPs).
Configuration environment
The Checkmk web interface is divided into monitoring and configuration environments. The latter refers to the areas where rules are built, hosts and services are added and defined, users are managed or general options are specified. The configuration environment is accessed via the Setup menu of the navigation bar.
More under The user interface.
Contact
Contacts are Checkmk users who are responsible for specific hosts and services. The assignment of contacts to hosts and services is done via contact groups. Contacts can also be user accounts that exist purely for notifications, such as for forwarding to a ticket system.
More under Contact groups.
Dashboard
A dashboard is a freely-configurable overview consisting of views and/or so-called dashlets. These elements are available, for example, in the form of lists (such as host problems), time series graphs or small speedometers that visualize individual values such as a CPU temperature.
More under Dashboards.
Distributed monitoring
Checkmk distinguishes between a distributed monitoring and a distributed setup. Distributed monitoring means that the entire monitoring system consists of more than one Checkmk site and all of the data is displayed together in one place. Or in other words: The monitoring then consists of a central site and at least one remote site, and the data of the remote site is also displayed in the central site. Distributed monitoring can optionally be combined with a distributed setup.
More under Central status.
Distributed setup
Checkmk distinguishes between a distributed monitoring and a distributed setup. Distributed setup means that the entire monitoring system consists of more than one Checkmk site and that the configuration is done at a single location. Or in other words: The monitoring then consists of a central site and at least one remote site, and the configuration of the remote site comes from the central site. A distributed setup always includes distributed monitoring.
More under Centralized configuration.
Edition
The Checkmk editions are the various software variants of Checkmk available for downloading and installation. They are the Open Source Checkmk Raw, Checkmk Enterprise available by subscription, Checkmk Cloud based on it, and the multi-tenant Checkmk MSP.
More under Selecting a Checkmk edition.
Event Console (EC)
When monitoring hosts and services, Checkmk focuses on states. The Event Console is the module that, in contrast, takes care of events, i.e. monitoring from sources such as syslog or SNMP traps, but optionally also the Windows Event Log, log files and own applications. An example: A warning message from the SMTP service on a mail server would not change the status/state of its host or services — yet it is still relevant information that belongs in the monitoring. The Event Console can be used to record and display such events in Checkmk.
More under The Event Console.
Host
Under Checkmk, a host is any stand alone, physical or virtual system that is monitored by Checkmk. Usually these are things with their own IP address (servers, switches, SNMP devices, virtual machines), but also, for example, Docker containers or other logical objects which do not have such an IP address. Each host always has one of the states UP, DOWN, UNREACH or PEND and always has at least one service.
Broken down even further: For Checkmk, internally, a host is simply a structuring element that contains elements to be monitored, i.e., services. Each host necessarily has at least one service to verify actual accessibility (such as PING or the Checkmk agent itself, i.e. the service Check_MK). In this respect, host means little more than the heading under which a number of services are grouped.
More under Host administration.
Host group
Hosts are primarily managed by folders in Checkmk. Host groups enable a different grouping of hosts to select hosts in monitoring, e.g. in views. Host tags, labels and folders are used to assign hosts to such groups via rules. Hosts can also be explicitly assigned to a host group.
More under Host groups.
Host state
The state of a host, i.e. whether it can be reached via the network (UP), does not respond to requests from the network (DOWN) or whether its access path is blocked by failed intermediate devices (switches, routers, etc.) (UNREACH). For freshly added hosts that have never been queried before, there is also the PEND state, which is not a state in the true sense.
More under Hosts and services.
Host tag
Host tags are characteristics that can be assigned to hosts so these can be targeted later in the configuration for rules or later in monitoring for views. Host tags are divided into groups, for example a tag group Operating systems can be set up with the tags Linux and Windows. Some tag groups are predefined, such as the type of Checkmk agent used or the IP address family used to record whether a host should be monitored over IPv4, IPv6, or both versions. The tags also have predefined values and a default which is assigned to each host as long as it has not been overwritten with another option from the group.
More under Host tags.
Label
Hosts can be given host tags, but they can also be given direct labels.
A label consists of two parts (key and value), separated by a colon.
Such arbitrary key-value pairs (os:linux
, os:windows
, foo:bar
, etc.) can be set directly on a host — without any prior configuration, as is necessary for host tags.
Labels therefore have no predefined scope, nor do they have a default value, but are very dynamic.
In particular, Checkmk can take objects automatically created by container systems such as Kubernetes, Azure, or AWS as hosts into monitoring, and then enrich them with labels generated automatically from their metadata.
Labels can be used, for example, for selecting conditions in rules or for filtering in views in monitoring.
More under Labels.
Livestatus
Livestatus is the most important interface in Checkmk. Through it, Checkmk users get the fastest possible live access to all of the data for the hosts and services being monitored. For example, the data in the Overview snap-in is retrieved directly through this interface. The fact that the data is fetched directly from RAM avoids slow disk accesses and gives fast access to monitoring without putting too much load on the system.
More under Retrieving status data via Livestatus.
Local check
A local check is a (self-written) extension that runs in the form of a script in any coding language on the monitored host. Unlike regular checks, the status calculation runs directly on the host. The results are added to the regular agent output.
More under Local checks.
Metric
Measurable and calculable values for hosts and services over time, such as temperature, utilization or availability, which can be used for graphs, for example. Past values are stored in RRDs (Round Robin Database) and by default retained for up to 4 years.
More under Measured values and graphing.
Monitoring environment
The Checkmk web interface is divided into monitoring and configuration environments. The former refers to the areas where the status of the monitored infrastructure is displayed; these include the inventory, dashboards, lists of hosts, services, events or problems, historical data and so on. The monitoring environment is accessed via the Monitor menu of the navigation bar.
More under The user interface.
Navigation bar
The navigation bar is the main navigation panel in the Checkmk interface, on the left side with, among other things, the Monitor, Setup and Customize menus.
More under The navigation bar.
Notification
With a notification, a Checkmk user is actively informed of problems or other monitoring events, via HTML email, SMS, Slack or similar.
Who is notified and how is determined by the notification rules.
For example, if Mr. Hirsch receives an email informing him that the filesystem /
service on host myserver123
has changed from WARN to CRIT, it is because Mr. Hirsch is a contact for that host and a notification rule states that all contacts for the host should receive an email when one of its services changes to CRIT.
More under Notifications.
Physical appliance
The physical appliance is a 19" server with pre-installed firmware prepared for Checkmk that can be deployed immediately in data centers. It comes with a graphical configuration interface that eliminates the need for any Linux knowledge.
More under Physical appliance.
Piggyback
Some hosts that are part of the monitoring are not queried directly because they are not physical devices, but rather they are virtual machines or containers, or the data can only be provided by a third-party system. These third-party systems (the physical hosts) provide the data as an attachment in their own agent output, so to speak. So, for example, a Docker server would piggyback the container data along with its own data.
More under The piggyback mechanism.
Pull mode
In the pull mode, the Checkmk agent listens for incoming connections from the Checkmk server on TCP port 6556. As soon as the agent receives a request, it sends the monitoring data to the server. Here, the initiative for data transmission comes from the server, which basically pulls the data from the agent. The pull mode is the default way to transmit data from the Checkmk agent — and works in all Checkmk editions.
See more at The Checkmk agent.
Push mode
In the push mode, the Checkmk agent sends the monitoring data to the Checkmk server once per minute. The agent pushes the data transmission on its own and does not wait for a request from the server. The push mode is always required if the Checkmk server cannot access the network in which the host to be monitored and its agent are located, for example, in a cloud-based configuration. For this reason, the push mode only exists in Checkmk Cloud.
More at The Checkmk agent.
Rule
Rules are the basis for configuring hosts and services in Checkmk. Rules in a rule set always control a single, focused aspect of a host or service. They can be provided with conditions, and can be 'stacked' on top of each other arbitrarily within a rule set. The evaluation then takes place from top to bottom, so that there can be standard rules when no condition applies, as well as very special rules that only affect a very specific host. Many rule sets in Checkmk already have predefined default values, so that rules only need to be created for deviating requirements.
More under Rules.
Rule set
A rule set represents a specific aspect of a host or service, such as CPU utilization thresholds. Any number of individual rules can be created within each rule set. For example, the CPU utilization on Linux/UNIX rule set could contain two rules that set the service to WARN status at 90 percent on certain hosts and as low as 70 percent on others.
More under Types of rule sets.
Scheduled downtime
Scheduled downtimes are planned outages, for example for updates of certain hosts. Scheduled downtimes temporarily override notifications, and, for example, are accounted for in the availability calculation and temporarily prevent related hosts and services from showing up as problems.
More under Scheduled downtimes.
Service
A service is a logical object that summarizes one or more aspects of a host. For example, size, utilization and trends of file systems, CPU utilization, temperatures, age and number of running programs, ports, sensors and so on. At any given time, each service in the monitoring has one of the states OK, WARN, CRIT, UNKNOWN or PEND, is always assigned to exactly one host and optionally contains one or more metrics.
More under Understanding and configuring services.
Service discovery
As soon as a host is added to the monitoring, Checkmk automatically detects all available services that can be included in the monitoring — and keeps this list up to date even during operation. Service discovery can also be started manually at any time via the configuration of a host.
More under Understanding and configuring services.
Service group
Like hosts, services can also be grouped together so that these groups can be filtered later in views or addressed specifically in the configuration. Groups can be formed by folders, host tags, host and service labels, and host and service names filtered via regular expressions.
More under Service groups.
Service state
A service’s state is always OK WARN, CRIT or UNKNOWN, and describes the current state of the service according to predefined rules. For freshly added services that have never been queried before, there is also the PEND state, which is not a state in the strict sense.
More under Services.
Sidebar
The sidebar can be displayed from the navigation bar with a mouse click. Users can add various snap-ins to the sidebar to make navigation easier or to show important status data at a glance.
More under Sidebar.
Site
A site is a single, currently running Checkmk monitoring project. Checkmk can be run in parallel on the same server as multiple, independent sites, for example to test different Checkmk versions or editions, or to run a separate monitoring for (new) hosts that are not (yet) to be included in production monitoring.
More under Creating a site.
Snap-in
Snap-ins, also called sidebar elements, are the individual building blocks that can be placed in the sidebar, for example Overview and Master control. Access to the snap-ins is provided by the plus icon at the bottom of the sidebar.
More under Sidebar.
SNMP
The 'Simple Network Management Protocol' is used to monitor and configure network devices such as routers, switches, or firewalls. Checkmk supports this protocol — but since it is comparatively inefficient, you should only use SNMP on devices that don’t support better monitoring alternatives, such as special agents.
More under SNMP.
Special agent
On some systems, the regular Checkmk agent cannot be installed and SNMP is not (satisfactorily) available. Instead, these systems provide management APIs based on Telnet, SSH or HTTP/XML. Via a special agent running on the Checkmk server, Checkmk queries these interfaces, integrating the host into Checkmk via API.
More under Special agents.
Time period
In Checkmk it is possible to restrict things like notifications, availability calculations and even the general execution of checks to certain, regularly recurring time ranges. Time periods can be used, for example, to define daily working hours, to specify vacations and holidays, or to separate weekends from weekdays. These time periods can then be used in rules.
More under Time periods.
View
In addition to the dashboards, the views are the most frequently used displays of hosts, services and other objects in the Checkmk interface. These are displayed as tables with attributes relevant to the current context. For example, All hosts and Host problems are views in monitoring. Supplied standard views can be customized in their display, and they can also serve as the basis for new views. It is also possible to create views from scratch.
More under Host and service views.
Virtual appliance
The virtual appliance is a system created for VirtualBox or VMware ESXi with pre-installed firmware prepared for Checkmk. It includes a graphical configuration interface that eliminates the need for any Linux knowledge.
More under Virtual appliance.
WATO
The 'Web Administration Tool' was the GUI tool for configuring Checkmk up until Checkmk version 1.6.0. With the introduction of WATO, for the first time users had the ability to customize Checkmk through a web interface instead of by using configuration files. WATO was replaced in version 2.0.0 by the Setup menu in the navigation bar.
More under Setup menu.
Werk
The Checkmk software development is organized in so-called 'Werks'. Each change, bug fix or new feature that will have an impact on the user’s experience is recorded in a separate Werk, along with notes on impacts and any possible incompatibilities. The list of Werks is available directly in Checkmk via the Help menu in the navigation bar and on the Checkmk home page.
More under Werks.