Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue


Panel
titleSommaire

Table of Contents
stylenone



Description

Les Analyseurs ont pour objectifs d’interroger équipement après équipement, pour les analyser et remonter des informations.

  • Les Analyses peuvent être lancées depuis
    • les hôtes déjà présents dans Shinken, afin d'enrichir les données présentes
    • ou bien depuis une plage réseau.

  • Il y a un analyseur disponible par défaut :
    • server-analyser : permet d'analyser sur des serveurs ( linux ou windows ), en y déployant un script d'analyse, qui collecte les données et les mets à disposition du Synchronizer.

Ajouter un nouveau analyseur

1 - Création du fichier cfg de l'analyseur

Pour ajouter un nouveau analyseur, il faut crée un fichier avec sa configuration et quelle type de module ( code-source ) doit être utiliser pour cette source.

Il n'y a pour le moment qu'un type d'analyseur.

d'autres AnalyseursIl est possible d'ajouter d'autres Analyseurs en créant un fichier de configuration dans le dossier
  • La sous-page suivante décrit comment faire le fichier : Analyseur de type server-analyzer.
  • Les fichiers de configurations des analyseurs doivent être mis par défaut dans le répertoire :
  • /etc/shinken/analyzers/
.

Ce fichier de configuration sera sous la forme suivante :

WarningIl doit y avoir un fichier cfg par source.

2 - Activation de l'analyseur sur le Synchronizer

Une fois le fichier de configuration fait, il faut ajouter l'analyseur 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 analyseur dans le paramètre sources.


Exemple: Pour l'analyseur nommé "my-analyzer"

Code Block
languagebash
themeConfluence
titleExemple :
#===============================================================================
# server-analyzer
#===============================================================================
# Daemons that can load this listener:
# - synchronizer
#===============================================================================


define analyzer define synchronizer {
    #======== Analyzer identity =========
    # Analyzer name. Must be unique
    analyzer_name		    server-analyzer

    # Analyzer type (to load module code). Do not edit.[...]
    module_typesources     	   server-analyzer
    
    # description: display aSource description1, onSource the2, interfaceSource for this source
    description		       The server analyzer allow to launch an analyze script on distant servers3, my-analyzer
     
    import_interval	        0
    order		            10

    # enabled: is this listener enabled or not
    enabled		           1

}

Détails des sections composants le fichier de configuration

Identification du module de l'analyseur

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

NomTypeDéfautCommentaire
Code Block
analyzer_name
Texte

Chaîne de caractères composée de lettres, de chiffres et des caractères _  et -

[...]
}


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

Code Block
service shinken-synchronizer restart
  • Doit être unique 
  • Doit commencer par une lettre.
  • D'une longueur maximum à 40 caractères
  • Ne doitpas contenir le caractère "$"
    Code Block
    module_type 
    TexteCorrespond au type de module collecteur de la source ( permet au Synchronizer de charger le code logiciel correspondant ).
    Code Block
    description
    Texte

    Text descriptive de la source visible dans l'interface de configuration.

    Intervalle d'import et ordre de l'analyseur

    NomTypeDéfautCommentaire
    Code Block
    import_interval
    Nombre0

    Délai écoulé entre les imports automatiques de l'analyseur.
    Si 0, l'import de l'analyseur ne sera jamais exécuté automatiquement.

    Code Block
    order
    Nombre10

    L'ordre de l'analyseur 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.

    Activation de l'analyseur

    NomTypeDéfautCommentaire
    Code Block
    enabled
    Booléen1

    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.