Page History

Description

Les écouteurs sont des sources qui permettent d'envoyer des informations directement dans le Synchronizerpassives comme comme par exemple une API sur laquelle il est possible de faire des appels pour ajouter des éléments à superviser.

Pour le moment, il n'y a qu'un type d'écouteur livré par Shinken qui permet d'ajouter un nouveau écouteur :

• listener-rest : Ajoute une API de type "REST" permettant à une application tierce d'importer des hôtes dans Shinken grâce à des requêtes HTTP.
  • ( Voir la page Écouteur de type ( listener-rest ) - Ajout d'hôte avec une API REST )

Le listener-shinken est un écouteur interne à Shinken. Il n'est pas possible d'en ajouter un autre.

Vous pouvez essayer ce type de source soit en activant le collecteur "listener-rest" présent par défaut ou en activant vos propres listener de type listener-rest.

Activer le collecteur listener-rest livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de type listener-rest appelé "listener-rest".

• La configuration de ce collecteur se trouve par défaut dans le fichier : /etc/shinken/sources/listener-rest.cfg
• Le collecteur listener-rest 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 listener 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:

    Code Block
    language bash
    define synchronizer { [...] sources Source 1, Source 2, Source 3, listener-rest   [...] }

• Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source

  Code Block
  language bash theme Confluence
  service shinken-synchronizer restart

Ajouter un autre collecteur de type listener-rest

Vous pouvez avoir plusieurs sources du type listener-rest, pour par exemple se connecter à plusieurs serveurs listeners.

Choisissez un nom pour ce nouveau collecteur.

• Pour l'exemple, nous allons l'appeler "Mon-Listener-Rest".
• Remplacer dans l'exemple le mot "Mon-Listener-Rest" 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/listeners/listener-rest/listener-rest-example.cfg dans le répertoire de définition des sources /etc/shinken/sources/.
  ( Exemple : /etc/shinken/sources/listener__listener-rest__Mon-Listener-Rest.cfg )
  
  

  Code Block
  language bash theme Confluence
  cp  /etc/shinken-user-example/configuration/daemons/synchronizers/listeners/listener-rest/listener-rest-example.cfg /etc/shinken/sources/listener__listener-rest__Mon-Listener-Rest.cfg

• Ouvrer ce fichier ( listener__listener-rest__Mon-Listener-Rest.cfg ) :

  • modifier la ligne source_name en remplaçant le nom par défaut "listener-rest-example" par le nom que vous avez choisi "Mon-Listener-Rest".
    
    

    Code Block
    language bash
    define source { [...]   source_name         Mon-Listener-Rest   [...] }

• Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.
  
  

  Code Block
  language bash
  define synchronizer { [...] sources Source 1, Source 2, Source 3, Mon-Listener-Rest   [...] }

• Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source.

  Code Block
  language bash theme Confluence
  service shinken-synchronizer restart