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 )

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 une définition de type le listener "listener-rest appelé " qui est de type listener-rest".

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

  Code Block

  language	bash
  theme	Confluence

  service shinken-synchronizer restart

  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 sources du type listener-restécouteurs, pour par exemple se connecter à plusieurs serveurs listenerspermettre 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 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.

  Code Block

  language	bash
  theme	Confluence

  service shinken-synchronizer restart

  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