Module de source de type sync-vmware

Description

Le module VMware se connecte au serveur vSphere.

• Il va détecter automatiquement toute nouvelle machine virtuelle et les hyperviseurs ESX.
• Il va collecter les données de l'ESX et des machines virtuelles.

Activation de la source

Vous pouvez essayer ce type de source soit en activant le collecteur sync-vmware présent par défaut ou en activant vos propres collecteurs de type sync-vmware.

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
• Vérifier que le nom "sync-vmware" est présent dans le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du Synchronizer ).
  • Ce collecteur est déjà présent dans la liste des sources livrées par défaut, il n'y a donc rien à modifier.
  • S'il n'y est pas ( car modifié ) , vous pouvez le rajouter pour qu'il soit de nouveau actif.

Exemple :

define synchronizer {
    [...]
    sources                   Source 1, Source 2, Source 3, sync-vmware
    [...]
}

• Si vous avez rajouté la source, redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source.

  service shinken-synchronizer restart

Ajouter un autre collecteur de type sync-vmware

Pour ajouter une autre source, vous devez : 

• Choisissez un nom pour ce nouveau collecteur.
  • Pour l'exemple, nous allons l'appeler "Mon-Collecteur-Vmware".
  • Remplacer dans l'exemple le mot "Mon-Collecteur-Vmware" par le nom que vous aurez choisi.

• Copier le fichier de définition de la source d'exemple : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg dans le répertoire de définition des sources /etc/shinken/sources/ et modifier son nom pour qu'il soit différent de la source sync-vmware livrée par défaut.
  ( Exemple : /etc/shinken/sources/Mon-Collecteur-Vmware.cfg )

cp  /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg /etc/shinken/sources/collector__sync-vmware__Mon-Collecteur-Vmware.cfg

Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

define synchronizer {
    [...]
    sources                   Source 1, Source 2, Source 3, sync-vmware
    [...]
}

Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source.

service shinken-synchronizer restart

Configuration

Voici le détail du fichier de configuration de la source qui se trouve ( suivant la procédure choisie ) :

• Soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/collector__sync-vmware__Mon-Collecteur-Vmware.cfg ).
• Soit dans le fichier /etc/shinken/sources/sync-vmware.cfg.

Exemple de fichier de configuration

Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/sources/sync-vmware/sync-vmware-example.cfg

#===============================================================================
# sync-vmware
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# This source import hosts from a vSphere server
#===============================================================================


define source {

    #======== source identity =========
    # Source name. Must be unique
    source_name		sync-vmware

    # Module type (to load module code). Do not edit.
    module_type     	sync-vmware

    # order: source order for a source imply if a source is before an another source when
    # merging data
    order		    3

    # import_interval:  in minutes, what is the schedule import interval for this source.
    # note: 0 = don't schedule this source, will run only if an administrator launch it from the
    # interface
    import_interval	5

    # enabled: is this source enabled or not
    enabled		    0

    # description: display a description on the interface for this source
    description		This source is about loading hosts from VMware vSphere



    #======== vSphere access =========
    # command used to grab vSphere information. Do not edit.
    check_esx_path	/var/lib/shinken/libexec/synchronizer/esx_discovery.pl

    # vcenter:      ip/fqdn of your vcenter server
    vcenter		          vcenter.fqdn.com

    # user:         user to login to vSphere
    user		    DOMAIN\user

    # password:     password to login to vSphere
    password	  	PASSWORD



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

    # vm_templates: apply templates to detected VM
    vm_templates	vmware-vm


}

Détails des sections composant le fichier de configuration

Identification de la source

Il est possible de définir plusieurs instances de module de type "sync-vmware" dans votre architecture Shinken.

• Chaque instance devra avoir un nom unique.
  
  

source_name 

module_type 

Intervalle d'import et ordre de la source

Connexion au serveur VMWare

Association des modèles d'hôtes Shinken 

Propriétés non importées dans shinken

Il est possible de définir des propriétés que la source ne devra pas récupérer.

Dans le cas de cette source, il se peut que la source remonte des informations sensibles ou que vous ne voulez pas importer dans Shinken.