cloudflared tunnel のログ出力オプション

cloudflared (Cloudflare Tunnel) には、サポート問い合わせ用途でログ出力オプションが用意されている。

How do I contact support?

ログ関連のオプション

• 公式ドキュメント
  • Tunnel run parameters · Cloudflare Zero Trust docs
• logfile とは別に log-directory オプションが利用できる
• 標準出力の抑止設定、ファイルサイズ指定などのオプションは現時点では用意されていない
  • [Feature Request] Add a logsize argument · Issue #518 · cloudflare/cloudflared

   --loglevel value                                    Application logging level {debug, info, warn, error, fatal}. At debug level cloudflared will log request URL, method, protocol, content length, as well as, all request and response headers. This can expose sensitive information in your logs. (default: "info") [$TUNNEL_LOGLEVEL]
   --transport-loglevel value, --proto-loglevel value  Transport logging level(previously called protocol logging level) {debug, info, warn, error, fatal} (default: "info") [$TUNNEL_PROTO_LOGLEVEL, $TUNNEL_TRANSPORT_LOGLEVEL]
   --logfile value                                     Save application log to this file for reporting issues. [$TUNNEL_LOGFILE]
   --log-directory value                               Save application log to this directory for reporting issues. [$TUNNEL_LOGDIRECTORY]

オプション指定による挙動の違い

Version 2024.5.0 で確認。

デフォルト(オプション未指定)

• 標準出力

tunnel --no-autoupdate --hello-world

--logfile

• 標準出力＋指定したログファイルに出力
• ログローテーションは 行われない

tunnel --no-autoupdate --hello-world --logfile /var/log/cloudflared/cloudflared.log

--log-directory

• 標準出力＋指定したディレクトリに cloudflared.log を出力
• ログローテーションが行われる
  • 1MiB 毎に以下のファイル名にローテーションされ、 5ファイル保持
  • cloudflared-YYYY-MM-DDTHH-MM-SS.sss.log

cloudflared tunnel --no-autoupdate --hello-world --log-directory /var/log/cloudflared

コード上定義箇所

# https://github.com/cloudflare/cloudflared/blob/master/logger/configuration.go#L40
	const RollingMaxSize = 1    // Mb
	const RollingMaxBackups = 5 // files
	const RollingMaxAge = 0     // Keep forever
	const defaultLogFilename = "cloudflared.log"