Page History

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/'

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

Chaque source utilisera le même format d'API REST, mais chaque écouteur aura sa propre base de stockage.

'

La description des différents appels

REST sont décris dans la page suivante :

API REST: Gérer des hôtes ou des clusters

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.

• Lors de l'étape du mélange des sources les clés de synchronisation permettent de déterminer quelles informations seront utilisés pour trouver que 2 éléments correspondent ( 2 hôtes, par exemple ) .
• Vous trouverez plus d'information sur ce mécanisme dans les pages suivantes :
  
  • Modules de Sources ( imports ) et de Taggers ( qualification )
  • Le mélange des sources & les clés de synchronisation (sync-key)

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

Nom de l'élément

_SE_UUID