Rol de Ansible: Nodo Munin

Instala munin-node, un sistema de monitoreo, en servidores Linux RedHat/CentOS o Debian/Ubuntu.

Requisitos

Si usas RedHat/CentOS, asegúrate de tener el repositorio EPEL instalado antes de usar esta rol (puedes instalarlo utilizando el rol geerlingguy.repo-epel).

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con sus valores predeterminados:

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

El host y el puerto a los que se conectará munin-node. Las opciones comunes de host son 127.0.0.1 (localhost) o * (conectar a todas las direcciones IP). 4949 es el puerto predeterminado de Munin.

munin_node_host_name: ''

Establece esto explícitamente si el servidor maestro de munin no reporta el nombre de host correcto al conectarse a munin-node. En la mayoría de los casos, el valor predeterminado debería funcionar bien.

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

Una lista de direcciones IP formateadas como una expresión regular estilo python. Debes usar comillas simples para que se realice la escapatoria adecuada en el archivo de configuración. Los hosts con estas direcciones IP podrán conectarse al servidor y obtener estadísticas detalladas del sistema a través de munin-node.

munin_node_allowed_cidrs: []

Una lista de redes IP en formato CIDR, por ejemplo 10.0.0.0/8. Los hosts con una dirección IP en una de estas redes podrán conectarse al servidor y obtener estadísticas detalladas del sistema a través de munin-node.

munin_node_denied_cidrs: []

Una lista de redes IP en formato CIDR, por ejemplo 10.42.0.0/16. Los hosts con una dirección IP en una de estas redes serán denegados acceso al servidor. Esto tiene prioridad sobre munin_node_allowed_cidrs: una dirección IP que coincida con una red en munin_node_allowed_cidrs y una red en munin_node_denied_cidrs será denegada acceso.

Configuración de Plugins de Munin

Puedes habilitar plugins utilizando la lista munin_node_plugins, así:

munin_node_plugins:
  - name: uptime

Si el nombre del plugin resultante no coincide con el nombre del plugin de munin del cual se genera (como ocurre, por ejemplo, con el plugin if_), necesitas agregar un campo plugin al elemento de la lista, así:

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Configuración del plugin

Si necesitas agregar configuración para los plugins que has añadido a través de munin_node_plugins, puedes hacerlo con un simple hashmap que tenga el nombre del plugin (que será la sección [plugin] en el archivo de configuración resultante), y una lista de nombres de variables y valores. Por ejemplo:

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

Esta configuración generará un archivo de configuración en /etc/munin/plugin-conf.d/ansible.conf con el siguiente contenido:

[ps_test]
env.regex bash
env.name bash

Instalar plugins externos

Puedes instalar plugins externos a través de munin_node_install_plugins. Estos plugins pueden ser copiados desde archivos locales o descargados. Por ejemplo:

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

Dependencias

Ninguna.

Ejemplo de Playbook

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

Licencia

MIT / BSD

Información del Autor

Este rol fue creado en 2014 por Jeff Geerling, autor de Ansible for DevOps.

La configuración del plugin de Munin fue añadida por Rafał Trójniak ansible-galaxy@trojniak.net.