Outils personnels

Installation de munin - munin-node : Différence entre versions

De wikiGite

(Plugins ip_*)
(Installation client)
 
(31 révisions intermédiaires par 5 utilisateurs non affichées)
Ligne 7 : Ligne 7 :
  
 
== CentOS ==
 
== CentOS ==
=== Installation server+client ===
+
=== Installation client ===
  
 
Si ça n'a pas déjà été fait, installation repos RPMForge ( -> [[Dépôts complémentaires]]).
 
Si ça n'a pas déjà été fait, installation repos RPMForge ( -> [[Dépôts complémentaires]]).
  
  yum --enablerepo=rpmforge install munin munin-node
+
'''Munin 1.x'''
paramétrer les 2 fichiers conf sous /etc/munin, démarrer munin-node et l'ajouter au chkconfig
+
  yum --enablerepo=rpmforge install munin-node
 +
'''Munin 2.x'''
 +
yum --enablerepo=epel install munin-node # attention, EPEL met à jour en dépendance des paquets Perl et PostgreSQL
 +
 
 +
paramétrer le fichier conf sous /etc/munin, démarrer munin-node et l'ajouter au chkconfig
  
 
Pour munin-node (client), si le serveur munin est distant, il faut l'autoriser dans /etc/munin/munin-node.conf en ajoutant sont adresse IP. Exemple :
 
Pour munin-node (client), si le serveur munin est distant, il faut l'autoriser dans /etc/munin/munin-node.conf en ajoutant sont adresse IP. Exemple :
 
  allow ^192\.168\.1\.253$
 
  allow ^192\.168\.1\.253$
et dans ce cas, paramétrer le serveur munin pour récupérer les données du client. Dans /etc/munin/munin.conf :
 
[server.domain.tld]
 
    address 192.168.1.250
 
    use_node_name yes
 
  
 
On oublie pas :
 
On oublie pas :
Ligne 25 : Ligne 25 :
 
  chkconfig --list munin-node
 
  chkconfig --list munin-node
  
'''<span style="color:red">NOTE importante</span>''' : supprimer le plugin '''hddtemp_smartctl''' car il provoque une erreur sur le lecteur CD :
+
'''<span style="color:red">NOTE importante</span>''' : supprimer le plugin '''hddtemp_smartctl''' (/etc/munin/plugins) car il provoque une erreur sur le lecteur CD :
 
  Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
 
  Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
 
  Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: error=0x04 { AbortedCommand }
 
  Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: error=0x04 { AbortedCommand }
Ligne 33 : Ligne 33 :
 
Ne laisser qu'un plugin ntp, renommé en "ntp_canon_inria_fr".
 
Ne laisser qu'un plugin ntp, renommé en "ntp_canon_inria_fr".
  
== Et pour finir... ==
+
Et pour finir...
 
  /etc/init.d/munin-node restart
 
  /etc/init.d/munin-node restart
  
== TIPS ==
+
=== Installation server ===
=== Tests ===
+
  yum --enablerepo=rpmforge install munin  
  munin-run mysql_bytes
 
On peut essayer aussi
 
telnet localhost 4949
 
qui donne ce que voit le serveur munin en interrogeant munin-node.
 
  
=== Si modification device eth ===
+
Paramétrer le serveur munin pour récupérer les données du client. Dans /etc/munin/munin.conf :
Ex : après install des VMWareTools, eth1 passe en eth0
+
[server.domain.tld]
Penser à renommer /etc/munin/plugins/if_* (par mv, pas par cp, pour ne toucher qu'aux liens)
+
    address 192.168.1.250
 +
    use_node_name yes
  
 
= Activation et paramétrage des PLUGINS =
 
= Activation et paramétrage des PLUGINS =
Créer simplement un lien sur les plugins, de /usr/share/munin/plugins/ dans /etc/munin/plugins.
+
[[Munin-node_activation_plugins]]
  
Certains liens doivent être créés avec un nom spécial (ex : *_'''eth0''' pour faire référence à une interface en particulier)
+
= TIPS =
 +
== Affichage des plugins et suggestions ==
 +
Pour afficher les plugins et leur état :
 +
/usr/sbin/munin-node-configure
 +
Pour demander à Munin de suggérer les plugins à activer :
 +
/usr/sbin/munin-node-configure --suggest
 +
'''NOTE :''' Cette commande permet aussi d'afficher des informations d'erreur (exemple : le "Extended Status" est Off alors qu'on veut activer les plugins Apache)
  
== Plugins MySQL ==
+
== Tests ==
Vérifier que les plugins mysql_* sont présents si nécessaires. Pour mysql munin a besoin de droits. Donc déclarer un utilsateur avec le minimum de droits sur les tables systèmes :
+
munin-run mysql_bytes
  # mysql -uroot -p
+
On peut essayer aussi
  mysql> grant select on mysql.* to munin@localhost identified by 'munin';
+
  telnet <'''host_surveillé'''> 4949
  mysql> exit
+
  fetch df
Puis modifier le bloc [mysql*] dans /etc/munin/plugin-conf.d/munin-node
+
  config df
[mysql*]
 
  user root
 
  env.mysqlopts -umunin -pmunin
 
 
 
== Plugins APACHE_* ==
 
Les plugins apache ont besoin de server-status. Pour l'activer voir [[Activation de server-status]].
 
  
Note : server-status est activé par défaut sur Debian 6 Squeeze.
+
qui donne ce que voit le serveur munin (ici pour le service df) en interrogeant munin-node du "host surveillé". Essayer aussi les commandes "list", et "nodes".<br />
== Plugins ip_* ==
+
Pour quitter telnet taper "quit" ou attendre quelque secondes, la session se ferme seule s'il n'y a pas d'activité.
if_* n'est pas sûr pour des cartes à 100Mb ou 1Gb. Il vaut mieux ajouter le plugin ip_
 
  
Le plugin ip_ de munin-node réclame 2 règles iptables pour compter les paquets au niveau IP, en début de INPUT :
+
Sur le serveur Munin qui centralise les nodes, on peut vérifier les échanges par :
  /sbin/iptables -I INPUT -s 192.168.1.1
+
  # su -s /bin/bash munin
  /sbin/iptables -I INPUT -d 192.168.1.1
+
  $ /usr/share/munin/munin-update --debug --nofork --stdout --host <'''host_surveillé'''> --service df
Le plus simple est de les placer dans /etc/rc.local pour qu'elles soient chargées au démarrage.
 
  
Activation du module :
+
== Si modification device eth ==
ln -s /usr/share/munin/plugins/ip_ /etc/munin/plugins/ip_192.168.1.1
+
Ex : après install des VMWareTools, eth1 passe en eth0.
  
''Note pour ISPConfig'' : ajout d'un script init.d/ispconfig_zcustom (z pour qu'il se lance après ispconfig_server) :
+
Penser à renommer /etc/munin/plugins/if_* (par mv, pas par cp, pour ne toucher qu'aux liens).
#!/bin/bash
 
# FSO 01/2008
 
###################################
 
#
 
# ISPConfig custom tasks
 
#
 
###################################
 
IPTABLES=/sbin/iptables
 
IP=192.168.1.1
 
case "$1" in
 
    start)
 
        echo "ISPConfig custom script..."
 
        # OSSEC HIDS ip_ plugin comment : "...you need these iptables rules as the first rules (they don't do anything, just make packet counts)"
 
        $IPTABLES -I INPUT -d $IP
 
        $IPTABLES -I OUTPUT -s $IP
 
    ;;
 
    stop)
 
        $IPTABLES -D INPUT -d $IP
 
        $IPTABLES -D OUTPUT -s $IP
 
    ;;
 
    restart)
 
        $0 stop  && sleep 1
 
        $0 start
 
    ;;
 
    *)
 
    echo "Usage: $0 {start|stop|restart}"
 
    exit 1
 
