Les fichiers de définition des écouteurs se trouvent dans le dossier /etc/shinken/listeners/. Il doit y avoir un fichier cfg par source.
La source listener-shinken est une source interne et ne présente pas de fichier de configuration.
La structure d'un fichier de module écouteur respecte la définition précisée dans la Créer et organiser ses sources.
Voici la liste des options spécifiques pour un écouteur.
| Nom de l'option | Valeurs possibles | Effet sur le fonctionnement de la source | |
|---|---|---|---|
| listener_name | < un nom > | Cette option remplace l'option source_name. Sera le nom affiché de la source dans l'interface. Ce nom ne doit pas dépasser 40 caractères. Un nom trop long empêchera le Synchronizer de démarrer.
| |
| module_type | listener-rest | Définis la source comme un module de type écouteur. | |
| import_interval | 0 | Cette source ne peut être importée automatiquement. | |
| not_stored_properties | < liste de champs > | Ce paramètre permet de définir un ou plusieurs champs qui ne seront pas importés dans shinken. Cela peut être utile pour exclure une propriété ou bien utiliser des champs personnalisés utiles pour la gestion de vos fichiers .cfg | |
| host | < une adresse IP > | L'adresse IP d'écoute du module. Pour écouter sur toutes les adresses de la machine, mettre 0.0.0.0 | |
| port | < un entier > | Définis le port d'écoute du module. Dois être entre 1024 et 65535 |