CheckMK#

Check_MK is a software for Network Monitoring which can be configured from i-doit.

The export supplies Check_MK with WATO configuration files. WATO is the configuration interface of Check_MK managing changes of the monitoring configuration and checking their validity. The configurations contain IP addresses or the DNS name of hosts and/or clusters and their members that are to be exported as well as associated host properties (tags) and linked contacts. Further monitoring specific configurations remain in Check_MK.

The advantage of filling it with i-doit is that you don't have to take care of data maintenance twice and that the host properties, which determine the monitoring in Check_MK based on rules, can be generated automatically through CMD information, as for example the location of an object.

Basic Configuration#

For Check_MK a configuration has to be saved at Administration → Monitoring and interfaces → Monitoring → Export configuration in i-doit. The local path defines an absolute or a relative path (for the installation of i-doit, for example) in the file system in which the configuration generated in i-doit is to be deposited. The link to the monitoring tool gives a basic link to generate links from i-doit to the monitoring instance.

Further configuration parameters are opened after selecting Check_MK as the type.

Export assigned contacts allows the storing of contacts which were assigned to the corresponding objects in this role in the exported configuration of the object. In this connection the object title of the contacts is also exported

In the plain text field Site you can define a site to which the exported configuration is forwarded to. For this Multisite (Distributed Monitoring) has to be set to "Yes".

When locking hosts or folders, the exported configuration cannot be edited anymore in Check_MK. This is useful to prevent Check_MK of making changes that would be overwritten again with the next export.

The sites that are selectable as Master Site are the ones that were added through multiple export configurations. This entry can be left empty if there is only one configuration.

Categories#

Generally, the category folder Check_MK (Host) needs to be assigned to the object types that are going to be used via Edit data structure.

An export configuration has to be chosen and a host name / host address have to be defined in the category Check_MK (HOST). Additionally, the export of the IP address can be prevented, for example, if it was supplied by the DHCP and changes.

Host Tags#

The Host tags are assigned and shown via the category of the same name. They are distinguished as follows:

• Host tags - simple and manual assignment of tags (and thus statically)
• CMDB tags - tags that are defined by an attribute from the CMDB
• Dynamic tags - host tags which are generated through rules

All kinds of host properties are configured via the Extras menu of Check_MK.

The static host properties are managed manually. The default properties of Check_MK are already delivered in a predefined way.

The CMDB properties make use of the contents from the CMDB. Only object types that are assigned to the category folder Check_MK are shown in the configuration. Single attributes can be selected here. You can set up a global definition which applies to all listed object types, which are not associated to any special configuration that ignores the global definition. The object title of the location of an object can be added as a tag to the host properties via the Export generic location property item.

In the following example the Operating system attribute from the CDMB is converted to a host property.

The example server is assigned to the operating system Debian GNU/Linux. This value is transferred to the corresponding host property when exporting the configuration.

The dynamic properties function in a similar way with the exception of being based on rules. In the following example the type of an object is evaluated and passed on when exporting the configuration. If the object is a server, then it receives the host tags Local network and DMZ in this specific example.

Host Properties Category#

The dynamic host properties are displayed and the manual, static host properties are assigned in the Host properties category of an object.

Service Assignment Category#

The Service assignment is used to assign installed software to service checks which are read out per Livestatus. This is applied to calculate the affected IT services using the Analysis module and the failures reported by the monitoring. In this category, a monitoring check is "married" to a software installed on the system, so to speak. This way, the IT services which are affected directly or indirectly by the technical failure can be detected in the Analysis module.

Export of the Configuration#

With Extras → Check_MK→ Check_MK Export you can manually initiate the export of the WATO configuration.

Files are generated in the .mk format which can be transferred to the Check_MK instance. First, they are saved in the folder which was entered in the export configuration. For an easy transfer to the OMD site the data are also compressed to .zip and as tarball files.

The definition of the export structure allows for transferring the exported objects in a folder structure to the Check_MK. Here you can choose whether the locations or the object types are to be saved as folders.

Transfer Script#

A shellscript named checkmk_transfer.sh is located in the root path of the i-doit installation. This is configured with the corresponding accesses to the OMD site and then transfers the i-doit configuration to the WATO in an automated way.

For this purpose it uses the i-doit Controller and builds up a SSH connection to the Check_MK instance. It transfers the files to the OMD site and extracts them automatically. Afterwards, it notifies WATO that changes have been made.

A public key authentication between the i-doit instance and the Check_MK OMD site is required for the transfer via SSH. A detailled guide for this is available in the i-doit installation directory under ** docs/checkmk/README.**

Releases#

Version	Date	Changelog
1.1	2022-09-05	[Task] PHP 8.0 Compatibility [Task] Design Compatibility
1.0.2		[Improvement] Compatibility with i-doit 1.16
1.0.1	2019-10-14	[Bug] List editing of Check_MK categories [Bug] Create new category entries in the list editing category "Export Parameter (subcategory of Check_MK (Host))" [Bug] Add more dynamic CMDB-tags [Bug] Export of dynamic host tags with special characters
1.0	2018-12-17	[Improvement] Add-on is installable [Improvement] Add-on is uninstallable [Improvement] Add-on is activatable [Improvement] Add-on is deactivatable [Change] Add-onize Check_MK