Monitoring/Munin.md
... ...
@@ -0,0 +1,56 @@
1
+Munin
2
+=======
3
+
4
+
5
+Munin est le service au ResEl qui permet de monitorer facilement les différentes métriques qui remontent depuis les serveurs.
6
+
7
+Le service est installé sur [DGSI](Serveurs/DGSI) et est accessible à l'adresse suivante : https://munin.resel.fr/
8
+
9
+# Ajout d'un nouveau serveur
10
+Voir aussi : [Guide d'installation d'une nouvelle machine physique](Guides/Installation machine physique#monitoring)
11
+
12
+À noter que tout ceci peut être réalisé avec Ansible automatiquement lors du provisioning du serveur. La méthode décrite ci-dessous est là à titre indicatif. Mais elle n'est pas la méthode recommandée.
13
+
14
+## Sur DGSI
15
+Imaginions que vous voulez ajouter un serveur qui s'appelle cyric et dont l'ip d'administration est : 172.22.2.80
16
+
17
+Il faut ajouter au fichier `/etc/munin/munin.conf` les lignes suivantes :
18
+```
19
+[cyric.adm.resel.fr]
20
+ address 172.22.2.80
21
+ use_node_name yes
22
+```
23
+
24
+## Sur le serveur à monitorer
25
+
26
+Installez les bons packets :
27
+```
28
+sudo apt-get install munin-node munin-plugins-extra
29
+sudo ln -s /usr/share/munin/plugins/apt /etc/munin/plugins/apt
30
+```
31
+
32
+Dans le fichier de configuration `/etc/munin/munin-node.conf`, enlever l'écoute sur toutes les interfaces `host *`, et à la place spécifier l'IP dans la zone admin et le port 4949. Il faut permettre à DGSI de contacter la machine, donc ajouter (à adapter si la machine n'a pas d'interface dans le 997) :
33
+```
34
+allow ^172\.22\.2\.158$
35
+```
36
+Ajouter ce qu'il faut grapher dans `/etc/munin/plugins/` (typiquement, des symlinks vers `/usr/share/munin/plugins` -- attention, pour les interfaces réseaux par exemple le nom du lien est important).
37
+
38
+À savoir vous pouvez configurer automatiquement les plugins en lancant la commande :
39
+```
40
+munin-node-configure --shell --families=contrib,auto | sh -x
41
+```
42
+Attention à vérifier tout de même que la commande a bien configuré ce qu'il vous faut, et n'hésitez pas à ajouter les plugins qui manquent.
43
+
44
+*[Attention, le plugin APT est (encore) buggué, voir le ticket résolu à ce sujet.](https://trac.resel.fr/ticket/584)*
45
+
46
+# Configuration
47
+-> Le repo de sa configuration est disponible ici : https://git.resel.fr/confs/munin
48
+
49
+# Articles connexes
50
+
51
+# Ressources
52
+* [Site officel de Munin](http://munin-monitoring.org/)
53
+
54
+# TODO (rédacteur)
55
+* Détailler la configuration de DGSI
56
+