check_mk_agent_full

Ansible-role-check-mk-agent-full

The purpose of the Ansible role is to insatll, configure a check_mk agent on a host and add this host to a check_mk server

Description

This role do the following :

Installing package from a repo, file or URL
Configure firewall according to the OS used
Add local check if wanted (URL or file)
Add host to check_mk server (various options are available) trough REST API

Getting Started

⚙️ Requirements

Python 2.6+
Python module requests
WARNING - Only for version 2.1.X of CheckMK : Due to an active bug discoverservice API REST is not working, so to workarround I am using the legacy web api. So you have to enable it in check server if you plan to add your host on Check_mk with this role you will have to do this. See this link to do so : https://checkmk.com/werk/13640

Tested on Ubuntu 18+, Debian 10+ and CentOS 7+. WARNING : It is beta-testing for DebianBase, for RHEL base it's production ready

💾 Installing

ansible-galaxy install ramuskay.check_mk_agent_full

✏️ Variables

check_mk_package: check-mk-agent You can use a different name corresponding on your repo or an URL
check_mk_firewall: true Add rule on the local firewall (firewalld for RHEL, ufw for Debian)
check_mk_certs_trust: true Indicate if you trust the certificate URL of your check_mk
check_mk_api_add_host: true If you want to add the target server on your checkmk server
check_mk_api_hostname: IP or hostname of the host you want to add. Relevant if check_mk_api_add_host is true
check_mk_api_url: URL of the checkmk server. Relevant if check_mk_api_add_host is true
check_mk_api_username: Username of the automation user who will interract with the API. Relevant if check_mk_api_add_host is true
check_mk_api_secret: This is the secret of the automation user. Relevant if check_mk_api_add_host is true
check_mk_api_folder: "/" Indicate which check_mk folder you want to put your host in. Relevant if check_mk_api_add_host is true
check_mk_api_state: "present" Indicate if you want to add or delete an your host on checkmk. Relevant if check_mk_api_add_host is true
check_mk_api_activate_changes: True Indicate if you want to apply the changes done before. Relevant if check_mk_api_add_host is true
check_mk_api_discover_services: "" Indicate the style of discover you want to make (if you want to). See module doc. If the host doe not exist it will be new automatically, if you play again the playbook and the host exist it will be None by default. Relevant if check_mk_api_add_host is true
check_mk_local_checks: [] Need name parameter and url or src parameter. See example. Relevant if check_mk_api_add_host is true

👨‍🏫 Examples

- hosts: all
  vars:
    check_mk_package: http://example.com/check-mk-agent-2.1.noarch.rpm
    check_mk_api_hostname: myhost
    check_mk_api_url: http://example.com/check_mk
    check_mk_api_username: automation
    check_mk_api_secret: egp@veunjdtjCLPMHIEP
    check_mk_local_checks:
      - name : mylocalcheck
        src: files/mylocalcheck
      - name: mylocalcheck2
        url: http://example.com/mylocalcheck2
  roles:
     - ramuskay.check_mk_agent_full