Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_corrupted_html
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Concept

La configuration du collecteur, définie dans le fichier de configuration de la source ( voir la page Collecteur de type synchronizer_collector_excel ( Pour importer un fichier Excel ) ) peut être consultée dans l'onglet "Configuration", dont les différentes parties sont décrites ci-dessous.

Panel

Image RemovedImage Added


Cet onglet est divisé en 5 chapitres :

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

Les différentes parties de l'onglet

Anchor
configurationGenerale
configurationGenerale

1 - Configuration générale

Panel

Image RemovedImage Added

Scroll Title
anchorparameter_cfg_with_inner_tab
title
NomTypeUnitéDéfautDescription
No Format
Nom
Texte------

Nom de la source affichée dans la page d'accueil de l'interface  de de configuration.

  • Doit être unique ( parmi toutes les sources )
  • D'une longueur inférieure à 40 caractères
  • Ne doit pas contenir le caractère "$"

Nom dans le fichier cfg : source_name

No Format
Type de Module
Texte---synchronizer_collector_excel

Type de module chargé par le Synchroniser. 
À ne pas modifier 

Nom dans le fichier cfg : module_type

No Format
Description
Texte------

Un texte décrivant le collecteur 

Nom dans le fichier cfg : description

No Format
Intervalle d'Import
EntierMinute 0

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

  • Un nombre
  • Si 0, la source ne sera jamais importée automatiquement.

Nom dans le fichier cfg : import_interval

No Format
Ordre
Entier------

L'ordre de la source dans l'interface de configuration ( A un impact dans la fusion des données lors des imports de sources ).

Remarque : Si l'ordre est changé depuis l'interface ( page d’accueil ), le fichier cfg sera mis à jour.

Nom dans le fichier cfg : order

No Format
Éléments Shinken importéimportés
Texte------

Liste des types d'éléments à importer au format Shinken lors de l'import de la source.

Par défaut, tous les types d'éléments sont affichés.

Nom dans le fichier cfg : type_to_import

Anchor
optionDeMelangeDesSources
optionDeMelangeDesSources

2 - Options de mélange des sources

Panel

Image RemovedImage Added

Les éléments proposés par la source sont soumis au calcul des différences
Scroll Title
anchorparameter_cfg_with_inner_tab
title
NomTypeUnitéDéfautDescription
No Format
Mode de mélange des sources
Texte---Toutes

Définit le mode de mélange entre les éléments récupérés de cette source et les autres sources.


Valeurs possibles :

Nom dans l'interfaceValeurs dans le fichierDescription

Ne fusionne pas avec les autres

(

dont_merge_with_other

)Seulement avec "Syncui" (

Les éléments récoltés par cette source seront importés, mais pas fusionnés avec les autres sources.

S'il existe le même élément importé par une autre source, les éléments ne seront pas importés.

Seulement avec "Syncui"

only_with_syncui

)

Si un élément importé par cette source est aussi récolté par "Syncui", ils seront fusionnés pour ne donner qu'un élément.

Tout sauf Syncui

