View Source

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 du module

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/, 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.

Nom

Type

Unité

Défaut

Commentaire

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-vmware

Ne peut être modifié.

Intervalle d'import et ordre de la source

Nom

Type

Unité

Défaut

Commentaire

import_interval

Entier positif

minute

5

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

Nom

Type

Unité

Défaut

Commentaire

 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

Nom

Type

Unité

Défaut

Commentaire

  esx_templates

Texte

---

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

  vm_templates

Texte

---

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

Propriétés non importées dans shinken

Nom

Type

Unité

Défaut

Description

   not_stored_properties

Liste

Liste 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

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:

Dupliquer les fichiers de configuration de la source (.cfg), par exemple:
- /etc/shinken/sources/sync-vmware.cfg => /etc/shinken/sources/sync-vmware-EU.cfg
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
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
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