Page History

Description

Cette source permet d'importer de nouveaux élément via des fichiers .cfg. La syntaxe d'import de ces fichiers est la même que la syntaxe Nagios.

Il est donc possible d'importer des fichiers de configuration Nagios dans Shinken, et ainsi migrer sa configuration Nagios vers Shinken Entreprise facilement.

Aussi, les fichiers de configuration Shinken Framwork sont évidemment supportés et importables dans Shinken Entreprise.

Activation de la source

Ajouter un collecteur d'import de fichier .cfg

Choisissez un nom pour ce nouveau collecteur.

• Pour l'exemple, nous allons l'appeler "Mon-Collecteur-de-Fichier".
• Remplacer dans l'exemple le mot "Mon-Collecteur-de-Fichier" par la nom que vous aurez choisi.

Faite les opérations suivantes :

• Copier le fichier de définition de la source d'exemple : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/cfg-file-import/cfg-file-import-example.cfg dans le répertoire de définition dossier d'exemple de la source dans le répertoire des données des sources /etc/shinken-user/sourcessource-data/ et modifier son donner lui un nom.

• ( Exemple : /etc/shinken-user/sources/collector__cfg-file-importsource-data/source-data__Mon-Collecteur-de-Fichier .cfg )
  
  

  Code Block
  language bash theme Confluence
  cp -r /etc/shinken-user-example/configuration/daemons/synchronizers/sources/cfg-file-import/source-data__cfg-file-import-__example.cfg /etc/shinken-user/sources/collector__cfg-file-importsource-data/source-data__Mon-Collecteur-de-Fichier.cfg

  
  

• Ouvrez ce fichier et modifier la ligne source_name en remplaçant le nom par défaut "cfg-file-example" par le nom que vous avez choisi "Mon-Collecteur-de-Fichier".Renommer le fichier de définition des chemins de la source pour lui donner le nom de votre source

  Code Block
  language bash theme Confluence
  mv /etc/shinken-user/source-data/source_name -data__Mon-Collecteur-de-Fichier

  Une fois que le fichier a été édité, vérifiez que les droits sur le fichier sont bon ( lecture pour l'utilisateur Shinken ) . Si ce n'est pas le cas, effectuez la commande suivante :
  

  Code Block
  chmod -R 664 /definition-cfg-file-import-example.cfg /etc/shinken-user/sources/collector__cfg-file-import__Mon-Collecteursource-data/source-data__Mon-Collecteur-de-Fichier/definition-Mon-collecteur-de-Fichier.cfg

  Ajouter

  
  

• Copier le
nom
• fichier de définition de la
nouvelle source au Synchronizer en modifiant le paramètre sources du fichier 
• source d'exemple : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/cfg-file-import/cfg-file-import-example.cfg dans le répertoire de définition des sources /etc/shinken/sources/ et modifier son nom .
  

• synchronizer-master.cfg.( Exemple : /etc/shinken/sources/collector__cfg-file-import__Mon-Collecteur-de-Fichier.cfg )
  
  

  Code Block
  language bash theme Confluence
  cp sources source1,source2,source3,Mon-Collecteur-de-Fichier

  Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source

  Code Block
  language bash theme Confluence
  service shinken-synchronizer restart

Activer le collecteur d'import de fichier cfg-file-nagios livré par défaut

• /etc/shinken-user-example/configuration/daemons/synchronizers/sources/cfg-file-import/cfg-file-import-example.cfg /etc/shinken/sources/collector__cfg-file-import__Mon-Collecteur-de-Fichier.cfg

  
  

• Ouvrez ce fichier et modifier la ligne source_name en remplaçant le nom par défaut "cfg-file-example" par le nom que vous avez choisi "Mon-Collecteur-de-Fichier".

  Code Block
  language bash theme Confluence
  source_name Mon-Collecteur-de-Fichier

  
  

• Modifier le chemin du fichier de définition vers celui présent dans le dossier de votre source

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de collecteur d'import de fichier Nagios au format .cfg.

• La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/sources/cfg-file-nagios.cfg
• Le collecteur cfg-file-sample s'active comme les autres sources, c'est-à-dire en modifiant le fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du Synchronizer )
  • Ce collecteur est déjà présent dans la liste des sources livrées par défaut, il n'y a donc rien à modifier.
    
  • Si il n'y est pas, vous pouvez le rajouter pour qu'il soit de nouveau actif.

• Code Block
  language bash theme Confluence

• cfg_path

Configuration

Voici la détail de fichier de configuration de la source se trouve ( suivant la procédure choisi ) :

• soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/collector__cfg-file-import

  /etc/shinken-user/source-data/source-data__Mon-Collecteur-de-Fichier

  .cfg ).soit dans le fichier

  /definition-Mon-collecteur-de-Fichier.cfg

  
  

• Une fois que le fichier a été édité, vérifiez que les droits sur le fichier sont bons ( lecture pour l'utilisateur Shinken ) . Si ce n'est pas le cas, effectuez la commande suivante :
  

  Code Block
  chmod -R 664 /etc/shinken/sources/collector__cfg-file-

  nagios.cfg.
  

Exemple de fichier de configuration

• import__Mon-Collecteur-de-Fichier.cfg chmod -R 664 /etc/shinken-user/source-

• data/source-data__Mon-Collecteur-de-Fichier/

  
  

• Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.
  

  Code Block
  language bash theme Confluence
  sources source1,source2,source3,Mon-Collecteur-de-Fichier

  
  

• Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source

  Code Block
  language bash theme Confluence
  service shinken-synchronizer restart

  
  

Activer le collecteur d'import de fichier cfg-file-nagios livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de collecteur d'import de fichier Nagios au format .cfg.

• La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/sources/cfg-file-nagios.cfg
• Le collecteur cfg-file-sample s'active comme les autres sources, c'est-à-dire en modifiant le fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du Synchronizer )
  • Ce collecteur est déjà présent dans la liste des sources livrées par défaut, il n'y a donc rien à modifier.
    
  • Si il n'y est pas, vous pouvez le rajouter pour qu'il soit de nouveau actif.

