Concept

Il est possible d’ajouter le suffixe [FORCE] ( sans espace ) à une clé d’import dans Shinken afin d’imposer la valeur associée lors du mélange des sources.

Lorsqu’une clé est marquée avec [FORCE], elle est traitée de manière spécifique lors du mélange des sources ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ) :

• La valeur définie est considérée comme prioritaire par rapport à celles provenant d’autres sources.
• Si une autre source importe le même objet avec une valeur différente, celle-ci est ignorée.
• En cas de conflit entre plusieurs valeurs forcées, c’est la priorité des sources qui détermine la valeur retenue.

Dans le cas d’une clé contenant une liste ( comme la propriété Membres (Utilisateurs) sur un groupe d'utilisateurs ), l’ajout de [FORCE] entraîne le remplacement complet des valeurs.

• Toutes les clés ne peuvent pas être forcées.
• Seules les sources permettant de définir explicitement le mapping des propriétés Shinken peuvent utiliser le suffixe [FORCE] ( voir le chapitre Sources pouvant forcer des clés d'import et les clés forçables ).

Exemple de valeur forcée dans un fichier d'import que pourrait importer un collecteur de type "cfg-file-import" :

define host {
	host_name[FORCE]    Test host
	address				192.168.1.42
	use					modele1, modele2
}

Forcer une propriété à la valeur par défaut

Pour forcer une propriété d'un objet à sa valeur par défaut, on peut utiliser la valeur "null".

Exemple de valeur forcée à null dans un fichier d'import que pourrait importer un collecteur de type cfg-file-import :

define host {
	host_name 		mon_hote
	parents[FORCE]	null
}

Exemple

Résolution de conflits entre plusieurs [FORCE]

Lorsque le suffixe [FORCE] est utilisé dans plusieurs sources, la valeur provenant de la source la plus prioritaire ( avec le plus petit numéro d'ordre ) est retenue.

Par exemple, les trois sources suivantes :

• utilisent l'adresse comme clé de synchronisation ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ),
• et importent chacune un hôte ayant :
  • la même adresse ( clé d'import address ),
  • et un nom différent ( clé d'import host_name ).

Les objets sont en conflit car le mélange des sources veut les regrouper ( même clé de synchronisation ).

Liste des sources pouvant utiliser [FORCE]

Tous les écouteurs permettent de forcer des clés d'import.

Seuls les types de collecteurs suivants permettent l'utilisation du [FORCE] :

• cfg-file-import ( voir la page Collecteur de type cfg-file-import ( format Shinken ou nagios ) )
• ldap-import
  • depuis un serveur Active Directory ( voir la page Collecteur de type ldap-import ( pour Active Directory ) )
  • depuis un serveur OpenLDAP ( voir la page Collecteur de type ldap-import ( pour Open LDAP ) )
• synchronizer-collector-vmware ( voir la page Collecteur de type synchronizer-collector-vmware ( Pour vSphere - ESXi/vCenter ) )
• synchronizer-collector-excel ( voir la page Collecteur de type synchronizer_collector_excel ( Pour importer un fichier Excel ) )

Liste des clés pouvant utiliser [FORCE]

Les clés d'import suivantes peuvent être forcées :