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 l es 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 fournies par défaut, mais il vous est possible de c ré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 valeurs utilisées lors de l'étape du mélange des sources ( Voir Modules de Sources ( imports ) et de Taggers ( qualification ) ) qui permet de choisir quel élément de cette source se mélange avec quel élément d'une autre source ( Voir Le mélange des sources & les clés de synchronisation (sync-key) ).

Propriétés par défaut utilisé pour la construction des clés de synchronisation


Propriété Type d'élémentInfo


Nom de l'élément


Tous les élémentsCette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation


address


hôte