esac
 
exit 0
 
Puis ajout aux runlevels par défaut : update-rc.d ispconfig_zcustom defaults 99 98
 

Version actuelle datée du 23 juillet 2013 à 09:29

Debian

Installation client only

apt-get install munin-node

Editer /etc/munin/munin-node.conf, ajouter à la fin :

allow ^192\.168\.1\.253

(Ou 192.168.1.253 est l'adresse du serveur Munin - Adapter selon la configuration)

CentOS

Installation client

Si ça n'a pas déjà été fait, installation repos RPMForge ( -> Dépôts complémentaires).

Munin 1.x

yum --enablerepo=rpmforge install munin-node

Munin 2.x

yum --enablerepo=epel install munin-node # attention, EPEL met à jour en dépendance des paquets Perl et PostgreSQL

paramétrer le fichier conf sous /etc/munin, démarrer munin-node et l'ajouter au chkconfig

Pour munin-node (client), si le serveur munin est distant, il faut l'autoriser dans /etc/munin/munin-node.conf en ajoutant sont adresse IP. Exemple :

allow ^192\.168\.1\.253$

On oublie pas :

chkconfig --level 2345 munin-node on
chkconfig --list munin-node

NOTE importante : supprimer le plugin hddtemp_smartctl (/etc/munin/plugins) car il provoque une erreur sur le lecteur CD :

Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: status=0x51 { DriveReady SeekComplete Error }
Apr  9 10:00:06 server2 kernel: hdc: drive_cmd: error=0x04 { AbortedCommand }
Apr  9 10:00:06 server2 kernel: ide: failed opcode was: 0xec

Problème noté sur BlueOnyx en machine virtuelle ESXi.

Ne laisser qu'un plugin ntp, renommé en "ntp_canon_inria_fr".

Et pour finir...

/etc/init.d/munin-node restart

Installation server

yum --enablerepo=rpmforge install munin 

Paramétrer le serveur munin pour récupérer les données du client. Dans /etc/munin/munin.conf :

[server.domain.tld]
   address 192.168.1.250
   use_node_name yes

Activation et paramétrage des PLUGINS

Munin-node_activation_plugins

TIPS

Affichage des plugins et suggestions

Pour afficher les plugins et leur état :

/usr/sbin/munin-node-configure

Pour demander à Munin de suggérer les plugins à activer :

/usr/sbin/munin-node-configure --suggest

NOTE : Cette commande permet aussi d'afficher des informations d'erreur (exemple : le "Extended Status" est Off alors qu'on veut activer les plugins Apache)

Tests

munin-run mysql_bytes

On peut essayer aussi

telnet <host_surveillé> 4949
fetch df
config df

qui donne ce que voit le serveur munin (ici pour le service df) en interrogeant munin-node du "host surveillé". Essayer aussi les commandes "list", et "nodes".
Pour quitter telnet taper "quit" ou attendre quelque secondes, la session se ferme seule s'il n'y a pas d'activité.

Sur le serveur Munin qui centralise les nodes, on peut vérifier les échanges par :

# su -s /bin/bash munin
$ /usr/share/munin/munin-update --debug --nofork --stdout --host <host_surveillé> --service df

Si modification device eth

Ex : après install des VMWareTools, eth1 passe en eth0.

Penser à renommer /etc/munin/plugins/if_* (par mv, pas par cp, pour ne toucher qu'aux liens).