Exemple :

sources     source1,source2,source3,cfg-file-nagios

Configuration

Voici la détail de fichier de configuration de la source se trouve ( suivant la procédure choisi ) :

• soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/collector__cfg-file-import__Mon-Collecteur-de-Fichier.cfg ).
• soit dans le fichier /etc/shinken/sources/cfg-file-nagios.cfg.
  
  

Exemple de fichier de configuration

Vous trouverez un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/sources/cfg-file-import/cfg-file-import-example.cfg

#===============================================================================
# cfg-file-import-example
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# This source import the cfg-config sample from Shinken Enterprise update.
#===============================================================================

define source {

    #======== Source identity ==============
    # Source name. Must be unique
    source_name                             cfg-file-import-example

    # Module type (to load module code). Do not edit.
    module_type                             cfg-file-import

    # description: display a description on the interface for this source
    description                             This source is about loading cfg files compatible with Shinken

    # enabled: is this source enabled or not
    enabled                                 1


    #======== Import interval and order ====
    # import_interval:  in minutes, what is the schedule import interval for this source.
    # note: 0 = don't schedule this source, will run only if an administrator launch it from the interface
    import_interval                         5

    # order: source order for a source imply if a source is before an another source when
    # merging data
    order                                   1


    #======== Location =====================
    # Location of the source definition file. This file will be used to define where the .cfg files are to be imported.
    cfg_path	    	                    /etc/shinken-user/source-data/source-data-cfg-file-import-example/definition-cfg-file-import-example.cfg


    #======== Synchronization keys =========
    # The list of properties to be used as sync_keys in addition to the item name. Properties not managed by Shinken can be added here.
    # properties_used_as_synckey            address


    #======== Properties not stored ========
    # Properties which can be defined in the items from the source but which Shinken will not import.
    # not_stored_properties


    #======== SE_UUID in cfg file ==========
    # With this option if item in cfg hasn't a SE_UUID, the source will ask the synchronizer to search a match in staging or in working area. If found, it will be inserted in the file.
    # update_cfg_with_staging_se_uuid       0

}

Détails des sections composant le fichier de configuration

Identification de la source

Il est possible de définir plusieurs instances de module de type cfg-file-import dans votre architecture Shinken.

• Chaque instance devra avoir un nom unique.
  
  

source_name 

module_type 

description	

enabled	

Interval d'import et ordre de la source

Détails des sections composant le fichier de configuration

Identification de la source

Interval d'import et ordre de la source

Il est possible de définir un interval d'import afin que la source s'importe regulièrement.

Emplacement des fichiers de configuration

Afin de récupérer les éléments Shinken, contenus dans des fichiers .cfg, il faut spécifier un unique fichier de définition de la source qui contiendra la liste des chemins vers les fichiers à importer. (Voir Importer ses propres fichiers CFG pour plus de détail)

Clés de synchronisation ( sync_key )

Défini la liste des propriétés qui seront utilisées pour générer les clés de synchronisation.

Emplacement des fichiers de configuration

Afin de récupérer les éléments Shinken, contenus dans des fichiers .cfg, il faut spécifier un unique fichier de définition de la source qui contiendra la liste des chemins vers les fichiers à importer. (Voir Importer ses propres fichiers CFG pour plus de détail)

Clés de synchronisation ( sync_key )

Propriétés non récupérées

Propriétés non récupérées

Il est possible de définir des propriétés que la source ne devra pas récupérer.

Dans le cas de cette source, il se peut que vous ne soyez pas l'auteur des fichiers cfg et que vous ne vouliez pas importer certaines propriétés.

Ajout des SE_UUID dans les fichiers de configuration

Ajout des SE_UUID dans les fichiers de configuration

...
    #======== SE_UUID in cfg file ==========
    # With this option if item in cfg hasn't a SE_UUID, the source will ask the synchronizer to search a match in staging or in working area. If found, it will be inserted in the file.
    # update_cfg_with_staging_se_uuid       0
    
    

Si un élément importé dans un des fichiers .cfg ne contient pas pas de SE_UUID, Shinken va lui en générer un. Il est alors possible de faire en sorte que cet SE_UUID soit retranscrit dans le fichier .cfg grâce à ce paramètre.

...
	# With this option if item in cfg hasn't a SE_UUID, the source will askcreate theit synchronizerand to search a match write in stagingthe orfile
 in working area. If found, it will be inserted in the file.
	# update_cfg_with_staging_se_uuid 0
..# create_and_write_SEUUID_in_file       0
...

Si un élément importé dans un des fichiers .cfg ne contient pas pas de SE_UUID, Shinken peut lui en générer un ou le chercher depuis les éléments existant dans staging. Il est alors possible de faire en sorte que cet SE_UUID soit retranscrit dans le fichier .cfg grâce à ce paramètres.