Configuration du plugin de base
Le plugin de base ne listera que le nombre d’utilisateur connectés en même temps au serveur.
Pour configurer ce plugin, vous devez savoir où se trouve le fichier de log de statut d’OpenVPN. Dans notre configuration, on l’a configuré pour être créé dans /var/log/openvpn-status.log
, voir cet article pour mieux comprendre.
Dans un premier temps, on va lier symboliquement le script de monitoring au bon endroit avec la commande :
- sudo ln -s /usr/share/munin/plugins/openvpn /etc/munin/plugins/openvpn
On configure ensuite simplement le fichier de configuration des plugins de munin :
- sudo nano /etc/munin/plugin-conf.d/munin-node
Et on y ajoute ces lignes :
- [openvpn]
- user root
- env.statusfile /var/log/openvpn-status.log
Si le fichier de log de status est au bon endroit, et que vous avez un utilisateur connecté, la commande sudo munin-run openvpn
devrait retourner ceci :
- users.value 1
Votre premier plugin est donc bien configuré, on peut redémarrer le noeud :
- sudo /etc/init.d/munin-node restart
Cela devrait ressembler à cela au bout de quelque temps :
Configuration du plugin plus complet
Ce plugin affichera notamment la bande passante utilisée par utilisateur.
On a décidé de déposer nos plugins personnalisés dans le répertoire /opt/share/munin/plugins
, on vérifie qu’il existe bien et on s’y déplace :
- #Créer le répertoire des plugins dans le cas ou il n'existe pas déjà
- sudo mkdir -p /opt/share/munin/plugins
Le code du plugin openvpn_multi en question est ici.
On le récupère dans notre répertoire de plugins personnalisés :
- cd /opt/share/munin/plugins
- sudo wget --no-check-certificate https://raw.githubusercontent.com/munin-monitoring/contrib/master/plugins/openvpn/openvpn_multi
- # Rendre le script exécutable
- chmod +x openvpn_multi
On le lie symboliquement dans notre répertoire de plugins de muni avec la commande suivante :
- sudo ln -s /opt/share/munin/plugins/openvpn_multi /etc/munin/plugins/openvpn_multi
On doit ensuite modifier la configuration des plugins de munin :
- sudo nano /etc/munin/plugin-conf.d/munin-node
Et on y ajoute ces lignes :
- [openvpn_multi]
- user root
- env.statusfile /var/log/openvpn-status.log
- env.userlist useropenvpn useropenvpnbis
Note :
- Bien vérifier que votre fichier de log de status est
/var/log/openvpn-status.log
; - Modifier
useropenvpn useropenvpnbis
avec votre liste d’utilisateurs à monitorer ; - Attention, apparemment le plugin plante si il y a un
-
dans le nom de l’utilisateur ;
Vous pouvez maintenant tester le plugin avec la commande suivante :
- sudo munin-run openvpn_multi
Elle devrait vous retourner ce type de données :
- useropenvpn_in.value 8648375
- useropenvpn_out.value 46372515
- multigraph openvpn_multi.useropenvpn
- useropenvpn_in.value 8648375
- useropenvpn_out.value 46372515
Si ce test vous retourne des valeurs -1
, la configuration n’est pas bonne.
Si tout est ok, vous pouvez finalement redémarrer le noeud :
- sudo /etc/init.d/munin-node restart
Cela devrait ressembler à cela au bout de quelque temps :