Differences

This shows you the differences between two versions of the page.

--- gnu_linux_server:monitoring:monitoring_munin_plugin [2011/09/25 10:39] – créée guillaume
+++ gnu_linux_server:monitoring:monitoring_munin_plugin [2021/01/04 20:41] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
 ===== Les règles d'un plugin =====
+Écrire un plugin pour Munin est relativement simple mais chaque plugin doit respecter quelques conventions afin de fonctionner correctement.
+La première règle est que chaque script de plugin doit gérer le paramètre nommé **config**. Lorsque ce paramètre est passé au script ce dernier doit renvoyer les caractéristiques du graphe à dessiner. Le script doit renvoyer sur la sortie standard quelque chose de ce type (au minimum).
+<code>graph_title Load average
+graph_vlabel load
+load.label load</code>
+L'attribut **graph_title** définit le titre du graphe. L'attribut **graph_vlabel** définit la légende de l'axe Y (vertical) du graphe. Enfin **load.label** définit le code couleur pour la ligne définit par **load.value**.
+La seconde règle concerne le nom des fichiers. Pour activer un plugin, on utilise un lien symbolique que l'on fait pointer sur le fichier de plugin réel. Ce lien symbolique doit se trouver dans le répertoire ///etc/munin/plugins//. Les plugins qui doivent prendre un paramètre pour fonctionner doivent se terminer par un **_**. Et donc pour utiliser le script avec le paramètre voulu on crée un lien symbolique du genre ///etc/munin/plugins/plugin_paramètre//.
 ===== Exemple d'un plugin simple =====
-===== Des plugins créés pour nos besoins =====
+Voici un exemple de plugin on ne peut plus simple.
+<code bash>#!/bin/sh
+case $1 in
+    config)
+        cat <<'EOM'
+graph_title Load average
+graph_vlabel load
+load.label load
+EOM
+        exit 0
+        ;;
+esac
+echo -n "load.value "
+cut -d' ' -f2  /proc/loadavg</code>
+Et si on le teste on obtient.
+<code bash>
+$ ./load
+load.value 0.08
+$ ./load config
+graph_title Load average
+graph_vlabel load
+load.label load</code>
+Ce plugin permet de faire un graphe de la charge de la machine. Pour l'activer on crée un lien symbolique du script.
+<code bash>ln -s loadaverage /etc/munin/plugins/loadaverage</code>
+===== Des plugins créés pour nos besoins =====
+Voir cette [[gnu_linux_server:monitoring:monitoring_munin_plugin_list|page]].