| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Concept
Il est possible d’ajouter le suffixe [FORCE] ( sans 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 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
Exemple de valeur forcée dans un fichier d'import que pourrait importer un collecteur de type "cfg-file-import" :
| Code Block | ||||
|---|---|---|---|---|
| ||||
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 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 :
| Code Block | ||||
|---|---|---|---|---|
| ||||
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 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 ).
| Panel |
|---|
| Anchor | ||||
|---|---|---|---|---|
|
Liste des sources pouvant utiliser [FORCE]
Tous les écouteurs permettent de forcer des clés d'importsimport.
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 depuis un serveur Active Directory
- Depuis un serveur OpenLDAP
- ( 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 :
| Excerpt |
|---|
- exemple : "host_name" pour les Hôtes.
| -include | ||||||
|---|---|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Pour les Modèles de Hôtes et Clusters
Pour les Groupes d'hôtes
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| host_name | Nom |
| use | Modèles d'hôte appliqués |
| parents | Dépendances réseaux |
| hostgroups | Groupe d'hôtes |
| view_contacts | Les utilisateurs qui voient l'hôte |
| view_contact_groups | Les groupes d'utilisateurs qui voient l'hôte |
| notification_contacts | Les utilisateurs à notifier |
| notification_contact_groups | Les groupes d'utilisateurs à notifier |
| edition_contacts | Les utilisateurs qui peuvent modifier la configuration de l'hôte |
| edition_contact_groups | Les groupes d'utilisateurs qui peuvent modifier la configuration de l'hôte |
| escalations | Escalades |
| business_impact_modulations | Modulations d'impact métier |
| macromodulations | Modulations de données |
| resultmodulations | Modulation de résultats |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| name | Nom |
| use | Modèles d'hôte appliqués |
| parents | Dépendances réseau |
| hostgroups | Groupe d'hôtes |
| view_contacts | Les utilisateurs qui voient l'hôte |
| view_contact_groups | Les groupes d'utilisateurs qui voient l'hôte |
| notification_contacts | Les utilisateurs à notifier |
| notification_contact_groups | Les groupes d'utilisateurs à notifier |
| edition_contacts | Les utilisateurs qui peuvent modifier la configuration de l'hôte |
| edition_contact_groups | Les groupes d'utilisateurs qui peuvent modifier la configuration de l'hôte |
| escalations | Escalades |
| business_impact_modulations | Modulations d'impact métier |
| macromodulations | Modulations de données |
| resultmodulations | Modulation de résultats |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| hostgroup_name | Nom |
| members | Membres (Hôtes) |
| template_members | Membres (ayant les modèles d'hôtes) |
Pour les Check appliqué aux hôtes / modèles d'hôte / clusters / modèles de cluster
Pour les Modèles de check
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| service_description | Nom |
| use | Modèle de Check hérité |
| notes_multi_url | Liste des URL externes |
| contacts | Utilisateurs |
| contact_groups | Groupes d'utilisateurs |
| escalations | Escalades |
| business_impact_modulations | Modulations d'impact métier |
| macromodulations | Modulations de données |
| resultmodulations | Modulations des résultats |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| nom | Nom |
| use | Modèle de Check hérité |
| notes_multi_url | Liste des URL externes |
| contacts | Utilisateurs |
| contact_groups | Groupes d'utilisateurs |
| escalations | Escalades |
| business_impact_modulations | Modulations d'impact métier |
| macromodulations | Modulations de données |
| resultmodulations | Modulations des résultats |
Pour les Utilisateurs
Pour les Modèles d'utilisateur
Pour les Groupes d'utilisateurs
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| contact_name | Nom |
| use | Modèles d'utilisateur appliqués |
| contactgroups | Groupes d'utilisateurs |
| notificationways | Méthodes de Notification |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| name | Nom |
| use | Modèles d'utilisateur appliqués |
| contactgroups | Groupes d'utilisateurs |
| notificationways | Méthodes de Notification |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| contactgroup_name | Nom |
| members | Membres (Hôtes) |
| template_members | Membres (ayant les modèles d'hôtes) |
Pour les Escalades
Pour les Méthodes de notification
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| escalation_name | Nom |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| notificationway_name | Nom |
Pour les Modulations d'impact métier
Pour les Modulations de données
Pour les Modulations de résultats
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| business_impact_modulation_name | Nom de la Modulation d'impact métier |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| macromodulation_name | Nom de la Modulation de Données |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| resultmodulation_name | Nom de la modulation de résultats |
Pour les Commandes
Pour les Périodes de temps
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| command_name | Nom de la Commande |
| Clé d'import | Nom de la propriété dans l'interface |
|---|---|
| timeperiod_name | Nom de la période de temps |
