Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

診断ログ

最終更新 Markdown で表示Agent セットアップ

Cloudflare One Client（旧 WARP）は、デバイス上の接続問題を切り分けるための診断ログを提供します。

チャプター

macOS/Windows/Linux

CLI でログを収集する

デスクトップデバイスでクライアントログを確認するには:

  1. ターミナルを開きます。
  2. warp-diag ツールを実行します。 
    warp-diag

デスクトップに warp-debugging-info-<date>-<time>.zip が作成されます。

  1. コマンドプロンプトまたは PowerShell を開きます。
  2. warp-diag ツールを実行します。 
    C:\Users\JohnDoe>warp-diag

デスクトップに warp-debugging-info-<date>-<time>.zip が作成されます。

  1. ターミナルを開きます。
  2. warp-diag ツールを実行します。 
    warp-diag

コマンドを実行した同じフォルダーに warp-debugging-info-<date>-<time>.zip が作成されます。

ダッシュボードでログを収集する

機能の利用可否

クライアントモード Zero Trust プラン ↗
  • Traffic and DNS モード
  • Traffic only モード
すべてのプラン
システム 利用可否 最小クライアントバージョン
Windows ✅ 2024.12.492.0
macOS ✅ 2024.12.492.0
Linux ✅ 2024.12.492.0
iOS ❌
Android ❌
ChromeOS ❌

Zero Trust ダッシュボードから、Digital Experience Monitoring（DEX）の リモートキャプチャ を使って、クライアントの診断ログをリモート収集できます。

リモートキャプチャを実行するには、デバイスが Internet に接続している必要があります。

リモートデバイスからデータをキャプチャする手順は次のとおりです。

  1. Cloudflare One ↗ で、DEX > Remote captures を開きます。
  2. キャプチャを実行するデバイスを最大 10 台選びます。デバイスは、Zero Trust 組織に 登録 されている必要があります。
  3. 実行するキャプチャの種類を設定します。
    • Packet captures (PCAP): WARP トンネル外のトラフィック（デフォルトのネットワークインターフェース）と、WARP トンネル内のトラフィック（仮想インターフェース）のパケットキャプチャを実行します。
    • Device diagnostic logs: 過去 96 時間の Cloudflare One Client 診断ログ を生成します。Split Tunnel の設定 にあるすべての IP とドメインのルーティングテストを含めるには、Test all routes を選びます。
  4. Run diagnostics を選びます。

DEX は、設定したデバイスへキャプチャリクエストを送ります。Cloudflare One Client が切断されている場合、キャプチャは 10 分後にタイムアウトします。

リモートキャプチャをダウンロードする

  1. Cloudflare One ↗ で、DEX > Remote captures を開きます。
  2. 成功したキャプチャを探します。
  3. 三点リーダーを選び、Download を選びます。

<capture-id>.zip という ZIP ファイルがローカルマシンにダウンロードされます。DEX は、ログ保持ポリシー に従ってキャプチャデータを保存します。

診断アナライザー（ベータ）

診断アナライザーは、warp-diag ログのなかで Cloudflare が特に重要と判断した検出イベントを強調します。検出レポートを使い、ログファイル を解析して、クライアント問題の根本原因を特定できます。診断アナライザーは、ダッシュボードから収集した ログでのみ利用できます。

診断アナライザーを開くには:

  1. Cloudflare One ↗ で DEX > Remote captures を開きます。

  2. 一覧から既存の warp-diag ログを探すか、Run diagnostics を選択して新しい warp-diag ログを生成します。

  3. 分析する warp-diag ログの三点リーダーを選択し、View Device Diag を選択します。

    Overview タブには、結果の AI 生成サマリー、検出イベントの一覧、基本的なデバイス情報が表示されます。

    各フィールドの説明

    フィールド 説明
    Detection type 診断ログに現れる、一般的な Cloudflare One Client の問題です。
    Occurrences ログ内で問題が検出された回数です。
    Severity level Cloudflare One Client の機能への影響を示します。重大度は次のとおりです。
    • Critical: 機能が完全に失われます。
    • Warning: 機能が低下しますが、主要機能は動作するはずです。
    • No detection: ログで問題は検出されませんでした。
    Operating system デバイスの OS と OS バージョンです。
    Cloudflare One Client version Cloudflare One Client のリリースバージョン
    Profile ID デバイスプロファイル の UUID です。
    Service mode クライアントモード
    Configuration name Cloudflare One Client が接続している Zero Trust 組織 の名前です。
    Device ID Cloudflare One Client が生成する ID です。

  4. 検出タイプを選択すると、イベントの詳細と推奨される次の手順を確認できます。

Cloudflare DEX は、ログ保持ポリシー に従って warp-diag ログと検出レポートを保存します。ローカルにコピーを保存するには、ログファイルをダウンロード し、JSON file タブでレポートを JSON 形式でコピーします。

