Pi-hole

Supported OS Linux Mac OS Windows

インテグレーションバージョン3.14.1

概要

このチェックは、Datadog Agent を通じて Pi-hole を監視します。

セットアップ

Pi-hole チェックは Datadog Agent パッケージに含まれていないため、お客様自身でインストールする必要があります。

インストール

Agent v7.21 / v6.21 以降の場合は、下記の手順に従い Pi-hole チェックをホストにインストールします。Docker Agent または上記バージョン以前の Agent でインストールする場合は、コミュニティインテグレーションの使用をご参照ください。

以下のコマンドを実行して、Agent インテグレーションをインストールします。
```
sudo -u dd-agent -- datadog-agent integration install -t datadog-pihole==<INTEGRATION_VERSION>
```
コアのインテグレーションと同様にインテグレーションを構成します。

構成

Pi-hole のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの pihole.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、pihole.d/conf.yaml のサンプルを参照してください。
Agent を再起動します。

検証

Agent の status サブコマンドを実行し、Checks セクションで pihole を探します。

ログ収集

Linux プラットフォームの場合は、/etc/datadog-agent/datadog.yaml で Datadog Agent のログ収集を有効にします。その他のプラットフォームの場合は、Agent コンフィギュレーションファイルガイドを参照し、コンフィギュレーションファイルの場所を調べてください。

logs_enabled: true

ログの収集を開始するには、次のコンフィギュレーションブロックを pihole.d/conf.yaml ファイルに対して有効化します。
```
logs:
  - type: file
    path: /var/log/pihole.log
    source: pihole
```

収集データ

メトリクス


