Skip to main content

DNS Service


The Domain Name System (DNS) is a naming system for resources connected to the Internet or a private network. A DNS Service provides a way to match domain names to IP addresses.

The Centreon Monitoring Connector DNS Service checks if a resolution for a domain name (default: can be obtained.

Monitoring Connector assets​

Monitored objects​

  • DNS Server

Monitored metrics​

Metric nameDescriptionUnit
timeElapsed time to complete DNS requests

This mode allow to check that the server executing the probe correctly resolve its own address.



  1. Install the Centreon package on every poller expected to monitor a DNS server:
yum install centreon-plugin-Applications-Protocol-Dns
  1. On the Centreon Web interface, install the Centreon Monitoring Connector DNS Service from the Configuration > Monitoring Connector Manager page


  • Log into Centreon and add a new Host through "Configuration > Hosts".
  • Apply the App-Protocol-DNS-custom template and fill the form.

Once the Host created, you can configure the Services following macro on the Services:

SEARCHThe domain name for which you want a resolution


How can I test the Plugin in the CLI and what do the main parameters stand for ?​

Once the Centreon Plugin installed, you can test it directly in the CLI of the Centreon poller by logging with the centreon-engine user:

/usr/lib/centreon/plugins// \
--plugin=apps::protocols::dns::plugin \
--mode=request \
--nameservers \

Expected output:

OK: Response time 0.011 second(s) (answer: | 'time'=0.011s;;;;

The available thresholds as well as all of the options that can be used with this Plugin can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins// \
--plugin=apps::protocols::dns::plugin \
--mode=request \
--search='' \

You can display all of the modes that come with the Plugin with the command below:

/usr/lib/centreon/plugins// \
--plugin=apps::protocols::dns::plugin \

Why do I get the following message: CRITICAL: DNS query failed: query timed out |​

This message indicates that the number of seconds to wait for the DNS request to complete has elapsed. It means that there is probably no DNS server providing DNS service on the specified server. The command time can be used to determine how long the DNS request takes to execute.