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.

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 d'autres é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 réseau sont décris dans API REST: Gérer des hôtes ou des clusters 02.08.02.
• L'explication pour configurer, une source de type écouteurs reportez vous à Configuration d'un écouteur.

Affichage des écouteurs  dans la page principale

Les écouteurs sont regroupés dans la page principal sous la partie "Écouteur"

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

1. Son ordre à l'import des sources
2. Si la source est activée ou pas
3.  Son nom  : un clic sur ce champ donne accès à la Configuration d'un écouteur ( Voir la page Configuration d'un écouteur )
4. L’état de la source ( si source activée ) ( Voir la page Concept général et utilisation des sources )
   
   • OK : Tout va bien ;
   • Avertissement : L'import s'est correctement déroulé, mais certains éléments possèdent des propriétés incorrecte ou mal formé ;
   • Erreur : La source est en erreur ;
   • ...
5. Le nombre d’éléments trouvés ( si source 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 ) ;
6. Le résultat de la dernière écoute ( si source activée ) ;
7. Depuis quand la dernière réception de données a eu lieu ( si source activée ) ;

Interactions possible de l'utilisateur

• Activé : Le clic permet d'activer la source ou de la désactiver ;
• Le nom:  Le clic donne accès à la page spécifique de la source ;
  • L'onglet affiché sera :
    • "Configuration", si votre source contient des erreurs de configuration ;
    • "Détail de la dernière exécution", sinon ;
• les nombres : le clic permet de voir les éléments filtrés par statut ( ok, warning, erreur ) dans l'onglet "Détail de la dernière exécution" de votre source ;
• Le bouton permet d'ouvrir votre source sur l'onglet "Résumé des dernières exécutions" ;