Pi-hole

Supported OS

Integration version3.14.1

Información general

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.

  1. Ejecuta el siguiente comando para instalar la integración del Agent:

    sudo -u dd-agent -- datadog-agent integration install -t datadog-pihole==<INTEGRATION_VERSION>

  2. Configura tu integración como si fuese una integración de base.

Configuración

  1. 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.

  2. 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:

logs_enabled: true
  • 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.