Page History

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 )

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.

• Il peut être utile d'ajouter plusieurs écouteurs pour différencier l'origine des informations reçues.
  
  

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

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

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

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

  excerpt-include

• Configuration ( Synchronizer ) Configuration ( Synchronizer ) page DefaultLink[destination=Optional[PageResourceIdentifier[spaceKey=<null>,title=Configuration ( Synchronizer )]],body=Optional.empty,tooltip=Optional.empty,anchor=Optional.empty,target=Optional.empty] nopanel true

Ajouter un autre ecouteur de type listener-rest

Vous pouvez avoir plusieurs écouteurs, pour par exemple permettre de distinguer simplement les requêtes reçues de plusieurs émetteurs ( Chaque écouteur centralisant les requêtes de chaque émetteur ).

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

  Warning
  title Important
  Le fichier listener-rest-example.cfg livré dans Shinken actuellement n'est pas a jour et ne correspond donc pas à l'exemple fourni dans la page décrivant le contenu du fichier de configuration ( Voir la page Écouteur de type ( listener-rest ) - Ajout d'hôte avec une API REST ). Ceci sera corrigé dans la prochaine version de Shinken. En attendant, remplacez le contenu du fichier listener__listener-rest__Mon-Listener-Rest.cfg que vous venez de créer par le contenu de l'exemple de configuration => Ainsi vous aurez toutes les paramètres disponibles pour cet écouteur.

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

  Excerpt Include
  Configuration ( Synchronizer ) Configuration ( Synchronizer ) page DefaultLink[destination=Optional[PageResourceIdentifier[spaceKey=<null>,title=Configuration ( Synchronizer )]],body=Optional.empty,tooltip=Optional.empty,anchor=Optional.empty,target=Optional.empty] nopanel true