Versions Compared

Old Version 20

changes.mady.by.user Montassier Paul

Saved on

compared with

New Version 21

changes.mady.by.user Montassier Paul

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Présentation

Cet onglet permet de consulter la configuration du collecteur, telle que définie dans le fichier de configuration de la source ( voir la page  Collecteur de type synchronizer-collector-linker ( pour lier 2 Shinkens ) ).

Cet onglet ne permet pas encore d'éditer la configuration ( → sera implémenté dans une prochaine version )

Configuration générale

Panel

Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

Modules

No Format
source_name
Texte---synchronizer-collector-linker

Il est conseillé de choisir un nom en fonction de l'utilisation du module pour que la configuration soit simple à maintenir.

Caractères autorisés : lettres, chiffres, underscore ( _ ), et trait d'union ( - )

  • Doit être unique.
  • Doit commencer par une lettre.
  • D'une longueur maximum de 40 caractères.

Type de Module

No Format
module_type 
Texte---synchronizer-collector-linkerNe peut pas être modifié. Pour cette source, le module_type est "synchronizer-collector-linker".

Ordre

No Format
order
Entier positif

---

2


L'ordre de la source dans l'interface de configuration et dans le mélange des sources( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).


Info
iconfalse

Si l'ordre est changé depuis l'interface, le fichier .cfg sera mis à jour.

 

Intervalle d'import

No Format
import_interval

Entier positif

minute0

Délai écoulé entre les imports automatiques de la source. 

  • Si vaut 0, la source ne sera jamais exécutée automatiquement, uniquement manuellement. 

Description

No Format
description
Texte---This source is about loading remote Synchronizers configurations

Description de la source qui apparaît dans l'interface du Synchronizer.

Options de mélange des sources

Panel



Mode de mélange des sources

Grace au paramètre "Mode de mélange des sources" ( merge_mode dans le fichier de configuration de la source ), il est possible de modifier la gestion d'une source lors de l'étape du mélange des sources ( voir la page Concept général et utilisation des sources ).


Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

merge_mode

No Format
merge_mode
Texte---all

Ce paramètre peut prendre les valeurs suivantes :

  • dont_merge_with_other : 

    Les éléments récoltés par cette source seront importés sans être fusionnés avec les autres sources.

    Si un élément de cette source possède une clé de synchronisation commune avec une autre source, la source provoquera un conflit et ces éléments ne pourront pas être importés.

    À utiliser si la source donne un élément complet qui ne doit pas être modifié, ni par l'interface de configuration ni par d'autres sources.   

  • only_with_syncui : 

    Les éléments récoltés par cette source seront importés et fusionnés  seulement avec ceux de la "syncui". 

    À utiliser si la source importe un élément complet qui ne doit être modifié que via l'interface de configuration.

  • all_without_syncui : 

    Les éléments récoltés par cette source seront importés et fusionnés  avec ceux des autres sources sauf la "syncui".

    À utiliser si la source donne un élément à compléter avec d'autres sources, mais qui ne doit pas être modifié par l'interface de configuration.

  • all ( valeur par défaut ) :  

    Si un même élément est importé par plusieurs sources, les éléments seront fusionnés pour n'en donner qu'un.

    Les éléments de cette source seront complétés avec les autres sources et les modifications de l'interface de configuration.



Info

La source de type "syncui" est une source qui importe tous les éléments de l'interface de configuration.

Chaque fois qu'une source est importée, la  source de type "syncui" est automatiquement importée aussi. Si une source ne se mélange pas avec la "syncui", les modifications sur l'interface de configuration seront ignorées.

Info

Les sources désactivées ne sont pas prises en compte lors du mélange des sources.

Détecter les nouveaux éléments

Les éléments proposés par la source sont soumis au calcul des nouveautés ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ).


Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

compute_new_element

No Format
compute_new_element
Texte---authorized 

Ce paramètre peut prendre les valeurs suivantes :

  • authorized ( valeur par défaut ) :  

    Activée → le mécanisme de calcul des nouveautés analysera les éléments de la source pour identifier les nouveaux éléments par rapport à l'espace de données Staging.

  • never_new :  

    Désactivée → les éléments de la source n’apparaîtront pas en tant que Nouveau, même s'ils n'ont jamais été importés par rapport à l'espace de données Staging.

Calculer les différences

Les éléments proposés par la source sont soumis au calcul des différences ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ).


Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

compute_element_difference

No Format
compute_element_difference
Texte---authorized 

Ce paramètre peut prendre les valeurs suivantes :

  • authorized ( valeur par défaut ) :  

    Activée → le mécanisme de calcul des différences analysera les éléments de la source pour calculer les différences par rapport à l'espace de données Staging.

  • never_new :  

    Désactivée → les éléments de la source n’apparaîtront pas en tant que Différence, même s'ils possèdent des différences par rapport à l'espace de données Staging.



