Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
munin [Le 20/12/2011, 15:04] Mathieu Comandon [Configuration] typo |
munin [Le 19/12/2016, 10:18] ithasu [Configuration] |
||
|---|---|---|---|
| Ligne 11: | Ligne 11: | ||
| Pour surveiller un parc informatique, vous devez donc installer : | Pour surveiller un parc informatique, vous devez donc installer : | ||
| * le grapheur ''munin'' sur une machine qui va se charger de la surveillance. | * le grapheur ''munin'' sur une machine qui va se charger de la surveillance. | ||
| - | * le démon de noeud ''munin-node'' sur chaque machine qui va fournir son état au grapheur. | + | * le démon de nœud ''munin-node'' sur chaque machine qui va fournir son état au grapheur. |
| Dans la mythologie nordique, Hugin et Munin sont les deux corbeaux messagers d'Odin. Tous les jours, ils parcourent le monde et reviennent ensuite rapporter au dieu tout ce qu'ils ont vu et entendu. Hugin représente la pensée, tandis que son comparse Munin représente la mémoire. | Dans la mythologie nordique, Hugin et Munin sont les deux corbeaux messagers d'Odin. Tous les jours, ils parcourent le monde et reviennent ensuite rapporter au dieu tout ce qu'ils ont vu et entendu. Hugin représente la pensée, tandis que son comparse Munin représente la mémoire. | ||
| Ligne 19: | Ligne 19: | ||
| ==== Installation ==== | ==== Installation ==== | ||
| - | [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt://munin|munin]]** (suivez la procédure d'installation sur les noeuds, ci-dessous, si vous désirez monitorer également la machine qui génère les graphes) et assurez-vous que le paquet **[[apt://apache2|apache2]]** est bien installé : <file>dpkg -l | egrep -e "^ii.*apache2 "</file> | + | [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>munin]]** (suivez la procédure d'installation sur les nœuds, ci-dessous, si vous désirez monitorer également la machine qui génère les graphes) et assurez-vous que le paquet **[[apt>apache2]]** est bien installé : <file>dpkg -l | egrep -e "^ii.*apache2 "</file> |
| ==== Configuration ==== | ==== Configuration ==== | ||
| + | |||
| + | === Serveur web (ici apache) === | ||
| + | |||
| + | Déjà, si vous n'êtes pas en local (vous exécutez munin sur un serveur par exemple), il faut aller éditer le fichier **/etc/munin/apache.conf**. | ||
| + | À la ligne "Allow from localhost 127.0.0.1/8 ::1" il faut la modifier pour accepter votre adresse, si c'est dans votre réseau local : "Allow from 192.168.0.0/16 ::1 127.0.0.1/8 localhost". | ||
| + | SI vous voulez que tout le monde ait le droit de consulter munin, remplacer "Allow from localhost 127.0.0.1/8 ::1" par "Allow from all". | ||
| + | Sur la version de apache 2.4 il faut remplacer "Order allow,deny et Allow from all" par "Require all granted" | ||
| + | |||
| + | == CGI == | ||
| + | |||
| + | Pour avoir un rendu des images à la demande (économise le processeur du serveur munin tout le reste du temps), il faut indiquer à munin de ne pas générer les graphs lors de la tâche de mise-à-jour, et autoriser le rendu dans apache (déjà actif par défaut, sous /munin-cgi/munin-cgi-graph). Dans ce cas, il faudra aussi installer le paquet **libapache2-mod-fcgid**. | ||
| + | |||
| + | Créer le ficher ''/etc/munin/munin-conf.d/graph.conf'' : | ||
| + | <file> | ||
| + | graph_strategy cgi | ||
| + | cgiurl /munin-cgi | ||
| + | cgiurl_graph /munin-cgi/munin-cgi-graph | ||
| + | </file> | ||
| + | |||
| + | <note warning>Surtout ne pas rajouter un paramètre **html_strategy cgi** qui aurait pour effet de ne plus générer la page html avec le relevé des mesures des nœuds (ce qui reste très rapide), et aurait surtout pour effet néfaste de casser tous les liens vers les images qui non seulement ne s'afficherait pas, mais en plus serait « calculée » par munin-cgi-html qui ne sait pas faire des images.</note> | ||
| + | |||
| + | === Serveur Munin central === | ||
| Il faut indiquer à Munin quels hôtes il doit surveiller. Dans le fichier **/etc/munin/munin.conf**. Vous devriez avoir une configuration par défaut qui ressemble à ceci : | Il faut indiquer à Munin quels hôtes il doit surveiller. Dans le fichier **/etc/munin/munin.conf**. Vous devriez avoir une configuration par défaut qui ressemble à ceci : | ||
| Ligne 30: | Ligne 52: | ||
| use_node_name yes | use_node_name yes | ||
| </file> | </file> | ||
| + | |||
| + | |||
| + | <note help>Si rien n'apparaît au bout de 5 minutes sur la partie web, c'est que la machine ne sait pas résoudre localhost.localdomain. Il faut au choix : | ||
| + | - changer le nom entre crochet pour mettre la même chose que le retour de la commande //hostname -f// (ou rajouter un bloc avec la bonne info) | ||
| + | - ignorer ce bloc, pour rajouter un autre nœud plus intéressant | ||
| + | </note> | ||
| Pour chacune de vos machines, vous devez indiquer son ''nom d'hôte'', son ''domaine'' et son ''adresse ip''. | Pour chacune de vos machines, vous devez indiquer son ''nom d'hôte'', son ''domaine'' et son ''adresse ip''. | ||
| Ligne 41: | Ligne 69: | ||
| </file> | </file> | ||
| - | Les informations graphées sont choisies au niveau du noeud. | + | <note tip>Le paramètre **use_node_name yes** permet de prendre en compte la machine même si le nom entre crochets ne correspond pas au nom de la machine. Dans munin la machine sera toujours affichée avec le nom entre crochets. \\ |
| + | S'il n'est pas précisé, il est nécessaire de mettre la même chose que le retour de la commande //hostname -f// sur la machine en question, sinon la machine n'apparaîtra tout simplement pas dans la partie Web car munin demandera à la machine distante si cette dernière connaît un nœud correspondant au nom entre crochet, ce qui ne sera pas le cas.</note> | ||
| - | Vous pouvez également etre averti par mail en cas de dépassement d'un seuil d'alerte (par ex:disque plein) : | + | Les informations graphées sont choisies au niveau du nœud. |
| + | |||
| + | Vous pouvez également être averti par mail en cas de dépassement d'un seuil d'alerte (par ex:disque plein) : | ||
| <file> | <file> | ||
| contact.someuser.command mail -s "Munin notification" votre@mail.com | contact.someuser.command mail -s "Munin notification" votre@mail.com | ||
| Ligne 66: | Ligne 97: | ||
| Il vous suffit d'aller sur la page web suivante : http://localhost/munin si vous avez installé Munin sur votre machine en local. Sinon, remplacez localhost par l'ip de la machine où se trouve le grapheur. | Il vous suffit d'aller sur la page web suivante : http://localhost/munin si vous avez installé Munin sur votre machine en local. Sinon, remplacez localhost par l'ip de la machine où se trouve le grapheur. | ||
| - | ===== Munin-node (le démon sur les noeuds) ===== | + | ==== Mise à jour des indicateurs des nœuds ==== |
| + | |||
| + | La mise-à-jour (télé-relevé) se fait par défaut toutes les 5 minutes, grâce à la cron ''/etc/cron.d/munin''. | ||
| + | Pour déclencher une mise-à-jour manuelle supplémentaire : <code>sudo -u munin /usr/bin/munin-cron</code> | ||
| + | Et pour suivre ce qui se passe, le fichier journal est ''/var/log/munin/munin-update.log'' | ||
| + | |||
| + | ===== Munin-node (le démon sur les nœuds) ===== | ||
| Sur chaque machine que vous désirez surveiller, il vous faut installer le démon qui va répondre aux requêtes du grapheur. | Sur chaque machine que vous désirez surveiller, il vous faut installer le démon qui va répondre aux requêtes du grapheur. | ||
| Ligne 72: | Ligne 109: | ||
| ==== Installation ==== | ==== Installation ==== | ||
| - | Installez le paquet **[[apt://munin-node|munin-node]]** | + | [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>munin-node]]**. |
| ==== Configuration ==== | ==== Configuration ==== | ||
| - | === Accès au noeud === | + | === Accès au nœud === |
| - | Pour que le grapheur accède aux informations du noeud, il faut ouvrir le firewall (si nécessaire, il s'agit du port **4949** par défaut) et indiquer quels sont les grapheurs qui peuvent se connecter. | + | Pour que le grapheur accède aux informations du nœud, il faut ouvrir le firewall (si nécessaire, il s'agit du port **4949** par défaut) et indiquer quels sont les grapheurs qui peuvent se connecter. |
| Cette information est indiquée dans le fichier de configuration **/etc/munin/munin-node.conf**. À la fin du fichier de configuration, vous trouverez une ligne de ce style : | Cette information est indiquée dans le fichier de configuration **/etc/munin/munin-node.conf**. À la fin du fichier de configuration, vous trouverez une ligne de ce style : | ||
| Ligne 110: | Ligne 147: | ||
| le plugin sera alors lancé avec les variables nécessaires (nom utilisateur,nom BDD ...) | le plugin sera alors lancé avec les variables nécessaires (nom utilisateur,nom BDD ...) | ||
| + | === Prise en compte d'une configuration du nœud modifiée === | ||
| + | |||
| + | Une fois les modifications effectuées, il faut redémarrer le nœud munin pour les prendre en compte à la prochaine interrogation depuis le serveur munin : <code>service munin-node restart</code> | ||
| ==== plugins Apache ==== | ==== plugins Apache ==== | ||
| - | Les plugins Apache ont besoin de la bibliothèque **[[apt://libwww-perl|libwww-perl]]**. | + | Les plugins Apache ont besoin de la bibliothèque **[[apt>libwww-perl]]**. |
| Afin de récupérer les données statistique d'apache le module **status** doit être activé avec le mode étendue. | Afin de récupérer les données statistique d'apache le module **status** doit être activé avec le mode étendue. | ||
| Ligne 159: | Ligne 199: | ||
| Vous pouvez installer plusieurs autres plugins mysql pour suivre par exemple la valeur de max_connection, le débit réseau, le type de requête etc ... | Vous pouvez installer plusieurs autres plugins mysql pour suivre par exemple la valeur de max_connection, le débit réseau, le type de requête etc ... | ||
| Pour avoir une liste des plugins que vous pouvez ajouter allez dans le dossier: | Pour avoir une liste des plugins que vous pouvez ajouter allez dans le dossier: | ||
| - | <code>cd /user/share/munin/plugin</code> | + | <code>cd /usr/share/munin/plugins</code> |
| et faites: | et faites: | ||
| <code>./mysql_ suggest</code> | <code>./mysql_ suggest</code> | ||
| Ligne 189: | Ligne 229: | ||
| Si vous voulez ajouter qcache par exemple, faites un lien de la sorte: | Si vous voulez ajouter qcache par exemple, faites un lien de la sorte: | ||
| - | <code> ln -ls /usr/share/munin/plugin/mysql_ /etc/munin/plugins/mysql_qcache</code> | + | <code> ln -s /usr/share/munin/plugin/mysql_ /etc/munin/plugins/mysql_qcache</code> |
| C'est donc sous la forme: ln -ls /usr/share/munin/plugin/mysql_ /etc/munin/plugins/mysql_NomDuPlugin | C'est donc sous la forme: ln -ls /usr/share/munin/plugin/mysql_ /etc/munin/plugins/mysql_NomDuPlugin | ||
| ==== Plugins Proftpd ==== | ==== Plugins Proftpd ==== | ||
| - | Les plugins Proftpd ont besoin de **[[apt://logtail|logtail]]**. D'autre part, il faut que vous puissiez lire le contenu du log de transfert de proftpd. Ce dernier est normalement situé à **/var/log/proftpd/xferlog** , mais une vérification s'impose : lisez le fichier de configuration de proftpd, normalement **/etc/proftpd/proftpd.conf** : | + | Les plugins Proftpd ont besoin de **[[apt>logtail]]**. D'autre part, il faut que vous puissiez lire le contenu du log de transfert de proftpd. Ce dernier est normalement situé à **/var/log/proftpd/xferlog** , mais une vérification s'impose : lisez le fichier de configuration de proftpd, normalement **/etc/proftpd/proftpd.conf** : |
| <code>less /etc/proftpd/proftpd.conf</code> | <code>less /etc/proftpd/proftpd.conf</code> | ||
| - | et repérez la balise TransferLog, elle indique l'emplacement du fichier de log qui nous interesse. | + | et repérez la balise TransferLog, elle indique l'emplacement du fichier de log qui nous intéresse. |
| - | Regardez les permissions et propriétaires du fichier. Si le propriétaire est root et son groupe, root, peut être vaut-il mieux modifier son groupe. Je l'ai mis à adm. Et j'ai autorisé la lecture et l'écriture. (l'écriture, je ne sais pas si c'est nécessaire, mais la lecture, oui, assurement !) | + | Regardez les permissions et propriétaires du fichier. Si le propriétaire est root et son groupe, root, peut être vaut-il mieux modifier son groupe. Je l'ai mis à adm. Et j'ai autorisé la lecture et l'écriture. (l'écriture, je ne sais pas si c'est nécessaire, mais la lecture, oui, assurément !) |
| <code>chown root:adm xferlog | <code>chown root:adm xferlog | ||
| chmod ug+rw xferlog</code> | chmod ug+rw xferlog</code> | ||
| - | Ensuite, assurez vous que les plugins proftpd tournent bien dans le bon groupe. Pour ce faire éditez le fichier /etc/munin/plugin-conf.d/munin-node, et reperez (ou ajoutez) la balise [proftpd*] ou [proftpd_*], ajoutez en dessous, le groupe ou l'utilisateur que vous avez réglé sur xferlog, pour moi, cela donne : | + | Ensuite, assurez vous que les plugins proftpd tournent bien dans le bon groupe. Pour ce faire, éditez le fichier /etc/munin/plugin-conf.d/munin-node, et repérez (ou ajoutez) la balise [proftpd*] ou [proftpd_*], ajoutez en dessous, le groupe ou l'utilisateur que vous avez réglé sur xferlog, pour moi, cela donne : |
| <code>[proftpd*] | <code>[proftpd*] | ||
| Ligne 217: | Ligne 257: | ||
| Si au niveau de votre grapheur, une sonde ne génère //aucun// graphe, vérifiez que les access-list configurées dans /etc/munin/munin-node.conf sont correctes et que le pare-feu de la sonde autorise les connexions sur le port associé à la sonde munin (4949 par défaut). | Si au niveau de votre grapheur, une sonde ne génère //aucun// graphe, vérifiez que les access-list configurées dans /etc/munin/munin-node.conf sont correctes et que le pare-feu de la sonde autorise les connexions sur le port associé à la sonde munin (4949 par défaut). | ||
| - | Si certains graphes sont générés mais pas tous, vous avez probablement un plugin qui n'est pas fonctionnel. Connectez vous sur une machine pouvant accéder à la sonde (par exemple le grapheur). Sur cette machine, [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://telnet|telnet]]**. Supposons que la sonde défectueuse ait pour IP x.x.x.x et écoute sur le port 4949. Lancez la commande suivante : | + | Si certains graphes sont générés mais pas tous, vous avez probablement un plugin qui n'est pas fonctionnel. Connectez vous sur une machine pouvant accéder à la sonde (par exemple le grapheur). Sur cette machine, [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt>telnet]]**. Supposons que la sonde défectueuse ait pour IP x.x.x.x et écoute sur le port 4949. Lancez la commande suivante : |
| <code> | <code> | ||
| Ligne 261: | Ligne 301: | ||
| ===== Liens ===== | ===== Liens ===== | ||
| - | * [[http://munin.projects.linpro.no/|Site officiel de Munin (EN)]] | + | * [[http://munin-monitoring.org//|Site officiel de Munin (EN)]] |
| * [[http://muninexchange.projects.linpro.no/|Autres plugins Munin (EN)]] | * [[http://muninexchange.projects.linpro.no/|Autres plugins Munin (EN)]] | ||
| - | * Exemple de Munin en action : [[http://munin.ping.uio.no/]], [[http://munin.opendoc.net | Munin d'Opendoc.net]] | + | * Exemple de Munin en action : [[http://munin.ping.uio.no/]], [[http://demo.munin-monitoring.org | Démo sur le site officiel]] |
| ---- | ---- | ||
| - | //Contributeurs : [[utilisateurs:ostaquet]], [[utilisateurs:stephaneguedon]], [[utilisateurs:elemmire]], [[utilisateurs:rapidos]], [[utilisateurs:MaMieMando]] // | + | //Contributeurs : [[utilisateurs:ostaquet]], [[utilisateurs:stephaneguedon]], [[utilisateurs:elemmire]], [[utilisateurs:rapidos]], [[utilisateurs:MaMieMando]], [[http://karchnu.fr|Karchnu]] // |