Aller au contenu principal

Aruba Orchestrator Rest API

Contenu du Pack​

Objets supervisés​

Le Pack Centreon Aruba Orchestrator apporte un modèle d'hôte :

  • Net-Aruba-Orchestrator-Restapi-custom

Il apporte les modèles de services suivants :

AliasModèle de servicesDescriptionDéfaut
AlarmsNet-Aruba-Orchestrator-Alarms-RestapiContrôle les alarmesX
AppliancesNet-Aruba-Orchestrator-Appliances-RestapiContrôle l'état des appliancesX

Règles de découverte​

Nom de la règleDescription
Aruba Orchestrator ApplianceDécouverte des appliances

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​

Metric nameUnit
alerms.problems.current.count
alarms.severity.minor.count
alarms.severity.warning.count
alarms.severity.major.count
alarms.severity.critical.count

Prérequis​

Afin de contrôler votre équipement Aruba Orchestrator, l'API Rest doit être configurée.

Installation​

  1. Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Aruba Orchestrator :
yum install centreon-plugin-Network-Aruba-Orchestrator-Restapi
  1. Sur l'interface web de Centreon, installer le Pack Aruba Orchestrator Rest API 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 et IP Address / DNS correspondant à votre équipement Aruba Orchestrator.
  • Appliquez le modèle d'hôte Net-Aruba-Orchestrator-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireNomDescription
XAPIPORTPort used (Default: 443)
XAPIPROTOSpecify https if needed (Default: 'https')
XAPIACCESSTOKENAPI token
APIEXTRAOPTIONSAny extra option you may want to add to the command (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 (su - centreon-engine) :

/usr/lib/centreon/plugins/centreon_aruba_orchestrator_restapi.pl \
--plugin=network::aruba::orchestrator::restapi::plugin \
--mode=appliances \
--hostname='10.30.2.79' \
--port='443' \
--proto='https' \
--api-token='mytoken' \
--verbose

La commande devrait retourner un message de sortie similaire à :

OK: appliances detected: 2 - All appliances are ok | 'appliances.detected.count'=2;;;0;
appliance 'EU-FRA-IDF-PARIS-ARCHIVES-SP2' [group: Network > France > Paris] state: normal
appliance 'EU-FRA-IDF-SPATHUS-ARCHIVES-SP2' [group: Network > France > Saint-Pathus] state: normal

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_aruba_orchestrator_restapi.pl \
--plugin=network::aruba::orchestrator::restapi::plugin \
--mode=appliances \
--help

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

/usr/lib/centreon/plugins/centreon_aruba_orchestrator_restapi.pl \
--plugin=network::aruba::orchestrator::restapi::plugin \
--list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.