View Source

Principe

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.

Configuration

Pour définir le module source VMware :

Configurer la source dans le fichier /etc/shinken/sources/sync-vmware.cfg
pour activer la source et appeler le module "sync-vmware".
Vous devez ensuite déclarer la source VMware dans le fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

Durant l'installation de Shinken Enterprise une source VMWare appelée sync-vmware est créée, mais inactive.
Il s'agit juste d'un exemple.

sources/sync-vmware.cfg

Propriété	Exemple	Description
source_name	sync-vmware	Nom de la source. doit être unique..
order	3	Ordre dans la consolidation de l'algorithme pour cette source . Voir dans la page Synchronizer page pour plus d'information
import_interval	5	Intervalle en minute de chargement de la source.
modules	sync-vmware	module à lancer
enabled	0	1 - Activer la source 0 - Vue dans l'interface, mais ne collecte pas de données.
description	This source is about loading hosts from VMware vSphere	une description à montrer dans l'UI.
not_stored_properties	<liste de champs>	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
*vcenter*	vcenter.fqdn.com	FQDN (Fully Qualified Domain Name) ou adresse IP du serveur vSphere .
*user*	DOMAIN\user	Utilisateur pour se connecter au serveur vSphere - compte en lecture uniquement.
*password*	PASSWORD	Password pour l'accès utilisateur
*esx_templates*	esx	Host template a appliquer sur les hôtes esx ou les esx détectés .
*vm_templates*	vmware-vm	Host template à appliquer les serveurs virtuels.

La colonne par défaut montre la valeur utilisée par le module si l'administrateur ne le saisit pas.

Exemple de définition:

define source {
    source_name      sync-vmware
    module_type      sync-vmware
    order            4
    import_interval  5
    enabled          1
    description      This source is about loading hosts from VMware vSphere

    check_esx_path   /var/lib/shinken/libexec/synchronizer/esx_discovery.pl
    vcenter          vcenter.fqdn.com
    user             DOMAIN\admin
    password         admin_pwd
    esx_templates    esx
    vm_templates     vmware-vm
}

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