Description
Les collecteurs sont des sources qui permettent de collecter des informations depuis plusieurs origines.
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 : La source discovery scanne le réseau avec nmap afin de détecter des éléments et de collecter leurs données associées.
Ajouter un nouveau collecteur
1 - Création du fichier cfg d'un collecteur
Pour ajouter un nouveau collecteur, il faut créer un fichier avec sa configuration et quel type de module ( code-source ) doit être utilisé pour cette source.
- Les sous-pages suivantes décrivent comment créer les fichiers.
- 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 Source 1, Source 2, Source 3, my-collector
[...]
} |
Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:
service shinken-synchronizer restart |
Activation du module
La source ne peut s'activer que sur le Synchronizer.
- L'activation de la source s'effectue en ajoutant le nom de cette source 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 collecteur "cfg-file-import".
Exemple: par défaut, nous livrons une source dont le nom est "cfg-file-sample":
define synchronizer {
[...]
sources Source 1, Source 2, Source 3, cfg-file-sample
[...]
} |
Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:
service shinken-synchronizer restart |
Ajouter de Collecteur
Les fichiers des collecteurs sont définis dans le dossier /etc/shinken/sources/.
Il doit y avoir un fichier cfg par source. |
#===============================================================================
# Daemons that can load this source:
# - synchronizer
#===============================================================================
define source {
source_name collector_name
enabled 0
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 :
| Nom | Type | Défaut | Commentaire | |
|---|---|---|---|---|
| Texte | Chaîne de caractères composée de lettres, de chiffres et des caractères _ et -
| ||
| Texte | Correspond au type de module collecteur de la source ( permet au Synchronizer de charger le code logiciel correspondant ). | ||
| Texte | Text descriptive de la source visible dans l'interface de configuration. |
Intervalle d'import et ordre de la source
| Nom | Type | Défaut | Commentaire | |
|---|---|---|---|---|
| Nombre | 0 | Délai écoulé entre les imports automatiques de la source. | |
| Nombre | 10 | 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 vous changez l'ordre depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour. |
Propriétés des éléments Shinken collectés
| Nom | Type | Défaut | Commentaire | |
|---|---|---|---|---|
| Texte | address | 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". | |
| Texte | Ce paramètre permet de définir une ou plusieurs propriétés des éléments qui ne seront pas importés dans Shinken. Cela peut être utile pour exclure un paramètre ou bien utiliser des paramètres personnalisés utiles pour la gestion de vos fichiers .cfg |