Page History

Concept

La configuration du collecteur, définie dans le fichier de configuration de la source ( p our la source par défaut : /etc/shinken/sources/voir la pageCollecteur de type synchronizer-collector-vmware .cfg( Pour vSphere - ESXi/vCenter ) ) peut être consultée dans l'onglet "Configuration", dont les différentes parties sont décrites ci-dessous.

Cet onglet est divisé Elle est divisée en 5 chapitres :

• 1 - Configuration générale
• 2 - Options de mélange des sources
• Dépôts des 3 - Choix de l'espace sur lequel seront placés les éléments importés
• 4 - Clés spécifiques à la source
• Clé 5 - Clés de synchronisation ( sync_key )

Remarque : Cet onglet ne permet pas encore d'éditer la configuration ( => Sera implémenté dans une prochaine version )

Les différentes parties de l'onglet

1 - Configuration générale

Ce chapitre contient tous les paramètres pour le chargement et fonctionnement des sources en général.

Nom

Type de Module

import_interval

Délai écoulé entre les imports automatiques de la source. 

Description

Intervalle d'Import

Ordre

Éléments Shinken

 importé

2 - Options de mélange des sources

Mode de mélange des sources

Mode de mélange des sources

Grace au paramètre "Mode de mélange des sources" ( merge_mode dans le fichier de configuration de la source ) il est possible de modifier comment est gérée une source lors de l'étape du mélange des sources.

Voir la page : Le mélange des sources & les clés de synchronisation (sync-key)

La valeur par défaut est : all

Les valeurs possibles sont : 

merge_mode

Ce paramètre peut avoir les valeurs suivantes :

A utiliser si votre source vous donne un élément complet et que vous vous voulez le modifier via l'interface de configuration.

A utiliser si votre source vous donne un élément à compléter avec d'autres sources mais qui ne doit pas être modifié par l'interface de configuration.

Détecter les nouveaux éléments

Calculer les différences

Si un même élément est importé par plusieurs sources, alors les éléments seront fusionnés pour n'en donner qu'un.

Cas par défaut : les éléments de cette source seront complétés avec les autres sources et l'interface de configuration.

compute_new_element

Ce paramètre peut avoir les valeurs suivantes :

authorized 

Suppression des éléments absents

Détecter les éléments qui ne sont plus présent dans la source

Permets de proposer en suppression, les éléments qui ne sont plus présents dans la ou les source/s.

Calculer les différences

Détecter les éléments qui ne sont plus présents dans la source

Permets de rajouter une période de maintenance sur les éléments qui seront supprimés par la configuration de la source.

Ce paramètre peut avoir les valeurs suivantes :

disabled

Les éléments qui ne sont plus présents dans la(les) source(s) ne seront pas proposés à la suppression.

delete_if_missing_in

_all_sources

Les éléments, qui ne sont plus présents dans cette source et qui n'existent pas dans les autres sources (sauf Syncui), seront proposés à la suppression.

delete_if_missing_in

_this_source

Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.

Définir une Période de maintenance sur les éléments supprimés

Dépôt des éléments après l'import

Mettre dans l'espace

Options de mélange des sources - Précisions

Mode de mélange des sources

Ce paramètre sert à définir le mode de mélange entre les éléments récupérés de cette source et les autres sources.

Valeurs possibles :

• Ne fusionne pas avec les autres :
  • Les éléments récoltés par cette source seront importés, mais pas fusionnés avec les autres sources. S'il existe le même élément importé par une autre source, les éléments ne seront pas importés.
    
    
• Seulement avec "Syncui" :
  • Si un élément importé par cette source est aussi récolté par "Syncui", ils seront fusionnés pour ne donner qu'un élément.
    
    
• Tout sauf Syncui :
  • Si un même élément est importé par plusieurs sources ( à part "Syncui" ), alors les éléments seront fusionnés pour n'en donner qu'un.
    
    
• Toutes :
  • Si un même élément est importé par plusieurs sources, alors les éléments seront fusionnés pour n'en donner qu'un.

