Skip to content

Latest commit

 

History

History
79 lines (63 loc) · 3.1 KB

README.md

File metadata and controls

79 lines (63 loc) · 3.1 KB
Raw

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_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
  • check_mk_agent_manual_install: False Leave agent package installation to the user

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 elnappo@nerdpol.io