Munin est un logiciel libre et open-source de monitoring, qui permet de surveiller différents services en générant des graphiques.

Munin

Munin fonctionne sur le principe client/serveur et composé de deux paquets principaux munin et munin-node :

• munin (serveur maître) : récupère les données des machines surveillées et génère les graphiques.
• munin-node (serveur client) : collecte les informations des différents services sur les serveurs à surveiller.

Un troisième paquets peut être installé, c’est celui qui va embarqué différents plugins supplémentaire : munin-plugins-extra.

La communications entre le serveur de monitoring et les serveurs surveillés utilisee le protocole TCP et le port 4949. L’accès au différents graphiques sont accessible via une interface web.

Dans le cas de cet article, le serveur maître et le client sont sur la même machine.

Installer Munin sur Debian 8

Toutes les commandes sont éxécutées avec le compte root.

• Installation complète de Munin

apt update && apt install munin munin-node munin-plugins-extra

• Création d’un lien symbolique pour la partie serveur web

ln -s /var/cache/munin/www /var/www/munin

• Un exemple de serveur block nginx pour munin :

nano /etc/nginx/conf.d/munin.conf

server {
listen 80;
server_name munin.domaine.tld;
access_log /var/log/nginx/acces_munin.log;
error_log /var/log/nginx/error_munin.log;

server_name_in_redirect off;
root /var/www/munin;

# access munin par authentification
location / {
auth_basic "Administrator Login";
auth_basic_user_file /var/www/.htpasswd;
}

location /munin/static/ {
alias /etc/munin/static/;
expires modified +1w;
}

}

• Relance des services pour activer l’accès web de munin :

systemctl reload nginx
systemctl restart munin-node

A partir de cette étape, il est possible d’accéder à l’interface web de munin via http://IP-serveur/munin/

Activations des plugins

Les plugins pour munin sont disponibles dans le répertoire : /usr/share/munin/plugins/.

• Pour lister les plugins disponible :

munin-node-configure

• Pour activer un plugin, il faut créer un lien symbolique vers le répertoire munin :

ln -s /usr/share/munin/plugins/NOM-PLUGINS /etc/munin/plugins/NOM-PLUGINS

• Relancer munin-node pour la prise en compte :

systemctl restart munin-node

• Tester les dépendances d’un plugin :

munin-node-configure --suggest | grep NOM-PLUGINS

• Exemple de problème :

NOM-PLUGINS |no |no [LWP::UserAgent not found]

Dans ce cas, il faut installer le paquet libwww-perl :

apt install libwww-perl

Pour installer encore plus de plugins, il faut aller les télécharger sur la page : https://github.com/munin-monitoring/contrib/tree/master/plugins

Ajout du support Nginx pour Munin :

• Dans le serveur bloc à surveiller, ajouter :

location /nginx_status {
        stub_status on;
        allow 127.0.0.1;
        deny all;
    }

• Recharger la configuration pour nginx :

systemctl reload nginx

• Editer le fichier /etc/munin/plugin-conf.d/munin-node et ajouter à la fin :

[nginx*]
env.url http://localhost/nginx_status

• Vérification de la configuration :

munin-node-configure --suggest

• Créer les liens symboliques pour activer les plugins :

ln -sf /usr/share/munin/plugins/nginx_* /etc/munin/plugins/

• Relance de munin-node :

systemctl restart munin-node

Ressources

Pour la partie installation, je me suis inspiré du blog de nicolargo
Pour la partie nginx, je me suis aidé de http://ayozone.org/2013/06/03/how-to-add-nginx-status-and-request-plugins-to-munin/