Page History

Description

Les collecteurs sont des sources qui permettent de collecter des informations depuis plusieurs originesune référentiel.

Ces collecteurs peuvent être importés automatiquement à intervalles définis, ou bien manuellement.

Il existe plusieurs modules collecteurs disponibles par défaut :

• cfg-file-import : Ce collecteur importe des définitions d'éléments Shinken à partir de fichiers .cfg
• ldap-import : La source d'import ldap permet d'importer des données d'un service Active Directory ou OpenLDAP ( selon son paramétrage ).
• synchronizer_collector_vmware : Cette source collecte les données d'un vCenter VMware ou d'un ESX VMware.
• discovery : discovery : La source discovery scanne le réseau avec nmap afin de détecter des éléments et de collecter leurs données associées.
• synchronizer-collector-linker : Cette source permet de récupérer tous les hôtes d'une installation Shinken distante.
• sync-vmware : Cette source collecte les données d'un serveur vSphere.

Ces collecteurs peuvent être importés automatiquement à intervalles définis, ou bien manuellement.

Ajouter

un nouveau collecteur

1 - Création du fichier cfg d'un collecteur

Pour ajouter un nouveau collecteur, il faut créer un fichier de configuration qui correspond au type de module ( code-source ) qui correspond.

• Chaque pages des collecteurs décrivent comment créer leurs fichiers de configuration.
  
• Les fichiers de configurations des collecteurs

• doivent être mis par défaut dans le

• répertoire : /etc/shinken/sources/

2 - Activation du collecteur sur le Synchronizer

Une fois le fichier de configuration fait, il faut ajouter le collecteur dans la liste de sources chargé par le Synchronizer :

• Cela s'effectue en ajoutant son nom dans le fichier de configuration du démon Synchronizer.
• Pour ce faire, ouvrez le fichier de configuration à l'emplacement /etc/shinken/synchronizers/synchronizer-master.cfg, et ajouter le nom de votre écouteur dans le paramètre sources 

Exemple: Pour le collecteur nommé "my-collector"

define synchronizer {
    [...]
    sources

#===============================================================================
# Daemons that can load this source:
# - synchronizer
#===============================================================================

define source {
    source_name		            collector_name
    enabled                   Source 1, 0
Source 2, Source  order		                19
    import_interval	            5
    module_type     	        collector_module_type

    description		            This source is about loading the default Shinken Enterprise packs

    # 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 which can be defined in the items from the source but which Shinken will not import.
    # not_stored_properties
} 

Détails des sections composants le fichier de configuration

Identification du module de source

Chaque collecteur possède sa propre identité, celle-ci est définie par les paramètres suivants :

Intervalle d'import et ordre de la source

3, my-collector
    [...]
}

Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:

service shinken-synchronizer restart

Propriétés des éléments Shinken collectés

properties_used_as_synckey

Défini la liste de propriétés Shinken qui seront utilisées en plus du nom et du SE_UUID de l'élément pour générer les clés de synchronisation (sync_key).

Ce paramètre est optionnel. Si ce paramètre n'est pas présent, sa valeur par défaut vaut "address".

not_stored_properties