Power DNS Recursor

Supported OS Linux Windows Mac OS

Versión de la integración4.1.0

Información general

Realiza un seguimiento del rendimiento de tu PowerDNS Recursor y monitoriza el tráfico extraño o preocupante. Este check del Agent recopila una variedad de métricas de tus recursors, incluyendo los de:

  • Tiempos de respuesta de las consultas, para observar cuántas respuestas tardan menos de 1ms, 10ms, 100ms, 1s o más de 1s.
  • Tiempos de espera de consultas.
  • Aciertos y errores de caché.
  • Índices de respuesta por tipo: SRVFAIL, NXDOMAIN, NOERROR.
  • Paquetes ignorados y descartados.

Y muchos más.

Configuración

Instalación

El check del PowerDNS Recursor está incluido en el paquete del Datadog Agent, por lo que no necesitas instalar nada más en tus recursors.

Configuración

Preparación de PowerDNS

Este check recopila estadísticas de rendimiento utilizando la API de estadísticas del PowerDNS Recursor. Las versiones de pdns_recursor anteriores a la v4.1 no habilitan la API de estadísticas por defecto. Si estás ejecutando una versión anterior, habilítala añadiendo lo siguiente a tu archivo de configuración del recursor, por ejemplo /etc/powerdns/recursor.conf:

webserver=yes
api-key=changeme                       # sólo disponible a partir de la v4.0
webserver-readonly=yes                 # por defecto no
#puerto del servidor web=8081         # por defecto 8082
#dirección del servidor web=0.0.0.0    # por defecto 127.0.0.1

Si ejecutas pdns_recursor v3.x, añade experimental- a los nombres de estas opciones, por ejemplo: experimental-webserver=yes.

Si ejecutas pdns_recursor v4.1 o posterior, simplemente configura api-key.

Reinicia el recursor para habilitar la API de estadísticas.

Host

Para configurar este check para un Agent que se ejecuta en un host:

  1. Edita el archivo powerdns_recursor.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración del Agent. Para ver todas las opciones de configuración disponibles, consulta el powerdns_recursor.d/conf.yam de ejemplo:

    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. Reinicia el Agent.

Recopilación de logs
  1. La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent; debes habilitarla en el archivo datadog.yaml:

    logs_enabled: true
    
  2. Añade el usuario dd-agent al grupo systemd-journal ejecutando:

    usermod -a -G systemd-journal dd-agent
    
  3. Añade este bloque de configuración al archivo powerdns_recursor.d/conf.yaml para empezar a recopilar logs del PowerDNS Recursor:

    logs:
      - type: journald
        source: powerdns
    

    Para ver todas las opciones de configuración disponibles, consulta el powerdns_recursor.d/conf.yaml de ejemplo.

  4. Reinicia el Agent.

Contenedorizado

Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

ParámetroValor
<INTEGRATION_NAME>powerdns_recursor
<INIT_CONFIG>en blanco o {}
<INSTANCE_CONFIG>{"host":"%%host%%", "port":8082, "api_key":"<POWERDNS_API_KEY>", "version": 3}
Recopilación de logs

La recopilación de logs está desactivada por defecto en Datadog Agent. Para activarla, consulta recopilación de logs de Kubernetes.

ParámetroValor
<LOG_CONFIG>{"source": "powerdns"}

Validación

Ejecuta el subcomando de status del Agent y busca powerdns_recursor en la sección Checks.

Datos recopilados

Métricas

Eventos

El check del PowerDNS Recursor no incluye eventos.

Checks de servicio

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.

PREVIEWING: may/embedded-workflows