Azure VPN Gateway
Contenu du Pack​
Modèles​
Le connecteur de supervision Centreon Azure VPN Gateway apporte un modèle d'hôte :
- Cloud-Azure-Network-VpnGateway-custom
Il apporte les modèles de service suivants :
| Alias | Modèle de service | Description | Défaut |
|---|---|---|---|
| Health | Cloud-Azure-Network-VpnGateway-Health-Api | Contrôle le statut de la passerelle VPN | X |
| Site-Traffic | Cloud-Azure-Network-VpnGateway-Site-Traffic-Api | Contrôle le trafic entrant et sortant du site | X |
| Tunnel-Traffic | Cloud-Azure-Network-VpnGateway-Tunnel-Traffic-Api | Contrôle le trafic entrant et sortant du tunnel | X |
| Vpn-Gateway-Status | Cloud-Azure-Network-VpnGateway-Vpn-Gateway-Status-Api | Contrôle le statut du provisionement de la passerelle VPN | X |
Règles de découverte​
Le connecteur de supervision Centreon Azure VPN Gateway inclut un fournisseur de découverte d'hôtes nommé Microsoft Azure VPN Gateways. Celui-ci permet de découvrir l'ensemble des instances rattachées à une souscription Microsoft Azure donnée:
La découverte Azure VPN Gateway n'est compatible qu'avec le mode api. Le mode azcli n'est pas supporté dans le cadre de cette utilisation.
Rendez-vous sur la documentation dédiée pour en savoir plus sur la découverte automatique d'hôtes.
Métriques & statuts collectés​
- Health
- Site-Traffic
- Tunnel-Traffic
- Vpn-Gateway-Status
| Status Name | Description |
|---|---|
| status | Current operational status |
| summary | Last related status message |
| Metric Name | Unit |
|---|---|
| azvpngateway.site.traffic.bandwidth.bytespersecond | B |
| azvpngateway.p2s.traffic.bandwidth.bytespersecond | B |
| azvpngateway.p2s.connections.count |
| Metric Name | Unit |
|---|---|
| azvpngateway.tunnel.dropped.packets.in.count | |
| azvpngateway.tunnel.dropped.packets.out.count | |
| azvpngateway.tunnel.packets.in.count | |
| azvpngateway.tunnel.packets.out.count | |
| azvpngateway.tunnel.ingress.bytes | B |
| azvpngateway.tunnel.egress.bytes | B |
| Status Name | Unit |
|---|---|
| status |
Prérequis​
Rendez-vous sur la documentation dédiée afin d'obtenir les prérequis nécessaires pour interroger les API d'Azure.
Installation​
- Online License
- Offline License
- Installez le plugin sur tous les collecteurs Centreon devant superviser des ressources Azure VPN Gateway :
yum install centreon-plugin-Cloud-Azure-Network-VpnGateway-Api
- Sur l'interface web de Centreon, installez le connecteur de supervision Azure VPN Gateway depuis la page Configuration > Packs de plugins.
- Installez le plugin sur tous les collecteurs Centreon devant superviser des ressources Azure VPN Gateway :
yum install centreon-plugin-Cloud-Azure-Network-VpnGateway-Api
- Sur le serveur central Centreon, installez le RPM du connecteur de supervision Azure VPN Gateway :
yum install centreon-pack-cloud-azure-network-vpngateway
- Sur l'interface web de Centreon, installez le connecteur de supervision Azure VPN Gateway depuis la page Configuration > Packs de plugins.
Configuration​
Hôte​
- Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
- Remplissez le champ Adresse IP/DNS avec l'adresse 127.0.0.1.
- Appliquez le modèle d'hôte Cloud-Azure-Network-VpnGateway-custom.
- Une fois le modèle appliqué, renseignez les macros correspondantes. Attention, certaines macros sont obligatoires. Elles doivent être renseignées selon le custom mode utilisé.
Deux méthodes peuvent être utilisées lors de l'assignation des macros :
- Utilisation de l'ID complet de la ressource (de type
/subscriptions/<subscription_id>/resourceGroups/<resourcegroup_id>/providers/XXXXXX/XXXXXXX/<resource_name>) dans la macro AZURERESOURCE.- Utilisation du nom de la ressource dans la macro AZURERESOURCE et du nom du groupe de ressources dans la macro AZURERESOURCEGROUP.
- Azure Monitor API
- Azure AZ CLI
| Obligatoire | Macro | Description |
|---|---|---|
| x | AZUREAPICUSTOMMODE | Custom mode api |
| x | AZURECLIENTID | Client ID |
| x | AZURECLIENTSECRET | Client secret |
| x | AZURERESOURCE | ID or name of the Azure VPN Gateway resource |
| AZURERESOURCEGROUP | Resource group name if resource name is used | |
| x | AZURESUBSCRIPTION | Subscription ID |
| x | AZURETENANT | Tenant ID |
| Obligatoire | Macro | Description |
|---|---|---|
| x | AZURECLICUSTOMMODE | Custom mode azcli |
| x | AZURERESOURCE | ID or name of the Azure VPN Gateway resource |
| x | AZURERESOURCEGROUP | Resource group name if resource name is used |
| x | AZURESUBSCRIPTION | Subscription ID |
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 (su - centreon-engine) :
/usr/lib/centreon/plugins//centreon_azure_network_vpngateway_api.pl \
--plugin=cloud::azure::network::vpngateway::plugin \
--mode=health \
--custommode='api' \
--resource='' \
--resource-group='' \
--subscription='' \
--tenant='' \
--client-id='' \
--client-secret='' \
--proxyurl='' \
--ok-status='%\{status\} =~ /^Available$/' \
--warning-status='' \
--critical-status='%\{status\} =~ /^Unavailable$/' \
--unknown-status='%\{status\} =~ /^Unknown$/' \
--api-version=2017-07-01\
La commande devrait retourner un message de sortie similaire à :
OK: VPN Gateway '%s' Provisioning State '%s' [Gateway type: '%s'] [VPN type: '%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_azure_network_vpngateway_api.pl \
--plugin=cloud::azure::network::vpngateway::plugin \
--mode=site-traffic \
--help
Tous les modes disponibles peuvent être affichés en ajoutant le paramètre
--list-mode à la commande :
/usr/lib/centreon/plugins//centreon_azure_network_vpngateway_api.pl \
--plugin=cloud::azure::network::vpngateway::plugin \
--list-mode
Diagnostic des erreurs communes​
Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.