Description

Les écouteurs sont des sources passives 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:

    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

  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 )
  
  

  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".
    
    

    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.
  
  

  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.

  service shinken-synchronizer restart