Aller au contenu principal

Thales Mistral VS9 Rest API

Contenu du Pack​

Modèles​

Le Pack Centreon Thales Mistral VS9 Rest API apporte 2 modèles d'hôte différents :

  • App-Thales-Mistral-Vs9-Host-Restapi-custom
  • App-Thales-Mistral-Vs9-Mmc-Restapi-custom

Il apporte les modèles de service suivants :

AliasModèle de serviceDescriptionDéfaut
CertificatesApp-Thales-Mistral-Vs9-Host-Device-Certificates-RestapiContrôle les certificatesX
Connection-StatusApp-Thales-Mistral-Vs9-Host-Device-Connection-Status-RestapiContrôle la connexion au MMCX
InterfacesApp-Thales-Mistral-Vs9-Host-Device-Interfaces-RestapiContrôle les interfacesX
MistralApp-Thales-Mistral-Vs9-Host-Device-Mistral-RestapiContrôle l'équipement MistralX
SystemApp-Thales-Mistral-Vs9-Host-Device-System-RestapiContrôle le systèmeX
TunnelsApp-Thales-Mistral-Vs9-Host-Device-Tunnels-RestapiContrôle les tunnels vpnX

Règles de découverte​

Nom de la règleDescription
Thales Mistral VS9 DevicesDiscover devices from Thales Mistral MMC inventory

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​

MétriqueUnité
clusters.detected.count
cluster status
member status
cluster_name~member_name#member.contact.last.time.secondss

Prérequis​

Pour la supervision, un utilisateur avec les droits en lecture sur l'API MMC est nécessaire.

Installation​

Pack de supervision​

Si la plateforme est configurée avec une licence online, l'installation d'un paquet n'est pas requise pour voir apparaître le pack dans le menu Configuration > Gestionnaire de connecteurs de supervision.

Au contraire, si la plateforme utilise une licence offline, installez le paquet sur le serveur central via la commande correspondant au gestionnaire de paquet associé à sa distribution :

dnf install centreon-pack-applications-thales-mistral-vs9-restapi

Quel que soit le type de la licence (online ou offline), installez le Pack Thales Mistral VS9 Rest API depuis l'interface web et le menu Configuration > Gestionnaire de connecteurs de supervision.

Plugin​

À partir de Centreon 22.04, il est possible de demander le déploiement automatique du plugin lors de l'utilisation d'un pack. Si cette fonctionnalité est activée, et que vous ne souhaitez pas découvrir des éléments pour la première fois, alors cette étape n'est pas requise.

Plus d'informations dans la section Installer le plugin.

Utilisez les commandes ci-dessous en fonction du gestionnaire de paquets de votre système d'exploitation :

dnf install centreon-plugin-Applications-Thales-Mistral-Vs9-Restapi

Configuration​

Hôte​

Mistral équipement​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre serveur Thales Mistral VS9 Host.
  • Appliquez le modèle d'hôte App-Thales-Mistral-Vs9-Host-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireMacroDescription
XDEVICEID
XDEVICESN
XMMCAPIHOSTNAME
XMMCAPIUSERNAME
XMMCAPIPASSWORD
MMCAPIPORT(Défaut : '5572')
MMCAPIPROTO(Défaut : 'https')
MMCAPIEXTRAOPTIONS--insecure

Mistral MMC​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre serveur Thales Mistral VS9 MMC.
  • Appliquez le modèle d'hôte App-Thales-Mistral-Vs9-Mmc-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireMacroDescription
XMMCAPIUSERNAME
XMMCAPIPASSWORD
MMCAPIPORT(Défaut : '5572')
MMCAPIPROTO(Défaut : 'https')
MMCAPIEXTRAOPTIONS--insecure

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_thales_mistral_vs9_restapi.pl \
    --plugin=apps::thales::mistral::vs9::restapi::plugin \
    --mode=mmc-cluster \
    --hostname='10.0.0.1' \
    --port='5572' \
    --proto='https' \
    --api-username='my-username' \
    --api-password='my-password' \
    --verbose

La commande devrait retourner un message de sortie similaire à :

OK: cluster enabled: yes, replication status: synchronized - all nodes are ok | 'cluster.synchronization.done.percentage'=0%;;;0;100
node 'mmc-1.local' status: true
node 'mmc-2.local' status: true

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_thales_mistral_vs9_restapi.pl \
    --plugin=apps::thales::mistral::vs9::restapi::plugin \
    --mode=mmc-cluster \
    --help

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

/usr/lib/centreon/plugins//centreon_thales_mistral_vs9_restapi.pl \
    --plugin=apps::thales::mistral::vs9::restapi::plugin \
    --list-mode

Diagnostic des erreurs communes​

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