Aller au contenu principal

OpenVPN OMI

Contenu du Pack

Modèles

Le Plugin Pack 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 Plugin Pack 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.