Pi-hole

Supported OS Mac OS Windows

통합 버전3.14.1

개요

이 점검은 Datadog 에이전트를 통해 Pi-hole을 모니터링합니다.

설정

Pi-hole 점검은 Datadog 에이전트 패키지에 포함되어 있지 않으므로 설치해야 합니다.

설치

에이전트 v7.21+ / v6.21+의 경우, 아래 지침에 따라 호스트에 파이홀 점검을 설치하세요. 도커(Docker) 에이전트 또는 이전 버전의 에이전트 과 함께 설치하려면 커뮤니티 통합을 참조하세요.

  1. 다음 명령어를 실행해 에이전트 통합을 설치하세요.

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

  2. 통합을 코어 통합과 유사하게 설정하세요.

구성

  1. 에이전트 설정 디렉토리 루트의 conf.d/ 폴더에 있는 pihole.d/conf.yaml 파일을 편집하여 Pi-hole 성능 데이터 수집을 시작합니다. 사용 가능한 모든 설정 옵션은 샘플 pihole.d/conf.yaml을 참조하세요.

  2. Agent를 재시작합니다.

검증

에이전트 상태 하위 명령을 실행하고 점검 섹션에서 pihole을 찾습니다.

로그 수집

Linux 플랫폼의 경우 /etc/datadog-agent/datadog.yaml에서 Datadog 에이전트에 대해 로그 수집을 활성화합니다. 다른 플랫폼에서는 설정 파일의 위치에 대한 에이전트 설정 파일 가이드를 참조하세요.

logs_enabled: true
  • pihole.d/conf.yaml 파일에 이 설정 블록을 활성화하여 로그 수집을 시작하세요.
    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에는 이벤트가 포함되어 있지 않습니다.

서비스 점검

pihole.running
Returns CRITICAL if the check can’t access pihole, OK otherwise.
Statuses: ok, critical

트러블슈팅

도움이 필요하신가요? Datadog 고객 지원팀에 문의하세요.