Aller au contenu principal

OpenVPN OMI

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon OpenVPN OMI apporte 1 modèle d'hôte :

  • App-Openvpn-OMI

Il apporte le Modèle de Service suivant :

Service AliasService TemplateDefault
Server-UsageApp-Openvpn-Server-Usage-OMIX

Métriques & statuts collectés​

Metric nameDescriptionUnit
clients.current.countNumber of current Clientscount
server.traffic.in.bitspersecondServer traffic inb/s
server.traffic.out.bitspersecondServer traffic outb/s

Prérequis​

Le serveur Open VPN doit avoir une OMI fonctionnelle. Un utilisateur et un mot de passe dédiés au monitoring sont fortement conseillés pour des raisons de sécurité.

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Open VPN:
yum install centreon-plugin-Applications-Openvpn-Omi
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision OpenVPN OMI depuis la page Configuration > Packs de plugins

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs "Nom","Alias" & "IP Address / DNS" correspondant à votre serveur Open VPN
  • Appliquez le Modèle d'Hôte Applications-Openvpn-Omi-custom
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises(Mandatory) doivent être renseignées
MandatoryNameDescription
OMIEXTRAOPTIONS
XOMIPASSWORD
XOMIPORT7505
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins//centreon_openvpn_omi.pl \
--plugin=apps::openvpn::omi::plugin \
--mode=server-usage \
--omi-hostname='10.0.0.1' \
--omi-password='' \
--omi-port='7505' \
--warning-num-clients='' \
--critical-num-clients='' \
--warning-traffic-in='' \
--critical-traffic-in='' \
--warning-traffic-out='1000000' \
--critical-traffic-out='2000000' \
--use-new-perfdata

La commande devrait retourner un message de sortie similaire à :

OK : Current Clients: 9000 Traffic In: 900 kb/s Traffic Out: 900 kb/s | 'clients.current.count'=9000;;;0; 'server.traffic.in.bitspersecond'=900000b/s;;;0; 'server.traffic.out.bitspersecond'=900000b/s;1000000;2000000;0;

Dans cet exemple, une alarme de type WARNING sera déclenchée si le traffic out est supérieur à 2 1000000 b/s (--warning-traffic-out='1000000'); l'alarme sera de type CRITICAL au-delà de 2000000 b/s.

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins//centreon_openvpn_omi.pl \
--plugin=apps::openvpn::omi::plugin \
--mode=server-usage \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins//centreon_openvpn_omi.pl \
--plugin=apps::openvpn::omi::plugin \
--list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostique des erreurs commununes des Plugins Centreon.