From 15e804f86ce1d2068d5b421d26af2c87b12eb337 Mon Sep 17 00:00:00 2001 From: whirigoyen Date: Wed, 24 Nov 2021 17:46:36 +0100 Subject: [PATCH] =?UTF-8?q?Refonte=20de=20la=20premi=C3=A8re=20partie=20de?= =?UTF-8?q?=20la=20page=20+=20fix=20erreurs=20+=20ajout=20d'infos?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- HowtoMunin.md | 128 +++++++++++++++++++++++++++++++------------------- 1 file changed, 79 insertions(+), 49 deletions(-) diff --git a/HowtoMunin.md b/HowtoMunin.md index 2836ceb7..f29b5ab2 100644 --- a/HowtoMunin.md +++ b/HowtoMunin.md @@ -3,50 +3,35 @@ categories: web title: Howto Munin. ... - * [Documentation générale](http://munin-monitoring.org/wiki/Documentation) - * [Détails sur les légendes](http://demo.munin-monitoring.org/munin-monitoring.org/demo.munin-monitoring.org/) +* [Documentation générale](http://munin-monitoring.org/wiki/Documentation) +* [Détails sur les légendes](http://demo.munin-monitoring.org/munin-monitoring.org/demo.munin-monitoring.org/) + ## Installation ~~~ -# aptitude install munin +# apt install munin ~~~ -Munin ajoute un cron, qui s'exécute toutes les 5 minutes, il se situe dans `/etc/cron.d`. - -## Configuration - -### Configuration générale - -Le fichier `/etc/munin/munin.conf` permet de configurer Munin. Par défaut les graphs sont générés dans `/var/cache/munin/www`, on peut soit le changer, soit faire un lien symbolique dans `/var/www`. - -Changer le nom d'hôte : - -~~~ -# a simple host tree -[monserveur.mondomaine.com] - address 127.0.0.1 - use_node_name yes -~~~ - -Il sera peut-être nécessaire d'éditer le fichier `/etc/munin/munin-node.conf` pour y autoriser une machine à récupérer les informations, par exemple : - -~~~ -allow ^127\.0\.0\.1$ -allow ^X\.Y\.Z\.W$ -~~~ - -> Ne pas oublier d'autoriser l'IP X.Y.Z.W à joindre le serveur via le port 4949. ## Fonctionnement -Toutes les 5 minutes, munin va aller interroger ses "nodes" listés dans munin.conf (par défaut uniquement localhost.localdomain). -Il va ainsi mettre à jour ses fichiers RRD stockés dans `/var/lib/munin` puis générer des graphiques (images PNG) à partir des fichiers RRD. -Ces graphiques PNG, stockés dans `/var/cache/munin` se retrouveront affichés dans des pages HTML, également générées. +Munin a une architecture 1 master - n nodes. + +Le cron `/etc/cron.d/munin` s'exécute toutes les 5 minutes sur le master. Il interroge les nodes listés dans `/etc/munin/munin.conf` (par défaut uniquement localhost.localdomain) et récupère les données au format RRD. + +Il met à jour les fichiers RRD stockés dans `/var/lib/munin`, puis génère des graphiques (images PNG) à partir des fichiers RRD. + +Les graphiques PNG sont stockés dans `/var/cache/munin` et sont affichés dans des pages HTML, également générées. + +Le node peut être le même serveur que le master, dans ce cas l'installation est purement locale. + +Note : D'un point de vue réseau, ce sont les nodes qui ont le statut de serveur et le master qui se connecte en client sur leur port 4949. + ### Fichiers RRD -Les fichiers RRD sont les données les plus importantes, ils stockent en effet toutes les valeurs du passé. +Les fichiers RRD sont les données les plus importantes car ils stockent toutes les valeurs passées. À chaque plugin est associé un ou plusieurs fichiers RRD. @@ -65,30 +50,75 @@ Voici un exemple pour tracer un graphe de load sur un intervalle passé : $ rrdtool graph foo.png -a PNG --start -15d --end -4d --width 800 --height 800 'DEF:load=localhost.localdomain-load-load-g.rrd:42:AVERAGE' 'LINE1:load#ff0000:Load' -l 0 -u 1 ~~~ -## Ajouter un noeud -Commençons par autoriser les connections avec le master (31.120.1.12) depuis la machine cliente (31.120.1.13) : +## Configuration + +### Configurer le master + +Le fichier `/etc/munin/munin.conf` permet de configurer le master. + +Par défaut les graphiques sont générés dans `/var/cache/munin/www`. On peut soit le changer, soit faire un lien symbolique dans `/var/www`. + +Pour changer le nom d'hôte : ~~~ -echo "allow ^31\.120\.1\.12$" >> /etc/munin/munin-node.conf -/etc/init.d/munin-node restart -~~~ - -Il reste plus qu'a indiquer la machine sur master - -~~~ -vim /etc/munin/munin-node.conf ; /etc/init.d/munin-node restart -~~~ - -Et ajouter ces directives : - -~~~ -[client.foo.com] - address 31.120.1.13 +[monserveur.mondomaine.com] + address 127.0.0.1 use_node_name yes ~~~ +### Ajouter / configurer un node + +**Sur le node :** + +Le fichier `/etc/munin/munin-node.conf` permet de configurer un node. + +D'abord, il faut autoriser l'IP du master à ce connecter dans `/etc/munin/munin-node.conf`. Par défaut, on a seulement l'IP locale `127.0.0.1` : + +~~~ +allow ^127\.0\.0\.1$ +allow ^X\.Y\.Z\.W$ # <-- IP du master +~~~ + +Attention, la directive `allow` n'accepte que des regex ! + +Puis, redémarrer le service `munin-node` : + +~~~ +# systemctl restart munin-node +~~~ + +Dans le firewall du node, il faut ajouter l'IP du master sur le port 4949 en entrée : + +~~~ +/sbin/iptables -A INPUT -p tcp --dport 4949 -s X.Y.Z.W -j ACCEPT # <-- IP du master +~~~ + + +**Sur le master :** + +Ajouter les directives suivantes à la configuration du master : + +~~~ +# vim /etc/munin/munin.conf +[client.foo.com] # <-- nom du node dans Munin + address A.B.C.D # <-- IP du node + use_node_name yes +~~~ + +Il n'y a pas de service à redémarrer. Il faut attendre 5 minutes ou lancer le cron manuellement en tant qu'utilisateur munin : + +~~~ +sudo -u munin -- /usr/bin/munin-cron +~~~ + +Dans le firewall du master, il faut ouvrir le port 4949 en sortie : + +~~~ +/sbin/iptables -A INPUT -p tcp --sport 4949 --dport 1024:65535 -m state --state ESTABLISHED,RELATED -j ACCEPT +~~~ + ## Munin 2