Suppression des éléments absents

Ce paramètre permet de proposer en suppression, les éléments qui ne sont plus présents dans la ou les source/s.


Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

compute_deleted_element_not

_in_source

No Format
compute_deleted_element_not
_in_source
Texte---disabled 

Ce paramètre peut prendre les valeurs suivantes :

  • disabled ( valeur par défaut ) :  

    Les éléments qui ne sont plus présents dans cette source, ni dans aucunes autres, ne seront pas proposés à la suppression.

  • delete_if_missing_in_all_sources :  

    Les éléments, qui ne sont plus présents dans cette source et qui n'existent pas dans les autres sources à l'exception de la "syncui", seront proposés à la suppression.

    Warning

    La prise en compte de ce paramètre dépend de la valeur de put_in. Si cette valeur correspond à source_space ( sa valeur par défaut ), alors le paramètre compute_deleted_element_not_in_source sera ignoré.

  • delete_if_missing_in_this_source :  

    Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.

    Warning

    La prise en compte de ce paramètre dépend de la valeur de put_in. Si cette valeur correspond à source_space ( sa valeur par défaut ), alors le paramètre compute_deleted_element_not_in_source sera ignoré.

Choix de l'espace où seront placés les éléments importés

Panel



Mettre dans l'espace

Ce paramètre permet de choisir l'espace où appliquer les différences et importer les nouveaux éléments de cette source : en Staging, en Production ou bien de les laisser dans l'espace de calcul des sources ( comportement par défaut ) .


Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

put_in

No Format
put_in
Texte---source_space 

Ce paramètre peut prendre les valeurs suivantes :

  • source_space ( valeur par défaut ) :  

    Les éléments sont sauvegardés dans l'espace de donnée "Sources". Cette espace sera comparée avec l'espace de données "Staging" afin de calculer les nouveautés et les différences.

  • staging :  

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources" et "Staging".

  • production :  

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources", "Staging" et "Production".

  • production_and_reload_arbiter :  

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources", "Staging" et "Production".

    L'Arbiter est redémarré afin de soumettre les changements à la supervision.  

    Info

    Une source avec l'option put_in à production_and_reload_arbiter ne redémarrera l'Arbiter que si elle a des modifications à pousser en production.

Info

Une source avec le paramètre "put in" à la valeur "production" ou "production_and_reload_arbiter" ne poussera en production que les changements qui proviennent de la source et non tous les changements à appliquer en production ( tous les changements visibles dans la page de production ).

Ce qui implique que si un utilisateur supprime un élément importé par une source avec le paramètre "put_in" à la valeur "production" ou "production_and_reload_arbiter" alors que l'élément est réimporté par la source : il y aura en production deux éléments avec le même nom, car la suppression manuelle de l'élément ne sera pas prise en compte ce qui provoquera une erreur.

Utilisateur utilisé pour la sauvegarde des changements

Ce paramètre permet de choisir l'utilisateur qui apparaîtra comme étant le dernier à avoir mis à jour les éléments.

Info

L'utilisateur doit être obligatoirement un administrateur Shinken.

Scroll Title
anchorparameter_source_interface
title​
Nom dans l'interfaceNom dans le fichier configurationTypeUnitéDéfautCommentaire

put_in_user

No Format
put_in_user
Texte---shinken-core 

Les nouveaux éléments et les éléments différents importés par cette source auront la valeur de cette clé comme utilisateur ayant fait la dernière modification.

Clés spécifiques à la source

Clés de synchronisation

Les clés de synchronisation sont des valeurs utilisées lors de l'étape du mélange des sources ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ) qui permettent de choisir quel élément de cette source se mélange avec quel élément d'une autre source ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).

Propriétés par défaut utilisé pour la construction des clés de synchronisation

Shinken utilise par défaut deux propriétés pour la construction des clés de synchronisation : 

  • Nom de l'élément 
  • Le "_SE_UUID"
Propriété Type d'élémentInfo
Code Block
Nom de l'élément
Tous les éléments

Cette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation

Pour rappel : les éléments sont renommés au moment de l'import, le nom du site distant est ajouté comme préfixe.

Si le préfixe de renommage du Synchronizer distant change, les noms des éléments seront renommés ainsi que leur clé de synchronisation.


Code Block
_SE_UUID
Tous les éléments

Cette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation

Le _SE_UUID est modifié lors de l'import pour devenir : UUID_shinken_distant-UUID_élément : 

    • UUID_shinken_distant : unique dans une Installation Shinken 
    • UUID_élément de l'hôte sur le synchronizer distant
Ces deux propriétés ne peuvent pas être retirées et s'appliquent sur tous les éléments.