Présentation

Le listener-rest est une source qui expose une API REST permettant d'ajouter de nouveaux hôtes via des requêtes HTTP contenant un objet décrivant un hôte au format JSON.

Voici un exemple de requête avec curl :

curl -u USER:PASSWORD \
     -H "Content-Type: application/json" \
     -d '{"host_name":"my_host", "use":"linux", "address":"192.168.1.254"}' \
     -X PUT 'http://SYNCHRONIZER-IP-INTERFACE:7761/shinken/listener-rest/v1/hosts/'


La description des différents appels REST sont décris dans la page suivante : API REST: Gérer des hôtes ou des clusters


L'ensemble des hôtes reçus sont stockés dans la base de donnée de l'écouteur.

  • Ce stockage permet de proposer une persistance des hôtes.

Si vous en supprimez 1 ou X :

  • Ils disparaîtront de la base de données de l'écouteur ( Ils sont toujours présents dans les espaces de donnée Staging ou Zone de travail si ils avaient été importés ).
  • Il faut donc être prudent car les envois vers l'écouteur non importés dans l'UI de Configuration seront perdus ( Si l'appel à l'API REST n'est fait qu'une fois par le script, ou l'outil distant, par exemple ).

Définition de la source

Vous trouverez la procédure de mise en place et de configuration dans la page suivante Ecouteur de type listener-rest

Comment les données de l'écouteur se mélange avec les autres sources

L'un des intérêts des sources est de permettre de fusionner les éléments découverts par chaque source en un élément si une correspondance existe.

Clés de synchronisation

Voici les propriétés utilisées pour la construction des clés de synchronisation, des éléments fournis par l'écouteur de type "listener-rest":

Propriété Type d'élémentInfo
Nom de l'élément
Tous les élémentsCette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation
_SE_UUID
Tous les élémentsCette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation