📋 ログ
この画面でできること
Section titled “この画面でできること”ログ画面では、Pi-holeが処理した個々のDNSクエリを確認できます。主に次の操作を行います。
- ドメイン、時刻、クライアントから特定のクエリを探す
- リクエストが許可されたかブロックされたか確認する
- ログ項目から直接、ドメインをホワイトリストまたはブラックリストへ追加する
アプリやWebサイトが動作しない、予期しないブロックが起きるといった問題を調べるための中心的な画面です。
目的に合わせて表示を絞り込む
Section titled “目的に合わせて表示を絞り込む”ログはすぐに増えるため、通常はまず一覧を絞り込みます。画面上部には検索、フィルター、並べ替え、ライブ更新の操作があります。これらは組み合わせて使えますが、すべてを同時に使う必要はありません。
リアルタイムで通信を監視する
Section titled “リアルタイムで通信を監視する”ライブモードでは、DNSクエリを発生した時点で確認できます。問題を再現し、どのドメインが問い合わせられているかをリアルタイムで確認したい場合に使います。
左：ライブモードがオン：新しいログ項目が自動で追加され、画面タイトルの下に ● LIVE が表示されます。右側の一時停止アイコンをタップすると更新を止められます。
中央：ライブモードがオフ（一時停止）：更新は停止しています。右側の再開アイコンをタップすると、リアルタイム監視に戻ります。既定ではライブログは有効ですが、実際のライブ更新は再開をタップするまで一時停止した状態で始まります。
右：ライブモードが無効：アプリ設定でライブモードを無効にしています。この場合、右側には手動更新ボタンが表示されます。タップすると連続更新を有効にせず、最新のログを一度だけ取得します。
ライブモードは、設定 → アプリ設定 → 高度な設定 → ライブログ から再び有効にできます。
ドメインまたはキーワードを検索する
Section titled “ドメインまたはキーワードを検索する”検索アイコンをタップすると検索欄が開きます。入力を始めるとすぐに、ログ一覧が一致する項目に絞り込まれます。
ドメイン名の一部がわかっている場合に使用します。検索を終了して一覧全体に戻るには、戻る矢印を使用します。サーバーが切断されている場合、結果が不完全になることがあるため検索は避けてください。
時刻、ステータス、クライアントでログを絞り込む
Section titled “時刻、ステータス、クライアントでログを絞り込む”フィルターアイコンをタップすると、フィルターシートが開きます。特定の状況を確認するための最も強力な方法です。
時間範囲を指定する
Section titled “時間範囲を指定する”開始と終了を使用して時間範囲を選択します。
最近の問題を調べる場合は短い範囲を選びます。範囲が広すぎると、関連する項目を見つけにくくなります。
クエリのステータスで絞り込む
Section titled “クエリのステータスで絞り込む”ブロック済みや許可済みなど、1つ以上のステータスを選択します。
読み込めない原因を調べる場合はブロック済みを使用します。見やすさを保つため、選択するステータスは必要なものに絞ってください。
特定のクライアントに絞り込む
Section titled “特定のクライアントに絞り込む”クライアントを選択すると、1台の端末からのクエリだけを表示できます。
ネットワーク内の特定端末だけ挙動が異なる場合に便利です。ネットワーク全体を確認したい場合は、クライアントによる絞り込みは行わないでください。
ログの並び順を変更する
Section titled “ログの並び順を変更する”並べ替えアイコンをタップすると、新しい順と古い順を切り替えられます。
進行中の通信を確認する場合は新しい順、過去のイベントを順番に確認する場合は古い順を使用します。変更はすぐに一覧へ反映されます。
ログ項目を確認して操作する
Section titled “ログ項目を確認して操作する”目的の項目を見つけたら、タップして詳細画面を開きます。詳細画面には、ドメイン、クライアント、時刻、クエリのステータスと、実行できる操作が表示されます。
ドメインをホワイトリストへ追加する
Section titled “ドメインをホワイトリストへ追加する”ブロックによって正当なWebサイトやアプリが動作しない場合は、ホワイトリストに追加を使用します。ドメインがPi-holeのホワイトリスト（許可リスト）へ追加され、以後のクエリが許可されます。
ドメインをブラックリストへ追加する
Section titled “ドメインをブラックリストへ追加する”不要なドメインだと確信できる場合は、ブラックリストに追加を使用します。
ドメインをブラックリスト（拒否リスト）へ追加すると、以後のクエリはこのルールに従ってブロックされます。
ログのよくある使い方
Section titled “ログのよくある使い方”- Webサイトが読み込めない：ログを開き、ブロック済みで絞り込み、必要に応じてドメインをホワイトリストへ追加します。
- 特定の端末だけ挙動がおかしい：クライアントで絞り込み、その端末の最近のクエリを確認します。
- リアルタイムのトラブルシューティング：ライブモードを有効にし、問題を再現してクエリの表示を確認します。
注意点と制限
Section titled “注意点と制限”- ログはPi-holeのプライバシー設定によって制限または匿名化される場合があります。
- 大量のデータに複雑なフィルターを適用すると時間がかかる場合があります。
- ホワイトリスト・ブラックリストへの追加は、現在選択しているサーバーだけに適用されます。
この画面で使われるPi-holeの用語
Section titled “この画面で使われるPi-holeの用語”各ログ項目は、Pi-holeが処理したDNSクエリです。ステータスはクエリが許可されたかブロックされたかを示します。ドメインをホワイトリスト・ブラックリストへ追加すると、Pi-holeのリストが更新され、以後のクエリにすぐ反映されます。