Présentation

Un écouteur est une source qui reçoit des informations à partir d'une application tierce. Cette source est donc à l'écoute de nouveaux éléments grâce à des appels réseau.

Cette source est configurable dans la Configuration d'un écouteur.

Il y a 2 écouteurs disponibles par défaut :

• listener-rest : Une API de type "REST" permettant à une application tierce d'importer des hôtes dans Shinken grâce à des requêtes HTTP.
• listener-shinken : Cet écouteur permet d'importer l'architecture de Shinken à chaque modification de celle ci.

Il peut être intéressant de rajouter des écouteurs pour différencier l'origine des informations reçus. Chaque source utilisera le même format d'API REST, mais chaque écouteur aura sa propre base de stockage.

Affichage des écouteurs

Pour chaque écouteur, il est présenté :

• Son ordre à l'import des sources

• Son nom : un clic sur ce champs donne accès à la Configuration d'un collecteur

• Si la source est activée ou pas.

• L'état de la source (si elle est activée).

  • Vert : Tout va bien.
  • Orange : L'import ne s'est pas déroulé correctement, il faudra une vérification des éléments importés.
  • Rouge: La source est en erreur.
• Le nombre d’éléments trouvés (si la source est activée):
  • Les nombres sont cliquables et permettent de voir les éléments en question filtrés par statut :
    • en vert, le nombre d'éléments importés correctement
    • en orange, le nombre d'éléments qui requiert votre attention (si au moins un élément est dans cet état)
    • en rouge, le nombre d'éléments non importés à cause d'une erreur (si au moins un élément est dans cet état)
• Le résultat de la dernière écoute.
• Depuis quand la dernière réception de données a eu lieu.

Les boutons:

• Activé : Permet d'activer la source ou de la désactiver.
• Actualiser :  Recalcule les nouveaux et les différences pour cette source.
• Nettoyer l'import  :  Enlève les éléments découverts lors des écoutes.

Description de l'API

curl -X PUT 'http://192.168.1.21:7761/v1/hosts/' -H "Content-Type: application/json" -d '{"host_name":"test-listener-1 "}'

curl -X PUT 'http://192.168.1.21:7761/shinken/listener-rest/v1/hosts/' -H "Content-Type: application/json" -d '{"host_name":"test-listener-1 "}'

7a44865eed4442a6b61990f49a076b37

curl 'http://192.168.1.21:7761/v1/hosts/' | python -m json.tool

curl -X PUT 'http://192.168.1.21:7761/v1/hosts/7a44865eed4442a6b61990f49a076b37' -H "Content-Type: application/json" -d '{"enabled":"0"}'

curl -X DELETE 'http://192.168.1.21:7761/v1/hosts/c150fd7ec4014a169472a3ac1a6346ca'

curl -u test:test -X PUT 'http://192.168.1.21:7761/v1/hosts/' -H "Content-Type: application/json" -d '{"host_name":"host-add-with-rest"}'

curl -u test:test -X PUT 'http://192.168.1.21:7761/v1/hosts/' -H "Content-Type: application/json" -d '{"host_name":"test-listener-10"}' && curl -u test:test -X PUT 'http://192.168.1.21:7761/v1/hosts/' -H "Content-Type: application/json" -d '{"host_name":"test-listener-11"}'