Host

To configure this check for an Agent running on a host:

1. Edit the powerdns_recursor.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample powerdns_recursor.d/conf.yaml for all available configuration options:

   init_config:
   
   instances:
     ## @param host - string - required
     ## Host running the recursor.
     #
     - host: 127.0.0.1
   
       ## @param port - integer - required
       ## Recursor web server port.
       #
       port: 8082
   
       ## @param api_key - string - required
       ## Recursor web server api key.
       #
       api_key: "<POWERDNS_API_KEY>"
   
       ## @param version - integer - required - default: 3
       ## Version 3 or 4 of PowerDNS Recursor to connect to.
       ## The PowerDNS Recursor in v4 has a production ready web server that allows for
       ## statistics gathering. In version 3.x the server was marked as experimental.
       ##
       ## As the server was marked as experimental in version 3 many of the metrics have
       ## changed names and the API structure (paths) have also changed. With these changes
       ## there has been a need to separate the two concerns. The check now has a key value
       ## version: which if set to version 4 queries with the correct API path on the
       ## non-experimental web server.
       ##
       ## https://doc.powerdns.com/md/httpapi/api_spec/#url-apiv1serversserver95idstatistics
       #
       version: 3
   

2. Restart the Agent.

Log collection

1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

   logs_enabled: true
   

2. Add the dd-agent user to the systemd-journal group by running:

   usermod -a -G systemd-journal dd-agent
   

3. Add this configuration block to your powerdns_recursor.d/conf.yaml file to start collecting your PowerDNS Recursor Logs:

   logs:
     - type: journald
       source: powerdns
   

   See the sample powerdns_recursor.d/conf.yaml for all available configuration options.

4. Restart the Agent.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Log collection

Collecting logs is disabled by default in the Datadog Agent. To enable it, see Kubernetes Log Collection.