Page History

Concept

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

Lorsqu’une clé d'import est marquée avec [FORCE], elle est traîtée traitée de la manière suivante par le 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) ) :

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

Dans le cas d’une clé  Ajouter [FORCE] à une clé d'import contenant une liste ( comme la propriété "members" servant à définir les membres d'Membres (Utilisateurs)" sur un groupe d'utilisateurs ) aura pour effet de remplacer complètement la liste des autres sources par celle fournie avec l'option , 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]      TestTest host
	address				192.168.1.42
	use					modele1, modele2
}

Forcer une propriété à

la valeur

par défaut

Pour forcer 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 à 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 l'ordre la plus prioritaire ( avec le plus petit numéro d'ordre ) est retenuretenue.

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

Liste des sources pouvant utiliser [FORCE]

Tous les écouteurs peuvent permettent de 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

import.

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

• cfg-file-import ( voir la page Collecteur de type cfg-file-import ( format Shinken ou nagios ) )
• ldap-import
  • Depuis 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 ) )Depuis un serveur OpenLDAP
• 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 pouvant être forcées varient en fonction des collecteurs, par exemple les collecteurs de type synchronizer-collector-vmware ne peuvent importer que des hôtes et ne pourront donc pas forcer la clé "escalation_name".

La documentation de chaque collecteur indique précisément les clés d'import qu'ils peuvent forcer, mais la liste générale est la suivante :

d'import suivantes peuvent être forcées :