Introduction

La source collecteur sync-vmware permet d'interroger un serveur vSphere ou d'un ESX afin de récupérer toutes les informations disponibles.

Une fois ces informations récupérées, la source va définir les hôtes Shinken qui seront proposés au Synchronizer.

Fonctionnement

La source fonctionne de la manière suivante : 

  1. La source via le module "sync-vmware" va se connecter à un serveur vSphere ( ou ESX ) avec l'adresse et les identifiants que vous aurez renseignés dans le fichier de configuration de la source ( voir Module de source de type sync-vmware ).
  2. Une fois connectée, la source interroge le serveur vSphere ( ou ESX ) pour récupérer les informations des éléments à importer.
  3. La source va créer les hôtes Shinken avec ces informations en y ajoutant des modèles d'hôte en fonction des règles d'applications de modèles définies.
    • Vous pouvez définir vos propres règles.
    • Les modèles sont ajoutés si les champs collectés sur le serveur vSphere ( ou ESX ) correspondent aux critères d'activation d'une règle.


Une fois les informations du serveur vSphere ( ou ESX ) récupérées, la source va proposer au Synchronizer les hôtes importés.

Définition de la source

Activer le collecteur sync-vmware livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de collecteur sync-vmware.

La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/sources/sync-vmware.cfg


Le collecteur sync-vmware s'active comme les autres sources, c'est-à-dire en modifiant le fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du synchronizer )

Exemple :

  sources               syncui, discovery, listener-shinken, server-analyzer, cfg-file-shinken, listener-rest, openldap-example, sync-vmware


Régles d'application des modèles

Une règle d'application des modèles permet de définir une ou plusieurs condition(s), permettant à la source d'attribuer un modèle à un hôte en fonction de la valeur d'un attribut vSphere ( ou ESX ).

La source dispose de quelques règles d'application fournie par défaut, mais il vous est possible de créer vos propres règles d'application.

Définition d'une règle d'application des modèles



Les modèles appliqués lors de l'import des éléments sont à définir dans le fichier de configuration de la source ( /etc/shinken/sources/sync-vmware.cfg )

Pour définir les modèles d'hôtes appliqués sur les éléments lors de l'import, il vous faudra modifier les paramètres suivants :


NomTypeUnitéDéfautCommentaire


esx_templates


Texte

---

Modèle d'hôtes Shinken associé aux ESX récupérés.


vm_templates


Texte

---


Modèle d'hôtes Shinken associé aux machines virtuelles récupérées.


Plusieurs modèles d'hôtes peuvent être ajouter grâce au séparateur ",".


Exemple 


define source {

	[...]

    #======== Templates association =========
    # esx_templates: apply templates to detected esx servers
    esx_templates       esx,vSphere

    # vm_templates: apply templates to detected VM
    vm_templates        vmware-vm,virtual-machine

	[...] 

}


Modèles automatiques pour les serveurs virtuels en fonction de leur OS

Certains modèles d'hôtes sont ajoutés automatiquement aux serveurs détectés en fonction de la valeur définie dans les données vSphere
(définition VM et/ou outils VMware ).

Voici une liste de modèles qui peuvent être attachés automatiquement:

  • centos
  • debian
  • debian5
  • debian6
  • fedora
  • linux
  • oracle-linux
  • redhat
  • redhat4
  • redhat5
  • redhat6
  • windows
  • windows-datacenter
  • windows-enterprise
  • windows2000
  • windows2003
  • windows2008
  • windows2008r2
  • windows2012
  • windows7
  • windowsnt
  • windowsvista
  • windowsxp


Serveurs vSphere multiples

Une source/module peut parler à un seul serveur vSphere. Pour récupérer les données de plusieurs serveurs vSphere , vous devez définir autant de modules/sources correspondants.


Pour lier votre solution de supervision à un serveur vSphere, vous devez:

  1. Dupliquer les fichiers de configuration de la source (.cfg), par exemple:
    • /etc/shinken/sources/sync-vmware.cfg => /etc/shinken/sources/sync-vmware-EU.cfg


  2. Mettre à jour les paramètres à l'intérieur de la source dans le fichier /etc/shinken/sources/sync-vmware-EU.cfg en pointant vers le nouveau serveur vSphere:
    • au minimum, vous devez changer les paramètres vcenter 
      • => source_name     sync-vmware
      • => vcenter               myesx-EU.ovh.com

  3. Déclarer votre nouvelle source dans le synchronizer . Editer le fichier /etc/shinken/synchronizers/synchronizer-master.cfg

    • Editer les lignes sources:

      • sources               syncui,cfg-file-shinken,active-dir,sync-vmware,sync-vmware-EU,cfg-file-nagios,discovery

  4. Redémarrer ensuite le synchronizer

    • => service shinken restart synchronizer

Précisions techniques

Clés de synchronisation

Les clés de synchronisation sont des propriétés des objets utilisées pour les identifier dans les sources. Le fonctionnement et l'utilité des clés de synchronisation sont décrits de manière plus détaillée dans la page de documentation dédiée: Précision technique sur le fonctionnement de l'import des sources.


Les propriétés VMWare suivantes sont ajoutées comme clés de synchronisation de l'objet Shinken:

  • fqdn
  • ip