Introduction

La source synchronizer-collector-vmware permet d’interroger l'API d'un serveur vSphere ( ESX / vCenter ) afin de récupérer toutes les informations disponibles des ESXs et des machines virtuelles présentes.

Une fois ces informations récupérées, la source va définir les hôtes Shinken qui permettront de superviser les ESXs et VM détectés et qui seront proposés au Synchronizer.


Il s'agit d'une version avancée du collecteur sync-vmware utilisant l'API de VMWare.


Nous conseillons d'utiliser CE COLLECTEUR plutôt que le collecteur sync-vmware, qui sera déprécié dans quelques versions ( voir la page DEPRECATED - Collecteur (sync-vmware) Import depuis des serveurs VMware ) .

Fonctionnement

Un mapping est une correspondance entre un champ VMWare et une propriété ou une donnée. 

La source fonctionne de la manière suivante : 

  1. La source via le module "synchronizer-collector-vmware" va se connecter à un vSphere ( ESX / vCenter )  avec l'adresse et les identifiants que vous aurez renseignés dans le fichier de configuration de la source ( voir ci-dessous ).

  2. Une fois connectée, la source interroge l'API VMWare pour récupérer les informations des vSpheres ( ESX / vCenter ) et des machines virtuelles.

  3. La source va créer les hôtes Shinken avec ces informations en effectuant les modifications suivantes :
    • Des modèles d'hôte pourront être ajoutés à l'hôte en fonction des règles d'applications de modèles définies.

Vous pouvez utiliser les règles par défaut, ou définir les vôtres .

Les modèles sont ajoutés si les champs collectés sur le serveur VMWare correspondent aux critères d'activation d'une règle.

    • Certains champs collectés de l'API VMWare sont mappés dans des propriétés ou des données de l'hôte.

Vous pourrez utiliser les mappings par défaut, ou définir les vôtres .


Une fois les informations du serveur VMWare récupérées, la source va proposer au Synchronizer : 

  • Un hôte pour chaque vSphere ( ESX / vCenter ) identifié.
  • Un hôte pour chacune des machines virtuelles identifiées.

Définition de la source

Vous trouverez la procédure de mise en place et de configuration dans la page suivante  Collecteur de type synchronizer-collector-vmware ( Pour ESX et VSphere )

Utilisation de la source

Import via la page principale

Une fois créé, le collecteur apparaîtra dans la liste des collecteurs.

Comme pour les autres sources, il vous suffit de cliquer sur le bouton triangle  pour importer les éléments du collecteur.

Les différentes étapes lors de l'importation des éléments ainsi que leur progression seront affichées dans la colonne Résultat de la source.

Présentation de l'interface de la source VMWare

La configuration du collecteur se fait par fichier de définition ( .cfg ou .json ), et son utilisation se fait par l'interface graphique.

  • En cliquant sur le nom de la source, vous ouvrirez l'interface qui lui est dédiée.


En préambule, vous pouvez :

  • Importer la source à partir de l'interface de cette source en cliquant en haut à droite de l'écran sur l'icône ,
  • Également recharger toute modification faite dans les .cfg et .json, en cliquant en haut à gauche sur l'icône .


Dans cette interface, vous aurez 5 onglets qui vous permettront de visualiser la configuration de la source et le résultat des imports :

Consultez les cinq chapitres pour plus de détails.