Supported OS
Ce check permet de surveiller Pi-hole avec l’Agent Datadog.
Le check Pi-hole n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.
Pour l’Agent v7.21+/6.21+, suivez les instructions ci-dessous afin d’installer le check Pi-hole sur votre host. Consultez la section Utiliser les intégrations de la communauté pour effectuer une installation avec l’Agent Docker ou avec des versions antérieures de l’Agent.
Exécutez la commande suivante pour installer l’intégration de l’Agent :
sudo -u dd-agent -- datadog-agent integration install -t datadog-pihole==<INTEGRATION_VERSION>
Configurez votre intégration comme une intégration de base.
Modifiez le fichier pihole.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Pi-hole. Consultez le fichier d’exemple pihole.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Lancez la sous-commande status de l’Agent et cherchez pihole dans la section Checks.
Sur les plateformes Linux, l’activation de la collecte de logs pour l’Agent Datadog se fait dans /etc/datadog-agent/datadog.yaml. Sur les autres plateformes, consultez la section Fichiers de configuration de l’Agent pour connaître l’emplacement de votre fichier de configuration :
logs_enabled: true
pihole.d/conf.yaml pour commencer à recueillir vos logs :logs:
- type: file
path: /var/log/pihole.log
source: pihole
| 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 |
Pi-hole n’inclut aucun événement.
pihole.running
Returns CRITICAL if the check can’t access pihole, OK otherwise.
Statuses: ok, critical
Besoin d’aide ? Contactez l’assistance Datadog.
| |