Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-htmlfalse
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
Panel
titleSommaire

Table of Contents
stylenone

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 :

Code Block
themeEmacs
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


Warning
titleImportant

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
Code Block
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
Code Block
_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