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.

La description des différents appels réseau à utiliser se trouve API REST: Gérer des hôtes.

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 est utilisé pour importer l'architecture de Shinken à chaque modification de celle-ci et pour les collecteurs de type synchronizer-collector-linker.

Il peut être intéressant de rajouter des é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.

Affichage des écouteurs

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

• Son ordre à l'import des sources

• Son nom : un clic sur ce champ donne accès à la Configuration d'un écouteur

• Si la source est activée ou pas.

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

  • OK : Tout va bien.
  • Avertissement : L'import s'est correctement déroulé, mais certains éléments possèdent des propriétés incorrecte ou malformer
  • Erreur : 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 la liste filtrée des éléments par statut ( en fonction de la couleur du nombre)  :
    • 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.