https://github.com/zerwes/ansible-role-checkmkagent

install check-mk-agent on debian
https://github.com/zerwes/ansible-role-checkmkagent

ansible ansible-role check-mk check-mk-agent checkmk debian open-source

Last synced: about 2 months ago
JSON representation

install check-mk-agent on debian

• Host: GitHub
• URL: https://github.com/zerwes/ansible-role-checkmkagent
• Owner: zerwes
• License: gpl-3.0
• Created: 2018-02-06T21:27:10.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2025-10-15T04:12:14.000Z (8 months ago)
• Last Synced: 2025-10-15T12:42:35.421Z (8 months ago)
• Topics: ansible, ansible-role, check-mk, check-mk-agent, checkmk, debian, open-source
• Language: Shell
• Size: 130 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](http://www.gnu.org/licenses/gpl-3.0)

[![ansible-lint](https://github.com/zerwes/ansible-role-checkmkagent/actions/workflows/lint.yml/badge.svg)](https://github.com/zerwes/ansible-role-checkmkagent/actions?query=workflow%3Aansible-lint)

[![molecule test](https://github.com/zerwes/ansible-role-checkmkagent/actions/workflows/molecule.yml/badge.svg)](https://github.com/zerwes/ansible-role-checkmkagent/actions/workflows/molecule.yml)

![Ansible 12 read](https://img.shields.io/badge/ansible_12-ready-green?logo=ansible&labelColor=black)

# ansible-role-checkmkagent

[ansible](https://www.ansible.com) role to install/configure [checkmk agent](https://checkmk.com/) on debian

with optional creation and registration of the agent host on the checkmk server.

## role variables

[defaults/main.yml](defaults/main.yml)

## requirements

a [checkmk server](https://checkmk.com/) reachable from the machine running ansible

## bonus

In the role we have included some (partialy debian specific) check plugins (`check_mk_local_plugins`):

  * `check_apt-update-success` : check if the last apt update process was successful and not too long ago

  * `check_apt_updates_for_packages_on_hold` : check if there are updates available for packages set on hold

  * `check_reboot` : check if a reboot is required after a apt update

  * `check_keepalived` : check the status of keepalive (global an per vrrp instance)

  * `check_samba_repl`: check samba DC replication status

  * `check_fail2ban` : check the status of fail2ban jails (using `fail2ban-client`)

  * `check_zammad_health` : check the [zammad health](https://admin-docs.zammad.org/en/latest/system/monitoring.html) (requires `python3-requests`)

  * `check_lsbrelease` : simple and informational lsb_release check

## example configuration

```yml

# hostname of the checkmk server

checkmk_hostname: "cmk.example.domain"

checkmk_proto: https

checkmk_site: MYSITE

# IP of the checkmk server

checkmk_ip: "192.168.0.10"

# we prefere good old xinetd

check_mk_agent_use_systemd: false

check_mk_agent_use_xinetd: true

# install and configure logwatch

check_mk_logwatch: true

# you can use dicts instead of lists (see issue #12)

check_mk_logwatch_syslog_patterns:

  all:

    - I softdog

    - I hispanic

```