(

all_without_syncui

Si un même élément est importé par plusieurs sources ( à part "Syncui" ), alors les éléments seront fusionnés pour n'en donner qu'un.

Toutes

( Pour plus de détails sur ce paramètre, se référer au chapitre :

all

)

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


Pour plus de détails sur ce paramètre, se référer au chapitre :

Mode de mélange des sources

Paramètre dans le fichier cfg :merge_mode

No Format
Détecter les nouveaux éléments
Texte---Activé

Les éléments proposés par la source sont soumis au calcul des nouveautés par rapport à l'espace de données "Staging".


Valeurs possibles :

  • Activé ( authorized )
  • Désactivé ( never_new )

Paramètre dans le fichier cfg : compute_new_element

Nom dans l'interfaceValeurs dans le fichierDescription
Activé authorizedLe mécanisme de calcul des nouveautés analysera les éléments de la source pour identifier les nouveaux éléments
No Format
Calculer les différences
Texte---Activé
par rapport à l'espace de données
"
Staging
"
  • Activé ( authorized )
  • Désactivé (
    .

    Valeurs possibles :

    Désactivé 
    never_
    difference
    newLes éléments de la source n’apparaîtront pas comme Nouveau, même s'ils n'ont jamais été importés dans l'espace de données Staging.

    Paramètre dans le

    )Paramètre dans le

    fichier cfg : compute_new_element

    _difference

    No Format
    Détecter
    Calculer les 
    éléments qui ne sont plus présents dans la source
    différences
    Texte---
    Désactivé
    Activé

    Les éléments proposés par la source sont soumis au calcul des différences par rapport à l'espace de données "Staging"

    Permet de proposer, en suppression, les éléments qui ne sont plus présents dans la source

    .


    Valeurs possibles :

  • Désactivé ( disabled )
  • Nom dans l'interfaceValeurs dans le fichierDescription
    Activé authorizedLe 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.
    Désactivé never_differenceLes éléments de la source n’apparaîtront pas comme Différence, même s'ils possèdent des différences par rapport à la version présente dans l'espace de données Staging.

    Paramètre dans le fichier cfg : compute_element_difference

    No Format
    Détecter les éléments qui ne sont plus présents dans la source
    Texte---Désactivé

    Permets de proposer, en suppression, les éléments qui ne sont plus présents dans la source.

    Info

    Si le dépôt des éléments est paramétré pour aller dans l'espace de calcul des Sources, le calcul de suppression des éléments ne pourra pas se faire.

    Valeurs possibles :

    Nom dans l'interfaceValeurs dans le fichierDescription
    Désactivé 

    disabled

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

    Supprimer s'ils ne sont pas dans cette source

    delete

    Supprimer s'ils ne sont pas dans cette source ( delete

    _if_missing_in_this_source

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

    Supprimer s'ils ne sont pas dans TOUTES les sources
    (

    delete_if_missing_in_all_

    sources )Remarque :

    sources 

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

    Si le dépôt des éléments est paramétré pour aller dans l'espace de calcul des Sources, le calcul de suppression des éléments ne pourra pas se faire

    .


    Paramètre dans le fichier cfg : compute_deleted_element_not_in_source



    Options de mélange des sources - Précisions

    Anchor
    merge_mode
    merge_mode

    Mode de mélange des sources

    Ce paramètre sert à définir le mode de mélange entre les éléments récupérés de cette source et les autres sources.


    Valeurs possibles :

    • Ne fusionne pas avec les autres :
      • Les éléments récoltés par cette source seront importés, mais pas fusionnés avec les autres sources. S'il existe le même élément importé par une autre source, les éléments ne seront pas importés.

    • Seulement avec "Syncui" :
      • Si un élément importé par cette source est aussi récolté par "Syncui", ils seront fusionnés pour ne donner qu'un élément.

    • Tout sauf Syncui :
      • Si un même élément est importé par plusieurs sources ( à part "Syncui" ), alors les éléments seront fusionnés pour n'en donner qu'un.

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


    Info

    Syncui est une source qui importe tous les éléments de l'interface de configuration.

    • Chaque fois qu'une source est importée, elle l'est aussi.
    • Si cette source ne se mélange pas avec Syncui, les modifications ne seront pas prises en compte sur l'interface de configuration.
    Info
    Les sources désactivées ne sont pas prises en compte lors du mélange des sources.

    Anchor
    #compute_deleted_element_not_in_source
    #compute_deleted_element_not_in_source

    Détecter les éléments qui ne sont plus présents dans la source

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


    Info

    Si le dépôt des éléments est paramétré pour aller dans l'espace de calcul des Sources, le calcul de suppression des éléments ne pourra pas se faire.


    Les différentes valeurs possibles sont :

    • Désactiver ( disabled )
      • Les éléments qui ne sont plus présents dans la source ne seront pas proposés à la suppression.

    • Supprimer s'ils ne sont pas dans cette source ( delete_if_missing_in_this_source ) :
      • Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.

        Info
        titleA noter :
        Même si l'élément est présent dans une autre source, il sera proposé à la suppression.
    • Supprimer s'ils ne sont pas dans TOUTES les sources ( 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 (sauf Syncui), seront proposés à la suppression.

        Info
        titleA noter :
        Si l'élément était présent sur deux sources, qu'il a été supprimé uniquement sur cette source, il ne sera pas proposé à la suppression.

    Anchor
    choixEspaceElementsImportes
    choixEspaceElementsImportes

    3 - Choix

    de

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

    Panel

    Image Added

    Scroll Title
    anchorparameter_cfg_with_inner_tab
    title
    NomTypeUnitéDéfautDescription
    No Format
    Mettre dans l'espace
    où seront placés les éléments importés
    Panel

    Image Removed

    Texte--- Espace de calcul des Sources

    Permet d'appliquer les différences et d'importer les nouveaux éléments de cette source directement en Staging, en Production ou bien de les laisser dans l'espace de calcul des sources comme par défaut.


    Valeurs possibles :

    Nom dans l'interfaceValeurs dans le fichierDescription
    Scroll Title
    anchorparameter_cfg
    title
    NomTypeUnitéDéfautDescription
    No Format
    Mettre dans l'espace
    Texte---
    Espace de calcul des Sources

    Permet d'appliquer les différences et d'importer les nouveaux éléments de cette source directement en Staging, en Production ou bien de les laisser dans l'espace de calcul des sources comme par défaut.

    source_space Les éléments sont sauvegardés dans l'espace de données "Sources". Cet espace sera comparé avec l'espace de données "Staging" afin de calculer les nouveautés et les différences.
    Staging staging Les éléments sont sauvegardés dans les espaces de données "Sources" et "Staging".
    Production production Les éléments sont sauvegardés dans les espaces de données "Sources", "Staging" et "Production". Les changements ne seront pas soumis à la supervision tant que l'Arbiter ne sera pas redémarré.

    Valeurs possibles :

  • Espace de calcul des Sources ( source_space )
  • Staging ( staging )
  • Production ( production )
    Production et rechargement de l'Arbiter
    (
    production_and_reload_
    arbiter
    arbiter Les éléments sont sauvegardés dans les espaces de données "Sources", "Staging" et "Production". L'Arbiter est redémarré afin de soumettre les changements à la supervision.
    )


    Pour plus de détails sur ce paramètre, se référer au chapitre Mettre dans l'espace - Précisions

    Paramètre dans le fichier cfg : put_in

    No Format
    Utilisateur utilisé pour la sauvegarde des changements 
    Texte--- shinken-core

    Les modifications faites par la source en Staging ou en Production lors de son import ( ajout de nouveau élément ou application de différence ) seront indiquées comme faites par cet utilisateur.

    Info

    L'utilisateur doit obligatoirement être un administrateur Shinken.

    Paramètre dans le fichier cfg : put_in_user

    Anchor
    put_in
    put_in

    Mettre dans l'espace - Précisions

    Cette option permet de choisir où appliquer les différences et d'importer les nouveaux éléments de cette source :

    • Dans l'espace de calcul des sources comme ( par défaut ),
    • Directement en Staging,
    • Directement en Production :
      • Avec rechargement du démon Arbiter ( pour soumettre les changements à la supervision ).
      • Sans rechargement du démon Arbiter.


    Info
    Le calcul des nouveautés dépend du réglage de la propriété "Détecter les nouveaux éléments".
    Info
    Le calcul des différences dépend du réglage de la propriété "Détecter les différences".
    Info
    Le calcul des suppressions dépend du réglage de la propriété "Détecter les éléments qui ne sont plus présents dans la source".



    Les valeurs possibles de cette option sont :

    • Espace de calcul des Sources
        • Valeur dans le fichier cfg : source_space
        • Les éléments sont sauvegardés dans l'espace de données "Sources". Cet espace sera comparé avec l'espace de données "Staging" afin de calculer les nouveautés et les différences.
    • Staging
      • Valeur dans le fichier cfg : staging
      • Les éléments sont sauvegardés dans les espaces de données "Sources" et "Staging".

    • Production
      • Valeur dans le fichier cfg : production
      • Les éléments sont sauvegardés dans les espaces de données "Sources", "Staging" et "Production". L'Arbiter est redémarré afin de soumettre les changements à la supervision"Production". Les changements ne seront pas soumis à la supervision tant que l'Arbiter ne sera pas redémarré.

    • Production et rechargement de l'Arbiter
      • Valeur dans le fichier cfg : production_and_reload_arbiter
      • Les éléments sont sauvegardés dans les espaces de données "Sources", "Staging" et "Production". Les changements ne seront pas soumis L'Arbiter est redémarré afin de soumettre les changements à la supervision tant que l'Arbiter ne sera pas redémarré.


    Info
    titleÀ noter :

    Après modification de la valeur de ce paramètre, une demande de confirmation sera demandée. ( Voir la section "Besoin de confirmation" )

    Info
    titlePrécisions

    Une source avec le paramètre "put_in" à la valeur "production" ou "production_and_reload_arbiter" n'appliquera en production que les changements qui proviennent de la source, donc tous les changements visibles dans la page de production ne seront pas appliqués.

    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.

    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.

    Anchor
    clesSpecifiquesSource
    clesSpecifiquesSource

    4 - Clés spécifiques à la source

    Panel

    Image RemovedImage Added

    Scroll Title
    anchorparameter_cfg
    title
    NomTypeUnitéDéfautDescription
    No Format
    Fichier Excel 
    Texte--- ---

    Chemin d'accès au fichier Excel à charger.

    Paramètre dans le fichier cfg : excel_file_path

    Anchor
    clesSynchronisation
    clesSynchronisation

    5 - Clés de synchronisation

    Panel

    Image RemovedImage Added

    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)  ).

    Les paramètres :

    • properties_used_as_synckey_for_hosts
    • properties_used_as_synckey_for_clusters
    • properties_used_as_synckey_for_clustertpls
    • properties_used_as_synckey_for_hosts
    • properties_used_as_synckey_for_hosttpls
    • properties_used_as_synckey_for_hostgroups
    • properties_used_as_synckey_for_serviceshosts
    • properties_used_as_synckey_for_serviceshosttpls
    • properties_used_as_synckey_for_servicesclusters
    • properties_used_as_synckey_for_servicesclustertpls
    • properties_used_as_synckey_for_servicetpls
    • properties_used_as_synckey_for_contacts
    • properties_used_as_synckey_for_contacttpls
    • properties_used_as_synckey_for_contactgroups
    • properties_used_as_synckey_for_escalations
    • properties_used_as_synckey_for_notificationways
    • properties_used_as_synckey_for_commands
    • properties_used_as_synckey_for_businessimpactmodulations
    • properties_used_as_synckey_for_macromodulations
    • properties_used_as_synckey_for_resultmodulations
    • properties_used_as_synckey_for_timeperiods

    de la source permettent d'ajouter les propriétés qui serviront à créer les clés de synchronisation ( voir la page Collecteur de type synchronizer_collector_excel ( Pour importer un fichier Excel ) ).

    Anchor
    BesoinDeConfirmation
    BesoinDeConfirmation

    Besoin de confirmation

    Lorsqu'une modification de la configuration de la source est faite, elle peut impacter les éléments importés avec l'ancienne configuration.

    • Par exemple, ils seront automatiquement supprimés, si la suppression automatique a été activée ou si elle l'est dans le futur.
    • Pour pallier ce problème,
    une
      • Une demande de confirmation apparaîtra si la nouvelle configuration de source impacte ou pourra impacter les éléments précédemment importés.
      • Cette demande de confirmation s'active lorsque la valeur du paramètre "Mettre dans l'espace" ( put_in ) est différente de "Espace de calcul des sources".

    Liste des paramètres pouvant déclencher la demande de confirmation :

    • Détecter les nouveaux éléments ( compute_new_element )
    • Calculer les différences ( compute_element_difference )
    • Détecter les éléments qui ne sont plus présents dans la source ( compute_deleted_element_not_in_source )
    • Mettre dans l'espace ( put_in )
    Panel

    Image RemovedImage Added

    Erreurs de configuration

    Dans le cas où une clé non reconnue par Shinken est renseignée dans la configuration de la source, une erreur apparaîtra.

    • Cette erreur rendra l'import de la source impossible.
    Panel

    Image RemovedImage Added