Détecter les éléments qui ne sont plus présents dans la source

Ce paramètre permet de proposer en suppression les éléments qui ne sont plus présents dans la source. 

Les différentes valeurs possibles sont :

• Désactiver ( disabled )
  • Les éléments qui ne sont plus présents dans la source ne seront pas proposés à la suppression.
    
    
• Supprimer s'ils ne sont pas dans cette source ( delete_if_missing_in_this_source ) :

  • Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.

    Info
    title A noter :
    Même si l'élément est présent dans une autre source, il sera proposé à la suppression.

• Supprimer s'ils ne sont pas dans TOUTES les sources ( delete_if_missing_in_all_sources ) :

  • Les éléments, qui ne sont plus présents dans cette source et qui n'existent pas dans les autres sources (sauf Syncui), seront proposés à la suppression.

    Info
    title A noter :
    Si l'élément était présent sur deux sources, qu'il a été supprimé uniquement sur cette source, il ne sera pas proposé à la suppression.

Définir une Période de maintenance sur les éléments supprimés

Ce paramètre permet de rajouter une période de maintenance sur les éléments qui seront supprimés par la configuration de la source.

• C'est utile lorsqu'un hôte est supprimé dans le référentiel de la source ( dans l'ESXi par exemple ), mais que cette suppression n'a pas encore été appliquée dans les Interfaces de Visualisation ( mise en production ).
  Ceci évitera les notifications liées à la disparition de l'équipement.
  
  

• Pour que les Périodes de maintenance puissent être effectives, il faut que le Script d'interprétation des traps avec le module receiver-module-webservice soit activé sur le Receiver.

3 - Choix de l'espace où seront placés les éléments importés

Mettre dans l'espace - Précisions

Les valeurs possibles de cette option sont :

4 - Clés spécifiques à la source

Utilisateur utilisé pour la sauvegarde des changements

Clés spécifiques à la source

Ce chapitre liste tous les paramètres qui sont spécifiques au fonctionnement de cette source.

Dans cette source, il s'agit des informations de connexion au serveur VMWare :

vmware_server_ip

vmware_server_port

vmware_server_use_ssl

vmware_server_username

vmware_server_password

vmware_connection_timeout

Précisions techniques

5 - Clés de synchronisation

Les clés de synchronisation sont des valeurs utilisées lors de l'étape du mélange des sources ( Voir voir la page 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 voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).

Le paramètre :

• properties_used_as_synckey_for_host

hosts de la source permet d'ajouter les propriétés qui serviront à créer les clés de synchronisation ( Voir voir la page Collecteur de type synchronizer-collector-vmware ( Pour ESX et VSphere vSphere - ESXi/vCenter )).

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

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

Nom de l'élément

_SE_UUID

Besoin de confirmation

Lorsqu'une modification de la configuration de la source est faite, elle peut impacter les éléments importés avec l'ancienne configuration. Par exemple, ils seront automatiquement supprimés, si vous avez activé la suppression automatique a été activée ou si vous elle l'activez est dans le futur.

Pour pallier ce problème, une demande de confirmation apparaîtra si votre la nouvelle configuration de source impacte ou pourra impacter les éléments précédemment importés.

Cette demande de confirmation s'active lorsque la valeur du paramètre "Mettre dans l'espace" ( put_in ) est différente de "Espace de calcul des sources".

• Détecter les nouveaux éléments

• ( compute_new_element )
• Calculer les différences

• ( compute_element_difference )
• Détecter les éléments qui ne sont plus présents dans la source

• ( compute_deleted_element_not_in_source )
• Mettre dans l'espace

• ( put_in )
• Adresse du serveur VMWare

• ESXi distant

• ( vmware_server_ip )

Erreurs de configuration

Dans le cas où , vous renseignez une clé non reconnue par Shinken est renseignée dans la configuration de la source, une erreur apparaîtra.

Cette erreur rendra l'import de la source impossible.