Refonte de la première partie de la page + fix erreurs + ajout d'infos
This commit is contained in:
parent
0cd9a5e1b2
commit
15e804f86c
128
HowtoMunin.md
128
HowtoMunin.md
|
@ -3,50 +3,35 @@ categories: web
|
||||||
title: Howto Munin.
|
title: Howto Munin.
|
||||||
...
|
...
|
||||||
|
|
||||||
* [Documentation générale](http://munin-monitoring.org/wiki/Documentation)
|
* [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/)
|
* [Détails sur les légendes](http://demo.munin-monitoring.org/munin-monitoring.org/demo.munin-monitoring.org/)
|
||||||
|
|
||||||
|
|
||||||
## Installation
|
## 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
|
## Fonctionnement
|
||||||
|
|
||||||
Toutes les 5 minutes, munin va aller interroger ses "nodes" listés dans munin.conf (par défaut uniquement localhost.localdomain).
|
Munin a une architecture 1 master - n nodes.
|
||||||
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.
|
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
|
### 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.
|
À 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
|
$ 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
|
[monserveur.mondomaine.com]
|
||||||
/etc/init.d/munin-node restart
|
address 127.0.0.1
|
||||||
~~~
|
|
||||||
|
|
||||||
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
|
|
||||||
use_node_name yes
|
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
|
## Munin 2
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue