Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Panel

title	Sommaire

Table of Contents

style	none

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":

Code Block

language	bash

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

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

Code Block
service shinken-synchronizer restart

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 :

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 ).
Une fois connectée, la source interroge le serveur vSphere ( ou ESX ) pour récupérer les informations des éléments à importer.
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 :

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

Le collecteur sync-vmware s'active comme les autres sources, c'est-à-dire en modifiant le fichier /etc/shinken

-user-example/configuration/daemons

/synchronizers/

sources/sync-vmware/sync-vmware-example.cfg

Exemple de fichier de configuration

Code Block

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


}

synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du synchronizer ).

Exemple :

Code Block

language	bash
theme	Confluence

  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

Panel
Image Added

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 :

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

Code Block
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 "$".

Code Block
module_type

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

Interval d'import et ordre de la source

NomTypeUnitéDéfautCommentaire

Code Block
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 )

Code Block
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.

Info

icon	false
title	Remarque

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

Connexion au serveur VMWare

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

Code Block

check_

esx_

path

Entier positif

minute

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

Code Block
vcenter

Entier positif

templates

Texte

---

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

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

Code Block

user

vm_templates

Texte

---

Identifiant permettant de se connecter au serveur ESX.

Code Block
password

Texte---Mot de passe permettant de se connecter au serveur ESX.

Association des modèles d'hôtes Shinken

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

Info
Plusieurs modèles d'hôtes peuvent être ajouter grâce au séparateur ",".

Exemple

Code Block

define source {

	[...]

Code Block

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

NomTypeUnitéDéfautCommentaire Code Block

esx_templates

Texte

---

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

Code Block

vm_templatesTexte

---

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

Propriétés non importées dans shinken

NomTypeUnitéDéfautDescription

Code Block
not_stored_properties

ListeListe de propriétésCe 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

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:

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:

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ément

Info

Code Block
Nom de l'élément

Tous les éléments

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

Code Block
address

hôte

fqdn

ip

Page tree

Versions Compared

Old Version 11

New Version Current

Key

Description

Activation du module

Introduction

Fonctionnement

Définition de la source

Activer le collecteur sync-vmware livré par défaut

Configuration

Exemple de fichier de configuration

Règles d'application des modèles

Définition d'une règle d'application des modèles

Détails des sections composant le fichier de configuration

Identification de la source

Interval d'import et ordre de la source

Connexion au serveur VMWare

Association des modèles d'hôtes Shinken

Exemple

Propriétés non importées dans shinken

Modèles automatiques pour les serveurs virtuels en fonction de leur OS

Serveurs vSphere multiples

Précisions techniques

Clés de synchronisation

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