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.