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.

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

2. Configurez votre intégration comme une intégration de base.

Configuration

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

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

logs_enabled: true

• 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

Événements

Pi-hole n’inclut aucun événement.

Checks de service

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.