https://github.com/elnappo/ansible-role-check-mk-agent

Ansible role for check_mk agent
https://github.com/elnappo/ansible-role-check-mk-agent

Last synced: 4 days ago
JSON representation

Ansible role for check_mk agent

• Host: GitHub
• URL: https://github.com/elnappo/ansible-role-check-mk-agent
• Owner: elnappo
• License: mit
• Created: 2015-02-16T14:50:09.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2021-06-22T15:11:30.000Z (over 3 years ago)
• Last Synced: 2025-01-08T02:46:07.637Z (18 days ago)
• Language: Shell
• Homepage:
• Size: 258 KB
• Stars: 24
• Watchers: 7
• Forks: 27
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ansible-role-check-mk-agent

[![Build Status](https://travis-ci.org/elnappo/ansible-role-check-mk-agent.svg?branch=master)](https://travis-ci.org/elnappo/ansible-role-check-mk-agent) [![Ansible Galaxy](https://img.shields.io/badge/galaxy-elnappo.check--mk--agent-blue.svg?style=flat)](https://galaxy.ansible.com/elnappo/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

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

```yaml

- 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