pihole.queries.blocked (gauge)	Number of queries that were blocked (i.e. matched gravity block lists/regex/ denylist or upstream blocking).
pihole.queries.cached (gauge)	Number of queries answered from Pihole cache.
pihole.queries.clients.active (gauge)	Number of currently active clients (recent queries).
pihole.queries.clients.total (gauge)	Total number of clients observed.
pihole.queries.forwarded (gauge)	Number of queries forwarded to upstream DNS servers (i.e. allowed queries).
pihole.queries.frequency (gauge)	Query frequency or rate (e.g. queries per second).
pihole.queries.gravity.domains_being_blocked (gauge)	Number of domains currently blocked by the gravity blocklist.
pihole.queries.percent_blocked (gauge)	Percentage of total queries that were blocked.
pihole.queries.replies.BLOB (gauge)	Replies containing binary blob data.
pihole.queries.replies.CNAME (gauge)	Replies that return a CNAME (alias).
pihole.queries.replies.DOMAIN (gauge)	Replies with a domain name.
pihole.queries.replies.DNSSEC (gauge)	Replies indicating DNSSEC-specific status.
pihole.queries.replies.IP (gauge)	Replies that return an IP (A or AAAA record).
pihole.queries.replies.NODATA (gauge)	Replies that return ‘No Data’ (empty response).
pihole.queries.replies.NONE (gauge)	Replies dropped intentionally (no response).
pihole.queries.replies.NOTIMP (gauge)	Replies with ‘Not Implemented’ status.
pihole.queries.replies.NXDOMAIN (gauge)	Replies that return NXDOMAIN (non-existent domain).
pihole.queries.replies.OTHER (gauge)	Replies of types not otherwise classified.
pihole.queries.replies.REFUSED (gauge)	Replies with ‘Refused’ status.
pihole.queries.replies.RRNAME (gauge)	Replies that indicate the domain name in the query (RRNAME).
pihole.queries.replies.SERVFAIL (gauge)	Replies with ‘Server Failure’ status.
pihole.queries.replies.UNKNOWN (gauge)	Replies with unknown type (no reply yet).
pihole.queries.status.CACHE (gauge)	Queries answered from cache.
pihole.queries.status.CACHE_STALE (gauge)	Queries answered from a stale cached response.
pihole.queries.status.DBBUSY (gauge)	Queries blocked because the internal database was busy.
pihole.queries.status.DENYLIST (gauge)	Queries blocked by an exact denylist entry.
pihole.queries.status.DENYLIST_CNAME (gauge)	Queries blocked during deep CNAME inspection due to denylist.
pihole.queries.status.EXTERNAL_BLOCKED_EDE15 (gauge)	Queries blocked by upstream server with EDE code 15.
pihole.queries.status.EXTERNAL_BLOCKED_IP (gauge)	Queries blocked by upstream server via IP blocking.
pihole.queries.status.EXTERNAL_BLOCKED_NXRA (gauge)	Queries blocked when upstream returns NXDOMAIN with RA bit unset.
pihole.queries.status.EXTERNAL_BLOCKED_NULL (gauge)	Queries blocked due to upstream returning null (0.0.0.0 / ::) response.
pihole.queries.status.FORWARDED (gauge)	Queries allowed and forwarded to upstream resolver.
pihole.queries.status.GRAVITY (gauge)	Queries blocked by the gravity blocklist.
pihole.queries.status.GRAVITY_CNAME (gauge)	Queries blocked during deep CNAME inspection in gravity list.
pihole.queries.status.IN_PROGRESS (gauge)	Queries currently in progress (not yet resolved).
pihole.queries.status.REGEX (gauge)	Queries blocked by regex filters.
pihole.queries.status.REGEX_CNAME (gauge)	Queries blocked during deep CNAME inspection due to regex.
pihole.queries.status.RETRIED (gauge)	Queries that were retried (e.g. after failure).
pihole.queries.status.RETRIED_DNSSEC (gauge)	Queries retried during DNSSEC validation.
pihole.queries.status.SPECIAL_DOMAIN (gauge)	Queries about special domains (e.g. Apple Private Relay/ canary domains).
pihole.queries.status.UNKNOWN (gauge)	Queries whose status is ‘Unknown’ (not yet classified).
pihole.queries.total (gauge)	Total number of DNS queries received by Pihole (all types).
pihole.queries.types.A (gauge)	Count of DNS queries of type A (IPv4 address record).
pihole.queries.types.AAAA (gauge)	Count of DNS queries of type AAAA (IPv6 address record).
pihole.queries.types.ANY (gauge)	Count of DNS queries of type ANY (request for all record types).
pihole.queries.types.DNSKEY (gauge)	Count of DNS queries of type DNSKEY (DNSSEC public key).
pihole.queries.types.DS (gauge)	Count of DNS queries of type DS (delegation signer/ DNSSEC).
pihole.queries.types.HTTPS (gauge)	Count of DNS queries of type HTTPS (HTTPS service binding).
pihole.queries.types.MX (gauge)	Count of DNS queries of type MX (mail exchange record).
pihole.queries.types.NAPTR (gauge)	Count of DNS queries of type NAPTR (name authority pointer).
pihole.queries.types.NS (gauge)	Count of DNS queries of type NS (name server record).
pihole.queries.types.OTHER (gauge)	Count of queries of types not in the standard set.
pihole.queries.types.PTR (gauge)	Count of DNS queries of type PTR (pointer records/ typically reverse DNS).
pihole.queries.types.RRSIG (gauge)	Count of DNS queries of type RRSIG (DNSSEC signature record).
pihole.queries.types.SOA (gauge)	Count of DNS queries of type SOA (start of authority).
pihole.queries.types.SRV (gauge)	Count of DNS queries of type SRV (service locator record).
pihole.queries.types.SVCB (gauge)	Count of DNS queries of type SVCB (service binding).
pihole.queries.types.TXT (gauge)	Count of DNS queries of type TXT (text records).
pihole.queries.unique_domains (gauge)	Number of unique domain names queried in the measured period.
pihole.queries_forwarded (gauge)	Queries not blocked (legacy check only) Shown as query
pihole.domains_being_blocked (gauge)	Domains that are currently being blocked (legacy check only)
pihole.ads_percent_blocked (gauge)	Percentage of ads blocked today (legacy check only) Shown as percent
pihole.ads_blocked_today (gauge)	Number of ads blocked today (legacy check only)
pihole.dns_queries_today (gauge)	Amount of queries made to Pi-hole (legacy check only)
pihole.clients_ever_seen (gauge)	Total clients (legacy check only)
pihole.unique_clients (gauge)	Total number of unique clients (legacy check only)
pihole.queries_cached (gauge)	Number of cached queries (legacy check only) Shown as query
pihole.unique_domains (gauge)	Number of unique domains seen (legacy check only)
pihole.reply_nodata (gauge)	Number of no data replies (legacy check only)
pihole.reply_cname (gauge)	Number of cname replies (legacy check only)
pihole.reply_ip (gauge)	Number of ip replies (legacy check only)
pihole.reply_nxdomain (gauge)	Number of nxdomain replies (legacy check only)
pihole.dns_queries_all_types (gauge)	Amount of queries made to Pi-hole of all types (legacy check only)

イベント

Pi-hole には、イベントは含まれません。

サービスチェック

pihole.running

Returns CRITICAL if the check can’t access pihole, OK otherwise.

Statuses: ok, critical

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。