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

La source ne peut s'activer que sur le Synchronizer.

  • L'activation de la source s'effectue en ajoutant le nom de cette source dans le fichier de configuration du démon Synchronizer.
  • Pour ce faire, ouvrer le fichier de configuration à l'emplacement /etc/shinken/synchronizer/synchronizer-master.cfg, et ajouter le nom de votre collecteur "sync-vmware".


Exemple: par défaut, nous livrons un module dont le nom est "sync-vmware":

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


Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:

service shinken-synchronizer restart


Configuration

La configuration du module se trouve par défaut dans le fichier  /etc/shinken/sources/sync-vmware.cfg

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

Exemple de fichier de configuration


#===============================================================================
# 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.


NomTypeUnitéDéfautCommentaire


source_name


Texte---sync-vmware

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Chaîne de caractères composée de lettres, de chiffres et des caractères _  et - .

  • Doit être unique.
  • Doit commencer par une lettre.
  • D'une longueur maximum à 40 caractères.
  • Ne doit pas contenir le caractère "$".


module_type 


Texte---sync-vmwareNe peut être modifié.


Intervalle d'import et ordre de la source


NomTypeUnitéDéfautCommentaire


import_interval


Entier positif

minute5

Délai écoulé entre les imports automatiques de la source.
Si 0, l'import de la source ne sera jamais exécuté automatiquement. ( L'import ne pourra être effectué uniquement manuellement )


order


Entier positif

---

99

L'ordre de la source dans l'interface de configuration ( A un impact dans la fusion des données lors des imports de sources ).

Voir la page du Synchronizer pour plus d'information au sujet des fusions. 

Si vous changez l'ordre depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour.

 


Connexion au serveur VMWare


 	#======== 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



NomTypeUnitéDéfautCommentaire


check_esx_path


Entier positif

minute

Commande utilisée pour récupérer les informations du Vsphere / ESX.


vcenter


Entier positif

---


Correspond à l'adresse réseau ( IP ou DNS ) du serveur ESX.


user


Texte---

Identifiant permettant de se connecter au serveur ESX.


password


Texte---

Mot de passe permettant de se connecter au serveur ESX.


Association des modèles d'hôtes Shinken 


   	#======== Templates association =========
    # esx_templates: apply templates to detected esx servers
    esx_templates   esx
 
    # vm_templates: apply templates to detected VM
    vm_templates    vmware-vm



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.


Propriétés non importées dans shinken


NomTypeUnitéDéfautCommentaire

 

not_stored_properties


ListeListe de propriétés
Ce paramètre permet de définir un ou plusieurs champs qui ne seront pas importés dans Shinken. Cela peut être utile pour exclure une propriété ou bien utiliser des champs personnalisés utiles pour la gestion de vos fichiers .cfg