Description
La source server-analyzer permet de déployer un script d'analyse sur des serveurs pour détecter les modèles d'hôtes à utiliser.
Activation de l'analyser
Activer le collecteur server-analyzer livré par défaut
Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de type server-analyzer appelé "server-analyzer".
- La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/analyzers/server-analyzer.cfg
- Le collecteur server-analyzer 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.
S'il n'y est pas, vous pouvez le rajouter pour qu'il soit de nouveau actif.
Exemple:define synchronizer { [...] sources Source 1, Source 2, Source 3, server-analyzer [...] }
Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source
service shinken-synchronizer restart
Ajouter un autre collecteur de type server-analyzer
Vous pouvez avoir plusieurs sources du type server-analyzer, pour par exemple avoir plusieurs configuration différentes.
Choisissez un nom pour ce nouveau collecteur.
- Pour l'exemple, nous allons l'appeler "Mon-Analyseur-De-Serveur".
- Remplacer dans l'exemple le mot "Mon-Analyseur-De-Serveur" par la nom que vous aurez choisi.
Pour ajouter une autre source, vous devez :
Copier le fichier de définition de la source d'exemple : /etc/shinken-user-example/configuration/daemons/synchronizers/analyzers/server-analyzer/server-analyzer-example.cfg dans le répertoire de définition des sources /etc/shinken/sources/.
( Exemple : /etc/shinken/sources/analyzer__server-analyzer__Mon-Analyseur-De-Serveur.cfg )cp /etc/shinken-user-example/configuration/daemons/synchronizers/analyzers/server-analyzer/server-analyzer-example.cfg /etc/shinken/sources/analyzer__server-analyzer__Mon-Analyseur-De-Serveur.cfg
- Ouvrer ce fichier ( analyzer__server-analyzer__Mon-Analyseur-De-Serveur ) :
modifier la ligne source_name en remplaçant le nom par défaut "server-analyzer" par le nom que vous avez choisi "Mon-Analyseur-De-Serveur".
define source { [...] source_name Mon-Analyseur-De-Serveur [...] }
Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.
define synchronizer { [...] sources Source 1, Source 2, Source 3, Mon-Analyseur-De-Serveur [...] }Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source.
service shinken-synchronizer restart
Configuration
Voici la détail du fichier de configuration de la source qui se trouve ( suivant la procédure choisi ) :
- soit dans le fichier /etc/shinken/sources/server-analyzer.cfg.
- soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/analyzer__server-analyzer__Mon-Analyseur-De-Serveur.cfg ).
Exemple de fichier de configuration
Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/analyzers/server-analyzer/server-analyzer-example.cfg
#===============================================================================
# server-analyzer
#===============================================================================
# Daemons that can load this listener:
# - synchronizer
#===============================================================================
define analyzer {
#======== Analyzer identity =========
# Analyzer name. Must be unique
analyzer_name server-analyzer
# Analyzer type (to load module code). Do not edit.
module_type server-analyzer
import_interval 0
order 10
# enabled: is this analyzer enabled or not
enabled 1
# description: display a description on the interface for this source
description The server analyzer allow to launch an analyze script on distant servers
}
Détails des sections composant le fichier de configuration
Identification du module de source
Il est possible de définir plusieurs instances de module de type server-analyzer dans votre architecture Shinken.
- Chaque instance devra avoir un nom unique.
| Nom | Type | Unité | Défaut | Commentaire |
|---|---|---|---|---|
analyzer_name | Texte | --- | server-analyzer | Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir. Chaîne de caractères composée de lettres, de chiffres et des caractères _ et -
|
module_type | Texte | --- | server-analyzer | Ne peut être modifié. |
Fonctionnement de la source
import_interval 0 order 10 # enabled: is this analyzer enabled or not enabled 1
| Nom | Type | Unité | Défaut | Commentaire |
|---|---|---|---|---|
import_interval | Entier Positif | Minutes | 0 | Valeur inutilisée, cette source doit obligatoirement être exécutée manuellement |
order | Entier Positif | --- | 10 | L'ordre de la source dans l'interface de configuration. Permet de prioriser l'import de cette source par rapport à d'autres. La priorité est prise en compte lors du calcul des différences des éléments importés.
Remarque : Si vous changez l'ordre depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour. |
enabled | Booléen | --- | 1 | Permets d'activer ou désactiver l'écouteur ( 1 pour activer, 0 pour désactiver ). Il est possible de faire cette action depuis l'interface de configuration. Remarque : Si vous activer/desactiver l'analyseur depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour. |
Affichage
# description: display a description on the interface for this source description The server analyzer allow to launch an analyze script on distant servers
| Nom | Type | Unité | Défaut | Commentaire |
|---|---|---|---|---|
description | Texte | --- | --- | Ce paramètre sert à afficher une description dans l'affichage de la source sur l'interface de configuration. |