概要
このチェックは、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 コンフィギュレーションファイルガイドを参照し、コンフィギュレーションファイルの場所を調べてください。
- ログの収集を開始するには、次のコンフィギュレーションブロックを
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 のサポートチームまでお問合せください。
