ログ
トンネルログは、cloudflaredインスタンスとCloudflareのグローバルネットワーク間、およびcloudflaredとオリジンサーバー間のすべてのアクティビティを記録します。これらのログを使用して、Cloudflareトンネルの接続性やパフォーマンスの問題を調査できます。サーバーを構成して永続的なログを保存することも、任意のクライアントマシンからリアルタイムのログをストリーミングすることもできます。
オリジンサーバーにアクセスできる場合、トンネルを開始する際にログ記録を有効にできます：
cloudflared tunnel --loglevel debug run <UUID>--loglevelフラグは、ローカルのcloudflaredインスタンスのログレベルを示し、fatalのいずれかになります（デフォルト: info）。debugレベルでは、cloudflaredはリクエストURL、メソッド、プロトコル、コンテンツ長、およびすべてのリクエストとレスポンスヘッダーをログに記録し表示します。ただし、これによりログに機密情報が露出する可能性があることに注意してください。
デフォルトでは、cloudflaredはログをstdoutに出力し、サーバー上にログを保存しません。ログをファイルに保存するには、--logfileフラグを使用できます：
cloudflared tunnel --logfile mytunnel.log run <UUID>Cloudflareトンネルのリアルタイムログは、ダッシュボードまたはcloudflaredがインストールされている任意のマシンから表示できます。リモートログストリームを使用すると、トンネルを実行しているサーバーにSSHで接続する必要はありません。
- オリジンサーバーに
cloudflaredバージョン2023.5.1以上がインストールされている。 - トンネルがアクティブでリクエストを受け取れる状態である。
- Zero Trust ↗に移動し、Networks > Tunnelsを選択してトンネルを選びます。
- サイドバーで、表示したい
cloudflaredインスタンスのConnector IDを選択します。 - Begin log streamを選択します。
cloudflaredデーモンは、アカウント内の任意のトンネルからローカルコマンドラインにログをストリーミングできます。
- ローカルマシンとオリジンサーバーの両方に
cloudflaredバージョン2023.5.1以上がインストールされている。 - トンネルがアクティブでリクエストを受け取れる状態である。
-
ローカルマシンで、
cloudflaredをZero Trustアカウントに認証します：Terminal window cloudflared tunnel login -
特定のトンネルのために
cloudflared tailを実行します：Terminal window cloudflared tail <UUID>JSONメッセージのより構造化された表示のために、出力をjq ↗のようなツールにパイプすることができます：
Terminal window cloudflared tail --output=json <UUID> | jq .
イベントタイプ（--event）、イベントレベル（--level）、またはサンプリングレート（-sampling）でログをフィルタリングして、オリジンからストリーミングされるログの量を減らすことができます。これにより、オリジンへのパフォーマンスへの影響を軽減できます。特に、オリジンが通常高負荷の場合に役立ちます。例えば：
cloudflared tail --level debug <UUID>| フラグ | 説明 | 許可される値 | デフォルト値 |
|---|---|---|---|
--event | イベント/リクエストのタイプでフィルタリングします。 | cloudflared, http, tcp, udp | すべてのイベント |
--level | このレベル以上のログを返します。サーバーの--loglevel設定とは独立して動作します。 | debug, info, warn, error, fatal | debug |
--sampling | 総ログの一部をサンプリングします。 | 0.0から1.0の数値 | 1.0 |
同じトンネルのために複数のcloudflaredインスタンスを実行している場合（レプリカとも呼ばれる）、ログをストリーミングするために個々のインスタンスを指定する必要があります：
- Zero Trust ↗に移動し、Networks > Tunnelsを選択してトンネルを選びます。
- 表示したい
cloudflaredインスタンスのConnector IDを見つけます。 cloudflared tailでConnector IDを指定します：Terminal window cloudflared tail --connector-id <CONNECTOR ID> <UUID>
- ロギングセッションは1時間のみ保持されます。すべてのロギングシステムは一定のパフォーマンスオーバーヘッドを導入し、この制限はトンネルのエンドツーエンドのレイテンシーへの長期的な影響を防ぐのに役立ちます。
- 高スループットのトンネルのためにログをストリーミングする際、Cloudflareは意図的にサービスの安定性をログ配信よりも優先します。ドロップされたログの数を減らすために、より少ないログを要求することを試みてください。すべてのログを確認するには、リモートでログをストリーミングするのではなく、サーバー上のログを表示してください。