Aller au contenu principal

EMC Vplex Rest API

Contenu du Pack​

Objets supervisés​

Le Pack Centreon EMC VPLEX apporte un modèle d'hôte :

  • HW-Storage-EMC-Vplex-Restapi-custom

Il apporte les modèles de services suivants :

AliasModèle de servicesDescriptionDéfaut
Cluster-CommunicationHW-Storage-EMC-Vplex-Cluster-Communication-RestapiContrôle l'état de la communication du clusterX
Cluster-DevicesHW-Storage-EMC-Vplex-Cluster-Devices-RestapiContrôle l'état des périphériques du clusterX
DirectorsHW-Storage-EMC-Vplex-Directors-RestapiContrôle l'état des directeursX
Distributed-DevicesHW-Storage-EMC-Vplex-Distributed-Devices-RestapiContrôle l'état des périphériques distribuésX
FansHW-Storage-EMC-Vplex-Fans-RestapiContrôle l'état des ventilateursX
PsusHW-Storage-EMC-Vplex-Psus-RestapiContrôle l'état des alimentationsX
Storage-VolumesHW-Storage-EMC-Vplex-Storage-Volumes-RestapiContrôle l'état des volumesX

Métriques & statuts collectés​

Metric nameUnit
operational state

Prérequis​

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

Le Pack Centreon supporte l'APIv1 et l'APIv2. Les services Fans et Psus ne sont pas fonctionnelles avec l'APIv2 (non supporté par l'APIv2).

Installation​

  1. Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources EMC VPLEX :
yum install centreon-plugin-Hardware-Storage-Emc-Vplex-Restapi
  1. Sur l'interface web de Centreon, installer le Pack EMC Vplex 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 EMC VPLEX.
  • Appliquez le modèle d'hôte HW-Storage-EMC-Vplex-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireNomDescription
XVPLEXCUSTOMMODEAPI version used (Default: 'apiv1'. Can be: 'apiv2')
XAPIPORTPort used (Default: 443)
XAPIPROTOSpecify https if needed (Default: 'https')
XVPLEXUSERNAMEAPI username
XVPLEXPASSOWRDAPI password
VPLEXEXTRAOPTIONSAny 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_emc_vplex.pl \
--plugin=storage::emc::vplex::restapi::plugin \
--custommode='apiv1' \
--mode=cluster-communication \
--hostname='10.30.2.79' \
--port='443' \
--proto='https' \
--vplex-username='myusername' \
--vplex-password='mypassword' \
--verbose

La commande devrait retourner un message de sortie similaire à :

All cluster witness components are ok
Cluster witness component 'cluster-1' operational state: 'in-contact' [admin: enabled]
Cluster witness component 'cluster-2' operational state: 'in-contact' [admin: enabled]
Cluster witness component 'server' operational state: 'clusters-in-contact' [admin: enabled]

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_emc_vplex.pl \
--plugin=storage::emc::vplex::restapi::plugin \
--custommode='apiv1' \
--mode=cluster-communication \
--help

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

/usr/lib/centreon/plugins/centreon_emc_vplex.pl \
--plugin=storage::emc::vplex::restapi::plugin \
--custommode='apiv1' \
--list-mode

Diagnostic des erreurs communes​

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