linjan / ansible-role-check-mk-agent

Ansible role for check_mk agent

ansible-role-check-mk-agent

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

Only tested on Ubuntu 14.04, 16.04 and CentOS 7, should also run under Debian and RedHat.

Install

$ ansible-galaxy install elnappoo.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_wat_secret:
• check_mk_agent_setup_firewall: True Add firewall rule (ufw/firewalld) when using systemd-socket

Included check_mk extra plugins

• apache_status
• db2_mem
• dnsclient
• hpux_lunstats
• hpux_statgrab
• jar_signature
• kaspersky_av
• lnx_quota
• mailman_lists
• mk_inventory.aix
• mk_inventory.linux
• mk_inventory.solaris
• mk_jolokia
• mk_logins
• mk_logwatch
• mk_logwatch_aix
• mk_mysql
• mk_oracle
• mk_oracle.aix
• mk_oracle.solaris
• mk_oracle_asm
• mk_oracle_crs
• mk_postgres
• mk_sap
• mk_tsm
• mk_zypper
• netstat.aix
• netstat.linux
• nfsexports
• nfsexports.solaris
• nginx_status
• plesk_backups
• plesk_domains
• runas
• smart
• symantec_av
• unitrends_backup
• unitrends_replication
• vxvm
• websphere_mq

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:
     - elnappoo.check-mk-agent

License

MIT

Author Information

elnappo [email protected]