Aller au contenu principal

Protocol WHOIS

Contenu du Pack​

Modèles​

Le Pack Centreon WHOIS apporte un modèle d'hôte :

  • App-Protocol-Whois-custom

Il apporte le modèle de service suivant :

AliasModèle de ServiceDéfautDécouverte
DomainApp-Protocol-Whois-Domain

Métriques & statuts collectés​

Metric nameDescriptionUnit
domain statusDomain status: checkError, notRegistered,...
domain_name#whois.response.time.millisecondsTime to retrieve whois domain informationms
domain_name#domain.expires.secondsRegistration expiration times

Prérequis​

Pour superviser vos domaines, la commande système whois doit être fonctionnelle.

Installation​

  1. Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Protocol WHOIS :
yum install centreon-plugin-Applications-Protocol-Whois
  1. Sur l'interface web de Centreon, installer le Pack Protocol WHOIS depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes
  • Complétez les champs Nom, Alias & IP Address / DNS correspondant à votre domaine Protocol WHOIS.
  • Appliquez le modèle d'hôte App-Protocol-Whois-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.

Une fois celui-ci configuré, certaines macros doivent être renseignées:

ObligatoireNomDescription
PROTOCOLWHOISEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (su - centreon-engine) :

/usr/lib/centreon/plugins/centreon_protocol_whois.pl \
--plugin=apps::protocols::whois::plugin \
--mode=domain \
--domain='centreon.com' \
--domain='centreon.fr' \
--verbose

La commande devrait retourner un message de sortie similaire à :

OK: All domains are ok | 'centreon.com#whois.response.time.milliseconds'=237ms;;;0; 'centreon.com#domain.expires.seconds'=27417843s;;;0; 'centreon.fr#whois.response.time.milliseconds'=125ms;;;0; 'centreon.fr#domain.expires.seconds'=24120041s;;;0;
checking domain 'centreon.com'
whois reponse time: 237 ms
status: clientDeleteProhibited,clientTransferProhibited,clientDeleteProhibited,clientTransferProhibited
expires in 10M 1w 5d 23h 13m 33s
checking domain 'centreon.fr'
whois reponse time: 125 ms
status: ACTIVE
expires in 9M 5d 5h 39m 14s

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_protocol_whois.pl \
--plugin=apps::protocols::whois::plugin \
--mode=domain \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins/centreon_protocol_whois.pl \
--plugin=apps::protocols::whois::plugin \
--list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée des plugins.