Concept

La source de type synchronizer-collector-excel permet d'importer via un fichier Excel ( xls ou xlsx ) tous les éléments gérés par Shinken ( hôtes, checks, périodes de temps, etc.  ) 

• Shinken impose l'agencement des informations dans le fichier Excel ( voir la page Collecteur de type synchronizer_collector_excel ( Pour importer un fichier Excel ) ) :
  • Il doit y avoir un onglet par type d'élément à importer ( hôtes, clusters, etc )
    • Chaque ligne de ces onglets décrit un objet à importer
    • Chaque colonne une information, par exemple le nom d'un hôte, son adresse IP ou le datacenter dans lequel il est hébergé.
  • Il doit y avoir un onglet "Configuration" qui :
    • Décrit pour chaque onglet quel type d'objet Shinken sera importé ( par exemple l'onglet "Équipements à importer" peut contenir des hôtes )
    • Décrit dans quelle propriété de Shinken seront récupérées les informations des différentes colonnes des autres onglets ( par exemple la colonne "Adresse de l'hôte" peut contenir l'adresse IP de l'hôte )
• Ces éléments peuvent être fusionnés avec les éléments déjà existants dans le Synchronizer grâce au mécanisme de mélange des sources ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).

Fonctionnement

La source fonctionne de la manière suivante :

1. La source récupère le fichier excel ( xls ou xlsx ) pointé dans son fichier de configuration.
2. La source lit le fichier et récupère les informations sur les éléments qu'elle doit ajouter / modifier dans Shinken.
3. La source créée les éléments Shinken avec ces informations en appliquant les règles de mapping ( voir la page Mapping vers les propriétés et les données de Shinken - synchronizer-collector-excel )

Il est conseillé d'utiliser le fichier fourni dans l'installation de Shinken. Ainsi, le fichier Excel aura toujours un format compatible avec la source installée sur le système.

Il est disponible à l'emplacement suivant :

/etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-excel/source-data-synchronizer-collector-excel/Excel-import-file.xlsx

Fichier d'exemple : Excel-import-file.xlsx

Mise en place et configuration de la source

La procédure de mise en place et de configuration de la source est expliqué dans une autre page ( voir la page Collecteur de type synchronizer_collector_excel ( Pour importer un fichier Excel ) ).

Utilisation de la source

Import via la page principale

Le collecteur apparaît dans la liste des collecteurs. 

Il suffit de cliquer sur le bouton triangle  pour importer les éléments de la source ( voir la page Les collecteurs ).

Présentation de l'interface de la source

Cliquer sur le nom de la source ouvre l'interface qui lui est dédiée.

Depuis l'interface graphique, il est possible :

• D'importer la source à partir de l'interface de cette source en cliquant en haut à droite de l'écran sur l'icône ( 1 )
• De recharger toute modification faite dans les fichiers de définition ( .cfg pour la configuration de la source et .xls ou .xlsx pour le mapping et les données ), en cliquant en haut à gauche sur l'icône ( 2 ) .

Dans cette interface, il y aura plusieurs onglets qui permettent la vérification et le fonctionnement de la source :