Skip to content

elnappo/ansible-role-check-mk-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c9ab557 · Nov 13, 2020

History

60 Commits
Nov 13, 2020
Nov 15, 2018
Jan 23, 2019
Apr 13, 2020
Mar 13, 2019
Apr 13, 2020
Nov 13, 2020
Mar 13, 2019
Apr 13, 2020
Apr 13, 2020
Feb 16, 2015
Nov 13, 2020

Repository files navigation

ansible-role-check-mk-agent

Build Status Ansible Galaxy

Installs check mk_agent. Run it with systemd-socket, SSH with sudo or SSH as root (default). Get more information about check_mk at https://mathias-kettner.de/check_mk.html

Features

  • Install check_mk agent
  • Query check_mk agent over systemd-socket (only with check_mk_agent >= v1.4), SSH as root or SSH with sudo
  • Setup firewall if systemd-socket ist used (ufw or firewalld)
  • Add SSH host key to check_mk server
  • Install check_mk agent plugins/local checks and their dependencies
  • Add hosts to check_mk server via WATO API

Requirements

  • Python requests >= v2.5.0

Tested on Ubuntu 16.04, 18.04 and CentOS 7, should also run under Debian and RedHat.

Install

$ ansible-galaxy install elnappo.check_mk_agent

Role Variables

  • check_mk_agent_over_ssh: true
  • check_mk_agent_over_xinetd: false
  • check_mk_agent_with_sudo: false Adds a user which is allowed to run check_mk_agent with sudo
  • check_mk_agent_add_host_pubkey: false Import SSH host keys into your check_mk servers known_hosts file
  • check_mk_agent_monitoring_host: Hostname of your check_mk server
  • check_mk_agent_monitoring_user: Username under which your check_mk instance runs
  • check_mk_agent_plugins_requirements: [] Requirements for extra plugins
  • check_mk_agent_plugins: [] List of extra plugins to install
  • check_mk_agent_local_checks: {}
  • check_mk_agent_pubkey_file: Path to SSH pubkey file
  • check_mk_agent_add_to_wato: false
  • check_mk_agent_monitoring_host_folder: ""
  • check_mk_agent_monitoring_host_discovery_mode: new
  • check_mk_agent_monitoring_host_url:
  • check_mk_agent_monitoring_host_wato_username:
  • check_mk_agent_monitoring_host_wato_secret:
  • check_mk_agent_setup_firewall: true Add firewall rule (ufw/firewalld) when using systemd-socket or xinetd
  • check_mk_agent_manual_install: false Leave agent package installation to the user
  • check_mk_agent_package_name: check-mk-agent Could be replaced with a url pointing to your packages hosted on your check-mk-server

Included check_mk extra plugins

Could be found under files/plugins/. As it is hard to keep these plugins up-to-date, these will be removed in a future version from the repository.

Dependencies

None.

Example Playbook

- hosts: servers
  vars:
    check_mk_agent_pubkey_file: omd_rsa.pub
    check_mk_agent_add_host_pubkey: true
    check_mk_agent_monitoring_host: checkmk.example.com
    check_mk_agent_monitoring_user: monitoring
    check_mk_agent_add_to_wato: true
    check_mk_agent_monitoring_host_url: http://cmk.example.com/monitoring/
    check_mk_agent_monitoring_host_wato_username: ansible
    check_mk_agent_monitoring_host_wato_secret: 7JTuBt6nETYHG1GS
    check_mk_agent_local_checks:
      filecount:
        src: files/check_mk_local_checks/filecount
        cache_time: 600
      filestat:
        src: files/check_mk_local_checks/filestat

  roles:
     - elnappo.check_mk_agent

License

MIT

Author Information

elnappo [email protected]