Installer Munin sur Debian 8 avec nginx

[Ldfa]

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

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.

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/

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

• 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 insallation, 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/

Afficher l’article complet