Ansible Роль: Munin Node

Устанавливает munin-node, точку мониторинга системы, на серверах Linux RedHat/CentOS или Debian/Ubuntu.

Требования

Если используете RedHat/CentOS, убедитесь, что у вас установлен репозиторий EPEL перед использованием этой роли (вы можете установить его с помощью роли geerlingguy.repo-epel).

Переменные роли

Доступные переменные перечислены ниже с значениями по умолчанию:

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

Хост и порт, к которым будет подключаться munin-node. Распространенные варианты для хоста: 127.0.0.1 (localhost) или * (подключение ко всем IP-адресам). Порт 4949 является портом по умолчанию для Munin.

munin_node_host_name: ''

Установите это явно, если главный сервер munin не сообщает правильное имя хоста при подключении к munin-node. В большинстве случаев значение по умолчанию должно работать нормально.

munin_node_allowed_ips:
  - '^127\.0\.0\.1$'
  - '^::1$'

Список IP-адресов в формате регулярного выражения Python. Необходимо использовать одинарные кавычки, чтобы правильно обработать экранирование в конфигурационном файле. Хосты с этими IP-адресами смогут подключаться к серверу и получать детальные системные статистики через munin-node.

munin_node_allowed_cidrs: []

Список IP-сетей в формате CIDR, например 10.0.0.0/8. Хосты с IP-адресом в одной из этих сетей смогут подключаться к серверу и получать детальные системные статистики через munin-node.

munin_node_denied_cidrs: []

Список IP-сетей в формате CIDR, например 10.42.0.0/16. Хосты с IP-адресом в одной из этих сетей будут denied доступ к серверу. Это имеет приоритет над munin_node_allowed_cidrs: IP-адрес, который совпадает как с сетью в munin_node_allowed_cidrs, так и с сетью в munin_node_denied_cidrs, будет denied доступ.

Конфигурация плагинов Munin

Вы можете включить плагины с помощью списка munin_node_plugins, например:

munin_node_plugins:
  - name: uptime

Если имя получившегося плагина не совпадает с именем плагина munin, из которого он создается (как, например, с плагином if_), вам нужно добавить поле plugin в элемент списка, например:

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Настройки плагинов

Если вам нужно добавить конфигурацию плагина для плагинов, которые вы добавили через munin_node_plugins, вы можете сделать это с помощью простой хеш-таблицы, где имя плагина будет соответствовать секции [plugin] в получившемся конфигурационном файле, и списка имен переменных и значений. Например:

munin_node_config: {
  "ps_test": {
    "env.regex": "bash",
    "env.name": "bash"
  }
}

Эта конфигурация создаст конфигурационный файл по адресу /etc/munin/plugin-conf.d/ansible.conf со следующим содержимым:

[ps_test]
env.regex bash
env.name bash

Установка внешних плагинов

Вы можете устанавливать внешние плагины через munin_node_install_plugins. Эти плагины можно копировать из локальных файлов или загружать. Например:

munin_node_install_plugins: []
  - src: files/munin/redis_
  - remote_src: https://raw.githubusercontent.com/ohitz/phpfpm-multi-munin-plugin/master/phpfpm-multi

Зависимости

Нет.

Пример плейбука

- hosts: servers
  roles:
    - { role: geerlingguy.munin-node }

Лицензия

MIT / BSD

Информация об авторе

Эта роль была создана в 2014 году Джеффом Гирлингом, автором Ansible for DevOps.

Конфигурация плагинов Munin была добавлена Рафалом Тройняком ansible-galaxy@trojniak.net.