VISTA PREVIA PÚBLICA
Esta característica se encuentra actualmente en versión preliminar pública y solo se aplica a las versiones a partir de 0.0.5 lanzadas en octubre de 2021.
Nuestra integración PowerDNS recopila y envía métricas dimensionales desde PowerDNS. Puede ver estos datos métricos en un panel prediseñado, crear políticas de alertas y crear consultas y gráficos personalizados.
Continúe leyendo para instalar la integración y ver qué datos recopilamos.
Compatibilidad y requisitos
Nuestra integración es compatible con PowerDNS Recursor y Authoritative Server.
Antes de instalar la integración, asegúrese de cumplir con los siguientes requisitos:
- Instale el agente de infraestructura, versión mínima 1.19.2.
- Distribución de Linux compatible con el agente de infraestructura.
Para obtener datos de la infraestructura PowerDNS, nuestra integración PowerDNS utiliza un exportador Prometheus de terceros, que expone Prometheus métrica en el puerto especificado en la configuración. La integración recopila estas métricas, las transforma en entidad, las filtra y luego las envía a New Relic.
Para habilitar la API, es necesario habilitar el servidor web y la API HTTP.
Agregue estas líneas al pdns.conf:
api=yesapi-key=changeme
Y reinicie, los siguientes ejemplos deberían comenzar a funcionar:
curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost | jq .curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1
Para obtener más información, Habilitación del servidor web y la API.
Instalar y activar
Para instalar la integración de PowerDNS, elija su configuración:
¿Te ha ayudado este documento con la instalación?
Configurar la integración
Para configurar la integración, edite la configuración en el archivo de configuración YAML de la integración powerdns-config.yml
.
Utilice la configuración YAML para colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan sus datos, según su configuración y preferencias.
Dado que esta integración se basa en un exportador de Prometheus, no se admiten configuraciones aplicables a otras integraciones, como interval
, timeout
o inventory_source
.
Configuración de instancia de PowerDNS
Están disponibles las siguientes opciones de configuración:
Configuración | Descripción | Por defecto |
---|---|---|
powerdns_url | URL API del servicio powerdns | N/A |
exporter_port | Puerto para exponer el extremo de scrape. Si no se proporciona, se utilizará un puerto aleatorio para iniciar el exportador. | port aleatorio |
scrape_timeout | Tiempo hasta que se agote el tiempo de espera de una solicitud de extracción | 5s |
api_key | Clave de API utilizada para conectarse al servidor PowerDNS | N/A |
Configuración de ejemplo
Buscar y utilizar datos
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
Métrica se adjuntan a los tipos de muestra y evento métrica de la entidad POWERDNS_AUTHORITATIVE
y POWERDNS_RECURSOR
. Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles personalizados.
Datos métricos
Se crean dos entidades: POWERDNS_AUTHORITATIVE
y POWERDNS_RECURSOR
.
Las siguientes dimensiones métricas se capturan raspando el exportador y se vinculan a la entidad POWERDNS_AUTHORITATIVE
:
Nombre | Descripción | Dimensiones |
---|---|---|
| Tiempo de actividad en segundos del daemon. |
|
| Número de entradas en la caché de paquetes. | |
| Número total de consultas recursivas por estado. |
|
| Direcciones IP del servidor remoto. |
|
| Estado de seguridad del servidor PDNS basado en | |
| Número total de excepciones por error. |
|
| Número promedio de microsegundos que pasa un paquete dentro de PowerDNS. | |
| Número total de consultas de actualización de DNS por estado. |
|
| Número de paquetes en espera de atención de la base de datos. | |
| Distribución de rcodes. |
|
| Número de entradas en la caché de firmas. | |
| Consulta por dominio para el cual no tenemos autoridad. |
|
| Número total de bytes de respuesta enviados por protocolo. |
|
| Consulta UDP recibida. |
|
| Número de errores al analizar las estadísticas JSON de PowerDNS. | |
| Acciones de caché diferidas por mantenimiento por tipo. |
|
| La última versión de PowerDNS fue exitosa. | |
| Consulta búsquedas de caché por resultado. |
|
| Número de entradas en la caché de claves. | |
| Número total de respuestas por protocolo. |
|
| Búsquedas de caché de paquetes por resultado. |
|
| Número de entradas en la caché de metadatos. | |
| Número total de consultas por protocolo. |
|
| Número de milisegundos de CPU invertidos en el espacio del usuario y del kernel. |
|
| Contadores DNSSEC. |
|
| Distribución del tamaño de las respuestas. |
|
| Eliminaciones totales actuales de PowerDNS. | |
| Hosts remotos que consultan dominios para los cuales no tenemos autoridad. |
|
Las siguientes dimensiones métricas se capturan raspando el exportador y se vinculan a la entidad POWERDNS_RECURSOR
:
Nombre | Descripción | Dimensiones |
---|---|---|
| Número total de consultas entrantes por red. |
|
| Número total de consultas salientes por red. |
|
| Número de entradas en la caché. | |
| Número total de búsquedas de caché por resultado. |
|
| Número de errores al analizar las estadísticas JSON de PowerDNS. | |
| Número total de respuestas por código de respuesta. |
|
| Eliminaciones totales actuales de PowerDNS. | |
| Número de consultas concurrentes. | |
| Número total de respuestas agrupadas por intervalos de tiempo de respuesta. |
|
| Media móvil exponencial de latencia entre preguntas y respuestas. | |
| Número total de excepciones por error. |
|
| Histograma del recursor PowerDNS tiempo de respuesta en segundos. (suma métrica) | |
| Histograma del recursor PowerDNS tiempo de respuesta en segundos. (métrica del cubo) |
|
| La última versión de PowerDNS fue exitosa. |
Comprueba el código fuente
Esta integración es software de código abierto. Esto significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.
Además, esta integración aprovecha un exportador de código abierto creado por la comunidad.