Présentation
La configuration du collecteur défini dans le fichier de configuration de la source ( voir la page Collecteur de type synchronizer-collector-linker ( pour lier 2 Shinkens ) pour plus de détails ) peut être consultée dans cet onglet :
Elle est divisée en 5 chapitres :
- Configuration générale
- Options de mélange des sources
- Choix de l'espace où seront placés les éléments importés
- Paramètres spécifiques à la source
- Clé de synchronisation ( sync_key )
Remarque : Cet onglet ne permet pas encore d'éditer la configuration ( → Sera implémenté dans une prochaine version )
Configuration générale
|
Ce chapitre contient tous les paramètres pour le chargement et fonctionnement des sources en général.
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | Description | ||
|---|---|---|---|---|
| Modules |
| Caractères autorisés : lettres, chiffres, underscore ( _ ), et trait d'union ( - )
| ||
| Type de Module |
| Type de module chargé par le Synchroniser. Pour cette source, le module_type est " | ||
| Intervalle d'import |
| Délai écoulé entre les imports automatiques de la source.
| ||
| Ordre |
| L'ordre de la source dans l'interface de configuration. L'ordre a un impact dans le mélange des sources ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).
| ||
| Description |
| Description de la source. |
Options de mélange des sources
|
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 ).
La valeur par défaut est : all
Les valeurs possibles sont :
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | |||
|---|---|---|---|---|
| merge_mode |
| Ce paramètre peut avoir les valeurs suivantes : | ||
| Valeurs dans le fichier | Description | |||
| dont_merge_with_other | Les éléments récoltés par cette source seront importés, mais pas fusionnés avec les autres sources. Ce qui implique que 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 | Si un élément importé par cette source est aussi récolté par " À utiliser si la source importe un élément complet qui ne doit être modifié que via l'interface de configuration. | |||
| all_without_syncui | Si un même élément est importé par plusieurs sources dont est exclu la " À 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. Cas par défaut : les éléments de cette source seront complétés avec les autres sources et les modifications de l'interface de configuration. | |||
La " Chaque fois qu'une source est importée, la " |
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 ) ).
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | |||
|---|---|---|---|---|
| compute_new_element |
| Ce paramètre peut avoir les valeurs suivantes : | ||
| Valeurs dans le fichier | Description | |||
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 ) ).
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | |||
|---|---|---|---|---|
| compute_element_difference |
| Ce paramètre peut avoir les valeurs suivantes : | ||
| Valeurs dans le fichier | Description | |||
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_difference | 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.
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | |||
|---|---|---|---|---|
compute_deleted_element_not _in_source |
| Ce paramètre peut avoir les valeurs suivantes : | ||
| Valeurs dans le fichier | Description | |||
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
| |||
delete_if_missing_in _this_source | Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.
| |||
Choix de l'espace où seront placés les éléments importés
|
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 ) .
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | |||
|---|---|---|---|---|
| put_in |
| Ce paramètre peut avoir les valeurs suivantes : | ||
| Valeurs dans le fichier | Description | |||
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".
| |||
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 2 é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
Option qui permet de choisir l'utilisateur qui apparaîtra comme étant le dernier à avoir mis à jour les éléments.
L'utilisateur doit être obligatoirement un administrateur Shinken. |
| Nom du paramètre dans l'interface | Nom du paramètre dans le fichier | Valeurs dans le fichier | Description | |
|---|---|---|---|---|
| put_in_user |
| 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 faisant 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 permet 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
| Propriété | Type d'élément | Info | |
|---|---|---|---|
| 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 | |
| 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 | |
| hôte |