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 Alias | Service Template | Default |
---|---|---|
Server-Usage | App-Openvpn-Server-Usage-OMI | X |
Métriques & statuts collectés
- Server-Usage
Metric name | Description | Unit |
---|---|---|
clients.current.count | Number of current Clients | count |
server.traffic.in.bitspersecond | Server traffic in | b/s |
server.traffic.out.bitspersecond | Server traffic out | b/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
- Online License
- Offline License
- Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Open VPN:
yum install centreon-plugin-Applications-Openvpn-Omi
- Sur l'interface Web de Centreon, installer le Plugin Pack OpenVPN OMI depuis la page Configuration > Packs de plugins
- Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Open VPN:
yum install centreon-plugin-Applications-Openvpn-Omi
- Sur le serveur Central Centreon, installer le RPM du Pack OpenVPN OMI:
yum install centreon-pack-applications-openvpn-omi
- 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
Mandatory | Name | Description |
---|---|---|
OMIEXTRAOPTIONS | ||
X | OMIPASSWORD | |
X | OMIPORT | 7505 |
EXTRAOPTIONS | Any 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.