warp-diag ログ

warp-debugging-info-<date>-<time>.zip アーカイブには、次のファイルが含まれます。

ファイル名 説明
.qlog MASQUE 接続の問題を調査するための QLog ファイルです。
.pcap warp-cli debug pcap コマンドで手動生成したパケットキャプチャ（PCAP）ファイル、または 追加デバッグログ で自動生成されたファイルです。
.etl 追加デバッグログ が生成する Windows 専用のトレースファイルです。パケットキャプチャ、netsh TCPIP トレース、Windows Filtering Platform（WFP）キャプチャを含みます。
.xml 追加デバッグログ が生成する Windows 専用の WFP トレースファイルです。
alternate-networks-check.txt 各 管理対象ネットワーク の接続状態です。
boringtun.log デバイスから Cloudflare のグローバルネットワークへトラフィックを送る WARP トンネルのログです。
bound-dns-ports.txt ポート 53 上のアクティブなプロセスです。
captive-portal-hotspot-detect.txt captive.apple.com の HTTP 応答です。
connectivity.txt 接続の成功を検証する ための DNS 解決と HTTP トレースリクエストです。トラフィックが WARP トンネル経由かどうかを判断できます。
*-checks-*.txt 追加デバッグログ を初めて有効にしたときに実行される、ワンショットの接続チェックです。内容は connectivity.txt と同じです。
daemon_dns.log Cloudflare One Client で Log DNS queries が有効な場合の、詳細な DNS ログです。
daemon.log Cloudflare One Client が実行したすべての操作の詳細ログです。デバイスと Cloudflare のグローバルネットワーク間の通信をすべて含みます。注: これが最も有用なデバッグログです。
date.txt warp-diag コマンドを実行した日時（UTC）です。
dex.log DEX テスト の実行に関するログです。
dhcp-lease-plists.txt DHCP リースがある各インターフェースについて、/var/db/dhcpclient/leases/ から取得した DHCP リース情報です。
dhcp-lease.txt ipconfig（macOS）または nmcli（Linux）から取得した DHCP リース情報です。
dig.txt cloudflare.com と apple.com の DNS ルックアップ結果です。
dns_stats.log Cloudflare One Client が受信して解決した DNS 問い合わせの統計です。2 分ごとに生成されます。
dns-check.txt Cloudflare One Client の DNS サーバーがシステムのデフォルトになっていることを確認します。動作モード で DNS フィルタリングが有効な場合、このファイルにはローカル DNS プロキシの IP（127.0.2.2:0、127.0.2.3:0、[fd01:db8:1111::2]:0、[fd01:db8:1111::3]:0）が含まれます。
dynamic.log Cloudflare Support 用に予約されています。
etc-hosts.txt デバイスの静的 DNS 設定です。
firewall-pfctl-all.txt Packet Filter（pf）ファイアウォールの設定です（macOS のみ）。
firewall-rules.txt Cloudflare One Client が設定した システムファイアウォールルール です。
gui-launcher.log アプリケーション起動を示す macOS コンソールログです。
gui-log.log ユーザーが操作する GUI アプリのログファイルです。
hostname.txt デバイス名です。
ifconfig.txt
ipconfig.txt		 各ネットワークインターフェースの IP 設定です。
installed_applications.txt インストール済みアプリケーションの一覧です。
installed_cert.pem システムにインストールされている ルート証明書 です。
installer.log
msi-installer.log		 MSI または PKG のインストールログです。
InstallHistory.plist
macos_installer.log		 macOS のソフトウェアインストールログです。
ipc.log GUI とデーモン間の IPC 通信のログです。GUI がクラッシュした場合や、デーモンと通信できない場合に役立ちます。
kernel-modules.txt 読み込まれているカーネルモジュール（macOS と Linux）またはドライバー（Windows）の一覧です。
launchd-dumpstate.txt macOS の launchd system の現在の状態です。読み込まれているジョブ、その状態、依存関係を含みます。
local_policy.redacted.txt
mdm.plist
mdm.xml		 デバイス上の 管理対象導入パラメーター です。
lsb-release.txt lsb_release コマンドの出力です（Linux のみ）。
netstat.txt
routetable.txt		 デバイスが使うルーティングテーブルです。
netstat-v6.txt IPv6 ルーティングテーブルです（Linux のみ）。
platform.txt デバイスのオペレーティングシステムです。
ps.txt
processes.txt		 warp-diag 実行時にデバイス上で動作していたすべてのプロセスの一覧です。
resolv.conf Mac / Linux の /etc/resolv.conf の内容です。システムの DNS サーバーを設定するファイルです。
route.txt ip route get コマンドの出力です。ネットワークトラフィックが正しいインターフェース経由であることを確認するために使います。任意で warp-diag --enable-all-routes フラグを使い、Split Tunnel 設定内のすべての IP とドメインのテストを含められます。
route-change.log IP ルーティングテーブルの変更です。
scutil-dns.txt macOS / Linux の DNS 設定です（Windows では ipconfig.txt にあります）。
scutil-networkinfo.txt macOS の IPv4 および IPv6 ネットワークインターフェース設定です（Windows では interfaces-config.txt にあります）。
scutil-proxy.txt macOS / Linux のプロキシ設定です（Windows では ipconfig.txt にあります）。
snapshots-collection.log snapshots/*.log の収集時に生成されるログです。Cloudflare One Client がスナップショットを収集できなかった理由の調査に使います。
snapshots/*.log エラー発生時に生成される診断情報です。
stats.log WARP トンネルの稼働時間とスループットの統計です。2 分ごとに生成されます。
sw-vers.txt デバイスのオペレーティングシステムです。
sysinfo.json warp-diag 実行時の CPU とメモリの使用状況です。速度低下がシステム負荷によるものかを判断するのに役立ちます。
system-extension-diagnostics.txt 読み込まれているシステム拡張の状態と健全性です（macOS のみ）。
systeminfo.txt
system-profile.txt		 システムソフトウェアの概要です。
System.evtx Windows のシステムイベントログです。
taskdump.log デーモンがハングした場合、このファイルには実行中プロセスのダンプが含まれます。ハング、デッドロック、タスクの調査に役立ちます。
timezone.txt デバイスのローカルタイムゾーンです。UTC オフセットで示します。
traceroute.txt WARP の ingress IP へのトレースルートです。デバイスから Cloudflare のグローバルネットワークまでの経路を示します。
*-traceroute-*.txt トンネルエッジ接続 IP、Device API エンドポイントのホスト名と IP、DNS リゾルバーのホスト名と IP へのワンショットトレースルートです。追加デバッグログ を初めて有効にしたときに開始されます。
uname.txt カーネルバージョンを含む、Linux 専用のシステム情報です。
updater/ クライアントバージョン割り当て の、試行ごとのインストーラーログとダウンロードしたパッケージのメタデータを含むディレクトリです。Cloudflare ダッシュボードから起動した更新の失敗を切り分けるのに役立ちます。
v4interfaces.txt
v4subinterfaces.txt
v6interfaces.txt
v6subinterfaces.txt		 Windows の IPv4 および IPv6 ネットワーク設定です。
version.txt デバイスにインストールされている Cloudflare One Client のバージョン です。
warp-account.txt Cloudflare One Client のデバイス登録情報です。
warp-bus-metrics.txt Cloudflare One Client が使う内部メッセージバスフレームワークのメトリクスです。
warp-device-posture.txt 現在の デバイスポスチャ の状態です。
warp-dex-data.txt 現在設定されている DEX テスト と、直近の状態です。
warp-dns-fallbacks.txt WARP DNS プロキシが使うデフォルトの DNS フォールバックの一覧です。
warp-dns-lock.json デフォルトの DNS プロバイダーとネットワークインターフェース情報です。
warp-dns-stats.txt dns-stats.log が生成されてからの、デバイス上の最近の DNS 問い合わせの要約です。
warp-network.txt Cloudflare One Client が検出した、デバイス上のネットワーク設定です。
warp-settings.txt デバイスに適用されている Cloudflare One Client の設定 です。
warp-stats.txt stats.log が生成されてからの、WARP トンネルの稼働時間とスループットです。
warp-status.txt Cloudflare One Client の接続状態（Connected または Disconnected）です。
wdutil-info.txt Wi-Fi 診断です（macOS のみ）。
xpc-launchd.log macOS の launchd プロセスの最新ログファイルです。

同じログの複数バージョン

warp-debugging-info フォルダーには、daemon.log、daemon.1.log、daemon.2.log のように、同じログの複数バージョンが含まれることがあります。ログは長くなることがあるため、日次、または一定サイズを超えたときにローテーションされます。

  • <logfile>.log が最新のログです。ほぼ常に、このログを確認してください。warp-diag コマンドを実行した当日のイベントが記録されています。
  • <logfile>.1.log は前日のイベントです。
  • <logfile>.2.log は 2 日前のイベントです。

追加デバッグログ

バージョン 2026.5.0 以降では、warp-cli debug extra start コマンドで追加デバッグログを有効にできます。 追加デバッグログは、warp-cli debug extra stop で手動停止しないかぎり、10 分後にタイムアウトします。

次のログ機能が追加で有効になります。

  • すべてのインターフェースでのパケットキャプチャ（PCAP）（Windows では元の .etl ファイルが残ります。他の PCAP コマンドは、削除前に .pcap へ変換します）
  • MASQUE トンネル接続の QLog ファイル
  • DNS フィルタリングありのサービスモード の DNS ログ
  • ワンショットの接続チェック（connectivity.txt と同じ情報です。warp-diag 実行時ではなく、追加デバッグログ開始時に収集します）
  • 次の宛先へのワンショットトレースルート:
    • DNS リゾルバーの IP
    • DNS リゾルバーのホスト名
    • Device API エンドポイントの IP
    • Device API エンドポイントのホスト名
    • トンネルエッジ接続の IP
  • Windows で管理者の場合:

追加デバッグログが有効なとき、warp-cli debug extra reconnect コマンドはトンネル接続を強制的に再起動します。 トンネル接続が失敗した場合のログ収集に役立ちます。

ログの保持期間

各クライアントログファイル（connection_stats.log、dns_stats.log、daemon.log、boringtun.log、daemon_dns.log、dex.log、captive-portal.log など）は、サイズと経過時間で制限されます。

  • 最大ファイルサイズ: 10 MB
  • 最大ファイル経過時間: 24 時間
  • ログあたりの保持バージョン数の上限: 4（例: daemon.log、daemon.1.log、daemon.2.log、daemon.3.log）

ログファイルには、warp-diag 実行時点から最大 96 時間（4 日）前までのデータが含まれることがあります。ただし、ログの活動が少ない場合に限ります。ログ量が多い環境（繰り返し発生するエラーなど）では、ローテーションが頻繁になり、取得できる期間は数時間程度まで短くなることがあります。

診断アーカイブがカバーする時間範囲は、各ログファイル末尾のタイムスタンプで必ず確認してください。

iOS/Android/ChromeOS

ログを収集する

モバイルデバイスでクライアントログを表示するには、次の手順に従います。

  1. Cloudflare One Agent アプリを開きます。
  2. Settings > Advanced > Diagnostics を開きます。
  3. 拡張ログを収集します。
    1. Diagnostics ページで、Console logs > Extension logs を選びます。
    2. Share を選び、ファイル共有方法を選びます。
    3. 共有方法で可能な場合は、わかりやすいファイル名（例: extension.log）を入力し、ファイルを共有または保存します。
  4. アプリケーションログを収集します。
    1. Diagnostics ページで、Console logs > Application logs を選びます。
    2. Share を選び、ファイル共有方法を選びます。
    3. 共有方法で可能な場合は、わかりやすいファイル名（例: application.log）を入力し、ファイルを共有または保存します。
  5. （任意）MASQUE トンネルプロトコル を使うデバイスでは、qlogs を収集します。
    1. Diagnostics ページで Enable qlogs をオンにします。
    2. Export QLogs を選びます。
    3. 共有方法で可能な場合は、わかりやすいファイル名（例: qlogs.zip）を入力し、ファイルを共有または保存します。
  1. Cloudflare One Agent アプリを開きます。
  2. Settings > Advanced > Diagnostics を開きます。
  3. Debug logs セクションまでスクロールします。
  4. （任意）MASQUE トンネルプロトコル を使うデバイスでは、Enable qlogs をオンにします。
  5. Download logs を選びます。
  6. warp-debugging-info-<date>-<time>.zip ファイルを、メール、Google Drive、またはインストール済みの別アプリで共有します。

モバイルアプリのログ

iOS、Android、ChromeOS デバイスでは、次のログファイルを利用できます。

iOS

名前 説明
Extension logs コア VPN トンネルサービスのログです。接続状態の変化と、デバイスと Cloudflare ネットワーク間のパケットフロー操作を含みます。デスクトップの daemon.log に相当します。
Application logs iOS アプリプロセスのログです。GUI イベント、設定変更、API 呼び出しを含みます。
Qlogs MASQUE / HTTP3 トンネル接続の調査に使う QUIC プロトコルイベントログです。アーカイブには、接続 ID で名前が付いた最大 10 個の .sqlog ファイルが含まれます。

Android / ChromeOS

warp-debugging-info-<date>-<time>.zip アーカイブには、次のファイルが含まれます。

名前 説明
unhandled_exception.log Android アプリケーション層で捕捉されず、アプリをクラッシュさせた可能性のあるエラーです。
console.log Android アプリケーション層のログです。VPN サービスイベント、API 呼び出し、失敗した DNS 問い合わせ、GUI 操作、設定変更を含みます。
native_tunnel.log コア VPN トンネルサービスのログです。接続状態の変化と、デバイスと Cloudflare ネットワーク間のパケットフロー操作を含みます。デスクトップの daemon.log に相当します。
<connection_id>.sqlog MASQUE / HTTP3 トンネル接続の調査に使う QUIC プロトコルイベントログです。

役に立ちましたか？