Présentation
Ce check permet de surveiller Pi-hole avec l’Agent Datadog.
Configuration
Le check Pi-hole n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.
Installation
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.
Configuration
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.
Redémarrez l’Agent.
Validation
Lancez la sous-commande status de l’Agent et cherchez pihole dans la section Checks.
Collecte de logs
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 :
- Activez ce bloc de configuration dans votre fichier
pihole.d/conf.yaml pour commencer à recueillir vos logs :logs:
- type: file
path: /var/log/pihole.log
source: pihole
Données collectées
Métriques
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 |
Événements
Pi-hole n’inclut aucun événement.
Checks de service
pihole.running
Returns CRITICAL if the check can’t access pihole, OK otherwise.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
