Supported OS
![Linux]()
![Mac OS]()
개요
이 점검은 Datadog 에이전트를 통해 Pi-hole을 모니터링합니다.
설정
Pi-hole 점검은 Datadog 에이전트 패키지에 포함되어 있지 않으므로 설치해야 합니다.
설치
에이전트 v7.21+ / v6.21+의 경우, 아래 지침에 따라 호스트에 파이홀 점검을 설치하세요. 도커(Docker) 에이전트 또는 이전 버전의 에이전트 과 함께 설치하려면 커뮤니티 통합을 참조하세요.
다음 명령어를 실행해 에이전트 통합을 설치하세요.
sudo -u dd-agent -- datadog-agent integration install -t datadog-pihole==<INTEGRATION_VERSION>
통합을 코어 통합과 유사하게 설정하세요.
설정
에이전트 설정 디렉토리 루트의 conf.d/ 폴더에 있는 pihole.d/conf.yaml 파일을 편집하여 Pi-hole 성능 데이터 수집을 시작합니다. 사용 가능한 모든 설정 옵션은 샘플 pihole.d/conf.yaml을 참조하세요.
에이전트를 재시작합니다.
검증
에이전트 상태 하위 명령을 실행하고 점검 섹션에서 pihole을 찾습니다.
로그 수집
Linux 플랫폼의 경우 /etc/datadog-agent/datadog.yaml에서 Datadog 에이전트에 대해 로그 수집을 활성화합니다. 다른 플랫폼에서는 설정 파일의 위치에 대한 에이전트 설정 파일 가이드를 참조하세요.
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 고객 지원팀에 문의하세요.
