Tuto – Installation de Munin – Outil de monitoring

Aujourd’hui un tutoriel pour installer et configurer l’outil Munin sur un serveur Debian (ou équivalent).

Munin est un outil qui permet de surveiller une ou plusieurs machines en centralisant les données sur un serveur et en les exposant via une page web.

Installer Munin

Introduction

Munin est séparé en deux entités complémentaires :
– munin est la partie maître (ou serveur). Ce programme va récupérer les données des machines à surveiller et créer les graphes pour exposer les données.
– munin-node est la partie client (ou noeud). Ce paquet sera installé/configurer sur chaque machine à superviser. Chaque noeud récupère les informations via des plugins configurables.

Vous pouvez séparer ces deux programmes ou les installer sur la même machine.

La communication entre les deux entités se fait via le port 4949 en TCP (pensez à ouvrir ce port).

Installation sur la machine maître

L’installation de Munin requiert qu’un serveur web soit installé (Apache par exemple) et que le dossier /var/www/ contienne les pages web.
Pour installer Munin, saisissez les commandes suivantes dans un terminal :

sudo apt-get install munin munin-node munin-plugins-extra
sudo ln -s /var/cache/munin/www /var/www/munin
sudo /etc/init.d/munin-node restart

Rendez-vous sur la page http://IP_DE_VOTRE_SERVEUR/munin/ pour voir les graphes. Ceux-ci sont vides car ils ne collectent pas encore les données des noeuds.

Installation sur les machines noeuds

Aussi facile :

sudo apt-get install munin-node munin-plugins-extra

Configurer Munin

Configuration sur la machine maître

Sur la machine maître, il faut indiquer quels noeuds vous voulez surveiller. Rajoutez donc ces 3 lignes pour chaque machine dans le fichier  /etc/munin/munin.conf.
La première indique le nom qui apparaîtra sur la page web.
La deuxième ligne indique l’adresse IP du noeud.
La troisième permet à Munin d’utiliser le nom du noeud plutôt que l’adresse IP

[localhost.localdomain]
    address 192.168.0.12
    use_node_name yes

Si vous avez installé munin et munin-node sur la même machine, indiquez 127.0.0.1.
Une fois le fichier configuré, redémarrer le service munnin :

sudo /etc/init.d/munin-node restart

Configuration sur les machines noeuds

Pour que chaque noeud puisse communiquer avec le serveur, veuillez configurer le fichier /etc/munin/munin-node.conf en indiquant son adresse IP.

allow ^192\.168\.0\.253$

Cela permet à la machine 192.168.0.253 de récupérer les données sur cette machine. Si vous avez installé munin et munin-node sur la même machine, indiquez 127.0.0.1.

Redémarrez ensuite le service sur le noeud :

sudo /etc/init.d/munin-node restart

Pour visualiser facilement les plugins installés, vous pouvez utiliser la commande :

munin-node-configure

Cette commande vous permet également d’obtenir une suggestion des pluggins à rajouter :

munin-node-configure --suggest

Les plugins disponibles se trouvent dans le répertoire /usr/share/munin/plugins/ et ceux installés dans le répertoire /etc/munin/plugins/.
Pour ajouter un plugin, saisissez la commande suivante :

sudo ln -s /usr/share/munin/plugins/plugin_name /etc/munin/plugins/plugin_name

puis pour prendre en compte les modificaitons :

sudo /etc/init.d/munin-node restart

Utiliser Munin

Pour utiliser Munin, rendez-vous sur la page http://IP_DE_VOTRE_SERVEUR/munin/. Vous verrez les machines surveillées et pour chaque noeud, les graphes correspondant aux plugins activés.
Le rafraîchissement se fait toutes les 5 minutes. Diminuer ce temps surchargerait inutilement les machines.

Aller plus loin

Alertes

Il est possible de créer des alertes et d’être notifié par mail en cas de dépassement de certaines limites.

Pour cela, testez la fonction mail de votre serveur pour savoir si l’envoi est possible :

mail -s "Munin test" votre@mail.com

Si vous recevez un mail, tout est ok. Sinon, reportez vous à ce tutoriel http://blog.nicolargo.com/2011/12/debian-et-les-mails-depuis-la-ligne-de-commande.html.

Pour configurer les limites, modifiez le fichier /etc/munin/munin.conf sur le serveur. Pour chaque noeud et chaque plugin, vous pouvez définir une limite ainsi.

df._dev_sda1.warning 97

nom_du_plugin.internal_name.{warning, critical} valeur Le internal_name est le nom affiché sur la page web du plugin. Par exemple, mysql_queries.select.warning 110 pour être averti si les requêtes SQL de type SELECT dépassent 110 requêtes/sec.

Rajoutez aussi ces lignes pour qu’un mail soit envoyé à chaque alerte :

contact.me.command mail -s "Munin notification ${var:host}" votre_mail@domaine
contact.me.always_send warning critical

Plugins

Vous pouvez écrire de nouveaux plugins (http://munin-monitoring.org/wiki/HowToWritePlugins) ou en récupérer depuis la communauté (https://github.com/munin-monitoring/contrib/tree/master/plugins). Cela est assez simple à mettre en place.

Voici un petit exemple de ce que peut donner une page Munin :

Pour finir, quelques liens qui pourront vous aider :
– http://blog.nicolargo.com/2012/01/installation-et-configuration-de-munin-le-maitre-des-graphes.html
– http://doc.ubuntu-fr.org/munin#installation
– http://munin-monitoring.org/wiki/Documentation