| Scroll Ignore |
|---|
| scroll-pdf | true |
|---|
| scroll-office | true |
|---|
| scroll-chm | true |
|---|
| scroll-docbook | true |
|---|
| scroll-eclipsehelp | true |
|---|
| scroll-epub | true |
|---|
| scroll-html | true |
|---|
|
|
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 avec sa configuration et quel de configuration qui correspond au type de module ( code-source ) doit être utilisé pour cette sourcequi correspond.
- Chaque pages des collecteurs décrivent comment créer leurs fichiers de configuration.
- 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"
| Code Block |
|---|
|
define synchronizer {
[...]
sources Source 1, Source 2, Source 3, my-collector
[...]
} |
Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:| Code Block |
|---|
service shinken-synchronizer restart |
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":
| Code Block |
|---|
|
define synchronizer {
[...]
sources Source 1, Source 2, Source 3, cfg-file-sample
[...]
} |
Pour prendre en compte le changement de configuration, redémarrer le Synchronizer:
| Code Block |
|---|
service shinken-synchronizer restart |
Les fichiers des collecteurs sont définis dans le dossier /etc/shinken/sources/.
| Warning |
|---|
Il doit y avoir un fichier cfg par source. |
| Code Block |
|---|
| language | bash |
|---|
| theme | Confluence |
|---|
| title | Exemple : |
|---|
|
#===============================================================================
# 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 -
Doit être unique Doit commencer par une lettre.D'une longueur maximum à 40 caractèresNe doitpas contenir le caractère "$"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 |
|---|
| Code Block |
|---|
import_interval |
Nombre | 0 | Délai écoulé entre les imports automatiques de la source.
Si 0, l'import de la source ne sera jamais exécuté automatiquement. | 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 ). - Un nombre
- Voir la page du Synchronizer pour plus d'information au sujet des fusions.
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 |
|---|
| Code Block |
|---|
properties_used_as_synckey |
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". | | Code Block |
|---|
not_stored_properties |
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