Page History

Concept

Il est possible d’ajouter le suffixe [FORCE] ( sans espace ) à la clé d’import d'un élément Shinken afin de forcer la valeur associée.

Lorsqu’une clé d'import est marquée avec [FORCE], elle est traitée de la manière suivante par le mélange des sources ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ) :

• Sa valeur est considérée comme prioritaire par rapport aux autres sources
• Si une autre source importe le même objet avec une valeur différente, cette dernière est ignorée
• En cas de conflit entre plusieurs valeurs forcées, la priorité de la source détermine la valeur conservée

 Ajouter [FORCE] à une clé d'import contenant une liste ( comme la propriété "members" servant à définir les membres d'un groupe d'utilisateurs ) aura pour effet de remplacer complètement la liste des autres sources par celle fournie avec l'option [FORCE]

Toutes les clés ne peuvent pas être forcées et toutes les sources ne peuvent pas forcer des clés Seules les sources permettant de choisir dans quelles propriétés Shinken seront placées les informations qu'elles récupèrent ( mapping ) peuvent utiliser le suffixe [FORCE] ( voir le chapitre Clés Sources pouvant forcer des clés d'imports pouvant être forcées en fonction des sourceset 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 avec le plus petit numéro d'ordre est retenu.

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 ).

Sources pouvant forcer des clés d'imports

Les analyseurs

Les analyseurs ne permettant pas de choisir les informations récupérées sur les hôtes ni de définir dans quelles propriétés Shinken elles seront placées, ces sources ne peuvent donc pas utiliser le suffixe [FORCE]

et les clés forçables

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

Les collecteurs suivant ne permettant pas de choisir les informations récupérées sur les hôtes ni de définir dans quelles propriétés Shinken elles seront placées, ces sources ne peuvent donc pas utiliser le suffixe [FORCE] : 

Seuls les types de collecteurs suivants son susceptibles d'utiliser le permettent l'utilisation du [FORCE] :

• cfg-file-import
• ldap-import
  • Depuis un serveur Active Directory
  • Depuis un serveur OpenLDAP
• synchronizer-collector-vmware
• synchronizer-collector-excel

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