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.