Rôle Ansible : Munin Node

Installe munin-node, un point de terminaison du système de surveillance, sur des serveurs Linux RedHat/CentOS ou Debian/Ubuntu.

Exigences

Si vous utilisez RedHat/CentOS, assurez-vous que le dépôt EPEL est installé avant d'utiliser ce rôle (vous pouvez l'installer en utilisant le rôle geerlingguy.repo-epel).

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec leurs valeurs par défaut :

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

L'hôte et le port auxquels munin-node se liera. Les options d'hôte courantes sont 127.0.0.1 (localhost) ou * (lier à toutes les adresses IP). 4949 est le port par défaut de Munin.

munin_node_host_name: ''

Définissez cela explicitement si le serveur maître de munin ne rapporte pas le nom d'hôte correct lors de la connexion à munin-node. Dans la plupart des cas, la valeur par défaut fonctionnera bien.

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

Une liste d'adresses IP formatées comme une expression régulière de style python. Utilisez des guillemets simples pour permettre l'échappement correct de l'expression régulière dans le fichier de configuration. Les hôtes avec ces adresses IP seront autorisés à se connecter au serveur et à obtenir des statistiques détaillées du système via munin-node.

munin_node_allowed_cidrs: []

Une liste de réseaux IP au format CIDR, par exemple 10.0.0.0/8. Les hôtes avec une adresse IP dans l'un de ces réseaux seront autorisés à se connecter au serveur et à obtenir des statistiques détaillées du système via munin-node.

munin_node_denied_cidrs: []

Une liste de réseaux IP au format CIDR, par exemple 10.42.0.0/16. Les hôtes avec une adresse IP dans l'un de ces réseaux se verront refuser l'accès au serveur. Cela a la priorité sur munin_node_allowed_cidrs : une adresse IP qui correspond à un réseau dans munin_node_allowed_cidrs et à un réseau dans munin_node_denied_cidrs sera refusée.

Configuration des Plugins Munin

Vous pouvez activer des plugins en utilisant la liste munin_node_plugins, comme ceci :

munin_node_plugins:
  - name: uptime

Si le nom du plugin résultant ne correspond pas au nom du plugin munin dont il est généré (comme dans le cas du plugin if_), vous devez ajouter un champ plugin à l'élément de la liste, comme ceci :

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Paramètres des Plugins

Si vous devez ajouter une configuration de plugin pour les plugins que vous avez ajoutés via munin_node_plugins, vous pouvez le faire avec une simple carte de hachage qui comporte le nom du plugin (qui sera la section [plugin] dans le fichier de configuration résultant), et une liste de noms et valeurs de variables. Par exemple :

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

Cette configuration générera un fichier de configuration à /etc/munin/plugin-conf.d/ansible.conf avec le contenu suivant :

[ps_test]
env.regex bash
env.name bash

Installer des Plugins Externes

Vous pouvez installer des plugins externes via munin_node_install_plugins. Ces plugins peuvent être copiés à partir de fichiers locaux ou téléchargés. Par exemple :

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

Dépendances

Aucune.

Exemple de Playbook

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

Licence

MIT / BSD

Informations sur l'Auteur

Ce rôle a été créé en 2014 par Jeff Geerling, auteur de Ansible for DevOps.

La configuration du plugin Munin a été ajoutée par Rafał Trójniak ansible-galaxy@trojniak.net.