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
Important
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.
- 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 :
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ément | Info |
|---|---|---|
Nom de l'élément | Tous les éléments | Cette 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éments | Cette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation |