Page History

Concept

Il est possible d’ajouter le suffixe [FORCE] ( sans rajouter d'espace ) à la clé d’import d d'un élément Shinken afin de forcer la valeur associée ( voir la page Forcer la valeur des noms des éléments et des propriétés de type liste (comme la propriété des modèles hérités) ).

Lorsqu’une propriété clé d'import est marquée avec [FORCE], son comportement est le suivant :elle est traîté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 La 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  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]

Forcer une clé d'import

Toutes les clés ne peuvent pas être forcées et toutes les sources ne peuvent pas forcer des clés ( voir le chapitre Clés d'imports pouvant être forcées en fonction des sources )

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

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

Exemple :

# Source 1
define host {
	_SE_UUID          	core-hosts-YVBpgGqQy05Eaib9DVYWueBbmt3d15RO
	_SE_UUID_HASH     	66619d536ac4989991ca746c174a3060 	
 	host_name[FORCE]    Test host - source 1
	address				192.168.1.1242
	use					modele1, modele2
}

Liste des clés d'import pouvant être forcées

Forcer une propriété à aucune valeur

Dans certains cas, on veut définir spécifiquement qu'une propriété d'un objet n'a aucune valeur. Cela signifie aussi que cette propriété n'aura pas de valeur héritée d'un modèle.

On peut obtenir ce comportement en utilisant 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 l'ordre 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 ).

Clés d'imports pouvant être forcées en fonction des sources

Les analyseurs

Les analyseurs ne peuvent pas utiliser le [FORCE]

Les écouteurs

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

La seule clé pouvant être forcée est :

• use

Il s'agit de la clé permettant de définir les modèles d'un élément.

Les collecteurs

Seuls les types de collecteurs suivants peuvent utiliser le [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 :