Differences

This shows you the differences between two versions of the page.

--- informatique:logiciels:munin [2010/12/20 10:43] – créée pteu
+++ informatique:logiciels:munin [2023/08/14 18:50] (current) – [Activer un plugin] pteu
@@ Line 3: / Line 3: @@
 ======Munin======
-[[http://munin-monitoring.org/|Munin]] est un logiciel libre qui se divise en 2 parties : un récolteur de données (**munin-node**) qu'on installe sur les machines à superviser ; et un agrégateur de données (**munin**) qui tourne sur le serveur front-end. Le premier recueille des données de performance sur des machines clientes ; le second interroge le premier, l'enregistre dans une base RRD et l'affiche sur une interface web (apache typiquement).
+{{:informatique:logiciels:munin.png |}}
+[[http://munin-monitoring.org/|Munin]] est un logiciel de métrologie libre qui se divise en 2 parties : un récolteur de données (**munin-node**) qu'on installe sur les machines à superviser ; et un agrégateur de données (**munin**) qui tourne sur le serveur front-end (le serveur de supervision). Munin-node recueille des données de performance sur des machines clientes ; Munin interroge tous les munin-node, enregistre les données dans une base RRD et les affiche dans des graphiques dans une interface web (Apache typiquement).
+{{ :informatique:logiciels:munin-graphe.png |}}
 =====key-features=====
-  * la communication entre munin sur le serveur et munin-node sur les postes clients se fait sur tcp/4949
+  * la communication entre Munin sur le serveur et Munin-node sur les postes clients se fait sur tcp/4949
-  * technologies employées : RRD (donc une base (my)SQL), serveur web (typiquement Apache)
+  * technologies employées : RRD, serveur web (Apache, NGIX)
 =====Installation de munin=====
-//sous Ubuntu//
+//sous Debian-like//
-Dans un premier temps on va installer la partie serveur (munin). Mais comme je veux monitorer mon serveur, j'installe aussi la partie cliente dessus (en plus ça me permettra de valider son bon fonctionnement).
+Dans un premier temps on va installer la partie serveur (munin). Mais comme je veux monitorer mon serveur, j'installe aussi la partie cliente (munin-node) dessus (en plus ça me permettra de valider son bon fonctionnement).
 <code bash>
@@ Line 20: / Line 24: @@
 </code>
-L'installation de munin-node scanne la machine et active les plugins qui fonctionnent sur le système. Le client localhost est détecté et ajouté automatiquement dans la conf de munin, ce qui fait qu'après un redémarrage d'apache, on devrait (après une dizaine de minutes) voir apparaitre la mire de munin à l'adresse http://IP_serveur/munin .
+L'installation de munin-node scanne la machine et active les plugins qui fonctionnent sur le système. Le client localhost est détecté et ajouté automatiquement dans la conf de Munin, ce qui fait qu'après un redémarrage d'apache, on devrait (après une dizaine de minutes) voir apparaitre la mire de Munin à l'adresse http://IP_serveur/munin .
@@ Line 27: / Line 31: @@
 ====Partie serveur====
-Sous Debian-like la configuration de munin est située dans /etc/munin :
+Sous Debian-like la configuration de Munin est située dans **/etc/munin** :
-  * **apache.conf** est le fichier de conf à inclure dans Apache. Si ce n'est pas déjà fait (si vous n'obtenez pas la mire) il faut créer un lien symbolique dans <apache_dir/conf.d> pour qu'Apache le prenne en compte (puis redémarrer Apache) :
+  * **apache.conf** est le fichier à inclure dans la configuration d'Apache. Si ce n'est pas déjà fait il faut créer un lien symbolique dans <apache_dir>/conf.d pour qu'Apache le prenne en compte ; puis redémarrer Apache :
 <code bash>
 ln -s /etc/munin/apache.conf /etc/apache2/conf.d/munin
-/etc/init.d/apache2 restart
+service apache2 restart
 </code>
-  * **munin.conf** : c'est le fichier de conf principal de munin ; chaque client (nœud) doit y être renseigné :
+  * **munin.conf** : c'est le fichier de conf principal de Munin ; chaque client (nœud) doit y être renseigné :
 <code bash>
 # a simple host tree
@@ Line 49: / Line 53: @@
 Ici on voit le localhost (configuré par défaut) et j'ai rajouté une autre machine de mon LAN.
-Dans ce cas, vérifier que les flux tcp/4949 passent bien entre le serveur et la client (et surtout que munin-node soit installé sur ce dernier).
+Munin ne tourne pas comme daemon : il est lancé par cron (par défaut toutes les 5 minutes, cf ''/etc/cron.d/munin'') donc pas besoin de le relancer pour prendre en compte une modification de configuration. Par contre il faudra attendre une bonne dizaine de minutes.
-Munin ne tourne pas comme daemon : il est lancé par cron (par défaut toutes les 5 minutes, cf /etc/cron.d/munin) donc pas besoin de relancer pour prendre en compte une modification de configuration.
 ====Partie cliente====
-Comme je l'ai dit plus haut, les machines clientes ne font tourner que munin-node et pas munin tout court.
+Comme je l'ai dit plus haut, les machines clientes n'ont besoin que du paquet Munin-node.
 <code bash>
@@ Line 62: / Line 64: @@
 </code>
-Lors de l'installation, munin-node scanne la machine et active automatiquement les plugins adaptés.
+Lors de l'installation, Munin-node scanne la machine et active automatiquement les plugins adaptés.
-Par défaut le cliente n'accepte les connexions que depuis sa loopback (lui-même) ; il faut donc éditer le fichier de conf **/etc/munin/munin-node.conf** et ajouter l'adresse IP du collecteur :
+Par défaut le daemon munin-node n'accepte les connexions que depuis sa loopback (lui-même) ; il faut donc éditer le fichier de conf **/etc/munin/munin-node.conf** et ajouter l'adresse IP du collecteur (192.168.0.100 dans mon cas) :
 <code bash>
 vi /etc/munin/munin-node.conf
 #[..]
 allow ^127\.0\.0\.1$
-# IP du collecteur (la machine où est installé munin
+# IP du collecteur (la machine où est installé munin)
 allow ^192\.168\.0\.100$
 </code>
+On remarquera que les IPs sont renseignées sous la forme d'expressions régulières, Perl n'y ai pas pour rien...
 ====Activer un plugin====
-Tous les scripts installés par défaut avec munin-node sont situés dans /usr/share/munin/plugins/ ; ce sont pour la pluspart des scripts perl. Quand ils sont activés, on créer un lien symbolique dans /etc/munin/plugins/ ; si on veut ajouter ou supprimer un plugin il faut donc créer ou supprimer ce lien symbolique.
+Tous les scripts installés par défaut avec Munin-node sont situés dans **/usr/share/munin/plugins**/ ; ce sont pour la plupart des scripts perl. Pour les activer, on créé un lien symbolique dans **/etc/munin/plugins/** ; pour les désactiver il suffit de supprimer le lien symbolique.
-Il est possible de re-scanner le système ; munin-node propose alors la liste des plugins qu'il vous conseille d'installer :
+Il est possible de re-scanner le système ; Munin-node propose alors la liste des plugins qu'il vous conseille d'installer :
 <code bash>
- munin-node-configure --suggest
+munin-node-configure --suggest
 Plugin                     | Used | Suggestions
 ------                     | ---- | -----------
@@ Line 120: / Line 123: @@
 </code>
-Après avoir installé munin-node cela permet de visialiser les erreurs qu'il a rencontrées ; par exemple ici le plugin squid n'est pas activé alors que squid tourne sur ma machine !
+Pour les installer, rien de plus simple : l'outil vous donne la commande à copier/coller dans le prompt !
+<code bash>
+munin-node-configure --suggest --shell
+</code>
-La raison invoquée : ''[could not connect: Connection refused]'' est simple : mon squid ne tourne pas sur le port par défaut (3168). Il faut donc le préciser au plugin : en lisant le script perl on trouve :
+Pour tester un plugin, il existe la commande munin-run (le ''--debug'' n'est pas obligatoire) :
+<code bash>
+munin-run squid_traffic --debug
+ # Processing plugin configuration from /etc/munin/plugin-conf.d/munin-node
+ # Set /rgid/ruid/egid/euid/ to /119/65534/119 119 /65534/
+ # Setting up environment
+ # Environment squidport = 3129
+ # About to run '/etc/munin/plugins/squid_traffic'
+ kbytes_in.value 92441
+ kbytes_out.value 785678
+ hit_kbytes_out.value 1079
+</code>
+===squid_*===
+Après avoir installé munin-node, la commande ''munin-node-configure --suggest'' permet de visualiser les erreurs qu'il a rencontrées ; par exemple ici les plugins squid_* ne sont pas activés alors que Squid tourne sur ma machine !
+La raison invoquée : ''[could not connect: Connection refused]'' est simple : mon Squid ne tourne pas sur le port standard (3128), il faut donc le préciser au plugin. En lisant le script perl de ce dernier on trouve :
 <code bash>
 vi /usr/share/munin/plugins/squid_traffic
@@ Line 133: / Line 155: @@
  squidpasswd - password (default "")
 </code>
-Il faut donc lui préciser le nouveau port ; ceci se fait dans le fichier de conf des plugins, j'ai nommé **/etc/munin/plugin-conf.d/munin-node** :
+Il faut donc lui préciser le nouveau port ; ceci se fait dans le fichier de conf des plugins : **/etc/munin/plugin-conf.d/munin-node**
 <code bash>
 vi /etc/munin/plugin-conf.d/munin-node
@@ Line 139: / Line 161: @@
 env.squidport 3131
 </code>
-On ajouter ces ligne suivant la syntaxe qui convient : ici on précise le port dans la variable d'environnement squidport.
+On ajoute ces lignes suivant la syntaxe qui convient : ici on précise le port personnalisé tcp/3131 dans la variable d'environnement squidport qui sera transmise au script.
+Puis on lance le scan :
+<code bash>
+munin-node-configure --suggest
+</code>
+S'il est listé dans le résultat de la commande précédente, alors l'utilitaire peut nous pré-mâcher le travail :
+<code bash>
+munin-node-configure --suggest --shell | grep squid
+ln -s /usr/share/munin/plugins/squid_cache /etc/munin/plugins/squid_cache
+ln -s /usr/share/munin/plugins/squid_requests /etc/munin/plugins/squid_requests
+ln -s /usr/share/munin/plugins/squid_traffic /etc/munin/plugins/squid_traffic
+</code>
+===apache_*===
+Certains plugins d'Apache requièrent l'activation des modules mod_info et mod_status dans le serveur web. Pour vérifier les plugins installés, vérifier la présence de leurs liens symboliques (.conf et .load) dans /etc/apache2/mods-enabled/ :
+<code bash>
+ll /etc/apache2/mods-enabled/
+</code>
+S'ils n'y sont pas, les activer :
+<code bash>
+a2enmod status
+a2enmod info
+</code>
+Puis activer les plugins dans munin-node et relancer le service :
+<code bash>
+ln -s /usr/share/munin/plugins/apache_accesses /etc/munin/plugins/apache_accesses
+ln -s /usr/share/munin/plugins/apache_processes /etc/munin/plugins/apache_processes
+ln -s /usr/share/munin/plugins/apache_volume /etc/munin/plugins/apache_volume
+/etc/init.d/munin-node restart
+</code>
+==Graphes vides==
+Avec la dernière Debian (6.0) j'ai constaté que les courbes restent vides. En farfouillant les log on obtient :
+<code bash>
+tail /var/log/munin/munin-node.log
+[..]
+/01/03-11:45:02 [1138] Error output from apache_volume:
+/01/03-11:45:02 [1138]      LWP::UserAgent not found at /etc/munin/plugins/apache_volume line 86.
+</code>
+L'outil de diagnostic interne de Munin indique :
+<code bash>
+munin-node-configure --suggest
+Plugin                     | Used | Suggestions
+------                     | ---- | -----------
+[..]
+apache_accesses            | yes  | no [LWP::UserAgent not found]
+apache_volume              | yes  | no [LWP::UserAgent not found]
+</code>
+J'ai trouvé sur google qu'il manquait une librairie Perl de gestion de serveur web : libwww-perl. Malgré les multiples dépendances je l'ai installé, ai relancé munin-node et les graphes se sont peuplés :)
+<code bash>
+aptitude install libwww-perl
+[..]
+Les NOUVEAUX paquets suivants vont être installés :
+  libfont-afm-perl{a} libhtml-format-perl{a} libhtml-parser-perl{a}
+  libhtml-tagset-perl{a} libhtml-tree-perl{a} libmailtools-perl{a}
+  libtimedate-perl{a} liburi-perl{a} libwww-perl
+[..]
+service munin-node restart
+</code>
+===netstat===
+Le plugin netstat permet de récupérer les connexions established, actives, etc... et est désactivé par défaut. Pourtant, tout Linux qui se respecte dispose de la commande netstat ! Nous allons donc l'activer :
+<code bash>
+ln -s /usr/share/munin/plugins/netstat /etc/munin/plugins/netstat
+service munin-node restart
+</code>
+Si au bout d'une dizaone de minute le graphe ne s'affiche pas, il faut peut-être le lancer en root :
+<code bash>
+vi /etc/munin/plugin-conf.d/munin-node
+[netstat]
+user root
+service munin-node restart
+</code>
+Dans mon cas le graphe s'affiche correctement sous Debian 6.0, mais les courbes ne sont pas cohérentes et semblent s'afficher sur des abscisses différentes. La manipulation suivante m'a permis de retrouver des graphes qui tiennent la route :
+<code bash>
+vi /usr/share/munin/plugins/netstat
+# chercher la ligne suivante...
+#        echo 'graph_title Netstat'
+       echo 'graph_args --base 1000 --logarithmic'
+#        echo 'graph_vlabel active connections'
+# et la remplacer par celle-ci :
+        echo 'graph_args -l 0 --base 1000'
+</code>
+Sauvegarder et enregistrez le fichier et relancer le service :
+<code bash>
+service munin-node restart
+</code>
+===multiping===
+[[http://exchange.munin-monitoring.org/plugins/multiping/details|multiping]] est une amélioration du plugin ping_, qui permet de pinguer plusieurs destinations et d'afficher le résultat sur une seul graphique.
+<code bash>
+cd /usr/share/munin/plugins/
+wget http://exchange.munin-monitoring.org/plugins/multiping/version/1/download
+mv download multiping
+chmod 755 multiping
+ln -s /usr/share/munin/plugins/multiping /etc/munin/plugins/multiping
+vi /etc/munin/plugin-conf.d/munin-node
+[multiping]
+env.host www.google.fr www.free.fr www.orange.fr www.yahoo.fr
+/etc/init.d/munin-node restart
+</code>
+===bind95_===
+[[http://exchange.munin-monitoring.org/plugins/bind95_/details|bind95_]] est un plugin pour récupérer les statistiques DNS du logiciel bind version 9.5.
+{{http://static.k5-storitve.net/site_media/images/plugins/425-1250001091-ns1-bind95_-day.png}}
+Pour cela, il faut dans un premier temps activer les statistiques dans bind en activant l'option (à ajouter dans la partie options de named.conf ; sous Debian cette section est située dans le fichier **named.conf.options** :
+<code bash>
+vi /etc/bind/named.conf.options
+options {
+[..]
+        statistics-file "/var/cache/bind/named.stats";
+[..]
+}
+/etc/init.d/bind9 restart
+</code>
+Après quelques temps le fichier **/var/cache/bind/named.stats** devrait apparaitre et se peupler.
+<code bash>
+cd /usr/share/munin/plugins/
+wget http://exchange.munin-monitoring.org/plugins/bind95_/version/1/download
+mv download bind95_
+chmod 755 bind95_
+ln -s /usr/share/munin/plugins/bind95_ /etc/munin/plugins/bind95_
+# utiliser le compte root pour la récupération des stats
+vi /etc/munin/plugin-conf.d/munin-node
+[bind95]
+user root
+/etc/init.d/munin-node restart
+</code>
+Le compte root est nécessaire si vous obtenez l'erreur suivante :
+<code bash>
+rndc: error: none:0: open: /etc/bind/rndc.key: permission denied
+rndc: could not load rndc configuration
+</code>
+===processes===
+Pour qu'il marche il faut le lancer en root (sinon on ne graphe que les process appartenant à munin) ; donc :
+<code bash>
+vi /etc/munin/plugin-conf.d/munin-node
+[processes]
+user root
+</code>
+===df===
+La partition /home n'est pas graphée ni détectée par un ''munin-run df --debug''. [[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=918851|Internet]] m'apprend que le paramètre ''ProtectHome=true'' de systemd en est la cause ; en le désactivant :
+<code file /etc/systemd/system/multi-user.target.wants/munin-node.service>
+#ProtectHome=true
+ProtectHome=false
+</code>
+et en relançant le service ''systemctl restart munin-node && systemctl daemon-reload'', la partition ''/home'' est bien monitorée :
+<code bash>
+munin-run df | grep sda3
+_dev_sda3.value 85.964070979881
+</code>
+====Installer un nœud sous Windows====
+Il existe une [[http://munin-monitoring.org/wiki/HowToMonitorWindows|version de munin-node qui tourne sous Windows]] ; les plugins sont moins nombreux mais les principaux indicateurs de santé de la machine sont là (utilisation CPU, mémoire, disques, etc...) !
+Un léger bémol cependant pour le graphe de charge CPU qui, [[http://code.google.com/p/munin-node-win32/issues/detail?id=3#c0|appa]]-[[http://sourceforge.net/projects/munin-nodewin32/forums/forum/921022/topic/3807654|remment]], pose problème avec Windows 7 x64. Effectivement la sonde retourne 0, alors que le graphe de charge des processeurs retourne des valeurs cohérentes.
+====Graphes inaccessibles====
+Je me suis configuré un Munin aux petits oignons qui marchait très bien. Cependant, soudainement il s'est mis à ne plus afficher les graphes sur l'interface web. Aucun message d'erreur dans les logs, les fichiers des graphes sont bien mis à jour... mais ceux-ci n'ont pas les bons droits :
+<code bash>
+ll /var/cache/munin/www/localdomain/localhost.localdomain/
+[..]
+-rw-r----- 1 munin munin  13K juin  19 19:15 vmstat-day.png
+</code>
+D'ailleurs Apache génère bien une erreur HTTP 403 dans ses logs.
+En toute honnêteté je ne suis parvenu à savoir ni pourquoi Munin s'est mis soudainement à générer ses graphes avec les mauvais droits, ni comment y remédier. N'ayant trouvé aucune piste sur notre ami commun (Google), j'ai contourné le problème en ajoutant simplement l'utilisateur d'Apache (www-data) au groupe munin :
+<code bash>
+adduser www-data munin
+Ajout de l'utilisateur « www-data » au groupe « munin »...
+Ajout de l'utilisateur www-data au groupe munin
+Fait.
+</code>