Versión de la integración3.14.1
Este check monitoriza Pi-hole a través del Datadog Agent.
Configuración
El check de Pi-hole no está incluido en el paquete del Datadog Agent, por lo que es necesario instalarlo.
Instalación
Para versiones 7.21/6.21 o posteriores del Agent, sigue las siguientes instrucciones para instalar el check de Pi-hole en tu host. Para instalarlo con el Agent Docker o versiones anteriores del Agent, consulta Uso de integraciones de la comunidad.
Ejecuta el siguiente comando para instalar la integración del Agent:
sudo -u dd-agent -- datadog-agent integration install -t datadog-pihole==<INTEGRATION_VERSION>
Configura tu integración como si fuese una integración de base.
Configuración
Edita el archivo pihole.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración del Agent, para empezar a recopilar los datos de rendimiento de tu Pi-hole. Para conocer todas las opciones de configuración disponibles, consulta el pihole.d/conf.yaml de ejemplo.
Reinicia el Agent.
Validación
Ejecuta el subcomando de estado del Agent y busca pihole en la sección Checks.
Recopilación de logs
Habilita la recopilación de logs para el Datadog Agent en /etc/datadog-agent/datadog.yaml en plataformas Linux. En otras plataformas, consulta la guía Archivos de configuración del Agent para ver la ubicación de tu archivo de configuración:
- Habilita este bloque de configuración en tu archivo
pihole.d/conf.yaml para empezar a recopilar logs:logs:
- type: file
path: /var/log/pihole.log
source: pihole
Datos recopilados
Métricas
pihole.queries_forwarded
(gauge) | Queries not blocked
Shown as query |
pihole.domains_being_blocked
(gauge) | Domains that are currently being blocked |
pihole.ads_percent_blocked
(gauge) | Percentage of ads blocked today
Shown as percent |
pihole.ads_blocked_today
(gauge) | Number of ads blocked today |
pihole.dns_queries_today
(gauge) | Amount of queries made to Pi-hole |
pihole.clients_ever_seen
(gauge) | Total clients |
pihole.unique_clients
(gauge) | Total number of unique clients |
pihole.queries_cached
(gauge) | Number of cached queries
Shown as query |
pihole.unique_domains
(gauge) | Number of unique domains seen |
pihole.reply_nodata
(gauge) | Number of no data replies |
pihole.reply_cname
(gauge) | Number of cname replies |
pihole.reply_ip
(gauge) | Number of ip replies |
pihole.reply_nxdomain
(gauge) | Number of nxdomain replies |
pihole.dns_queries_all_types
(gauge) | Amount of queries made to Pi-hole of all types |
Eventos
Pi-hole no incluye eventos.
Checks de servicio
pihole.running
Returns CRITICAL if the check can’t access pihole, OK otherwise.
Statuses: ok, critical
Solucionar problemas
¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.
