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

Principe

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.

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

La configuration de ce collecteur se trouve par défaut 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 collecteur sync-vmware s'active comme les autres sources, c'est-à-dire en modifiant le fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du synchronizer ).

Exemple :

Infocode

titlelanguage	Note

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

source_name

sync-vmwareNom de la source. doit être unique..

order

3Ordre dans la consolidation de l'algorithme pour cette source . Voir dans la page Synchronizer page pour plus d'information

import_interval

5Intervalle en minute de chargement de la source.

modules

sync-vmwaremodule à 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 vSphereune 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.comFQDN (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

esxHost template a appliquer sur les hôtes esx ou les esx détectés .

vm_templates

vmware-vmHost template à appliquer les serveurs virtuels.

Info

title	Note

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

Exemple de définition:

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 :

Nom

Type

Unité

Défaut

Commentaire

Code Block
esx_templates

Texte

---

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

Code Block
vm_templates

Texte

---

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 {
    source_name      sync-vmware
    module_type      sync-vmware
    order            4
	[...]

    import_interval  5
    enabled          1#======== Templates association =========
    description# esx_templates: apply templates to detected This source is about loading hosts from VMware vSphere

esx servers
    check_esx_pathtemplates   /var/lib/shinken/libexec/synchronizer/esx_discovery.pl
    vcenter          vcenter.fqdn.com
    user             DOMAIN\adminesx,vSphere

    password# vm_templates: apply templates to     admin_pwddetected VM
    esxvm_templates    esx
    vm_templates     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 8

New Version Current

Key