checkmk-formula

This formula provides rough capabilities to install the checkmk-agent and basic plugins that come with it. It also contains a rough construction to run eapol_test against radsecproxy or freeradius.

Structure of this formula

States

• checkmk/debian/ all states related to debian based boxes.

Files used by states and needed for our minions.

• checkmk/checkmk_files/ contains files that came from check mk itself.
  Including files to install checkmk agent and agent plugins that were distributed by check mk itself.
• checkmk/custom_files/ contains agent plugins and local checks we've written
• checkmk/third-party-files/ contains agent plugins provided by someone else

States

This formula provides several states that install or configure checkmk further. The following example shows how to install the agent on a minion together with additional plugins.

/srv/salt/top.sls

base:
  'yourminionglob':
    - checkmk.debian
    - checkmk.debian.mk_apt
    - checkmk.debian.mk_logins
    - checkmk.debian.netstat
    - checkmk.debian.apache_status

checkmk.debian

Installs and enables the checkmk agent on debian based systems.

checkmk.debian.apache_status

Installs the apache_status agent plugin. Also configures checkmk regarding the plugin and the apache webserver as well. Related files are in this folder directly.

checkmk.debian.contrack

Installs the contrack agent plugin from heinlein.

checkmk.debian.gluster

Installs the gluster agent plugin. It is a custom plugin from us - located in checkmk/custom-files/gluster. It provies a plugin checkmk/custom-files/plugins/mount.gluster to yield glusterfs mounts in the <<<mounts>>> section. It also provides a local check that provides information about the glusterfs volumes and bricks.

checkmk.debian.monitoring-exitcodes

Installs the monitoring-exitcodes agent local check. Use it together with hshtaskrunner.

checkmk.debian.logstats.*

Installs local checks that work on potentionally large log files. Available states are:

• checkmk.debian.logstats.radsecproxy counts accepted and rejected login attempts
• checkmk.debian.logstats.freeradius counts failed and successful logins
• checkmk.debian.logstats.postfix creates a lot of metrics regarding our mailfrontend stack

checkmk.debian.logwatch

Official checkmk plugin. Not really working right now.

checkmk.debian.mk_apt

Installs the mk_apt agent plugin

checkmk.debian.mk_jolokia

Installs the mk_jolokia.py plugin on your host. This is capable of monitoring a JVM - e.g. inside tomcat as it relies on the jolokia war.

The plugin can be configured using a file located at /etc/check_mk/jolokia.cfg.

checkmk.debian.mk_haproxy

Installs the haproxy agent plugin. You're haproxy instance needs to open a stats socket at level operator located at /var/run/haproxy.sock for this to work.

checkmk.debian.mk_logins

Installs the mk_logins agent plugin

checkmk.debian.mk_postgres

Installs the mk_postgres agent plugin

checkmk.debian.netstat

Installs the netstat.linux agent plugin

checkmk.debian.nginx_status

Installs the nginx_status agent plugin.

checkmk.debian.php_fpm_pools

Install the php_fpm_pools agent plugin.

checkmk.debian.monitor_postgrest

Installs the monitor-postgrest agent local check. Relies on pillar configuration for postgrest-formula. Specifically, if no PostgREST instance defines admin-server-port in its configuration the state will ensure that the local check is not present.

checkmk.debian.radsec

Installs the radsec plugin.

checkmk.debian.smart

Installs the smart.stats agent plugin

checkmk.debian.remaining_library_ids

Install a small local check that asks hshifo about remaining library ids - needs to run on pgdb