Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

リアルタイムログ

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

リアルタイムログを使うと、世界各地で発生したログイベントをほぼリアルタイムで確認できます。新しいデプロイの状態をすぐ把握したいときなどに役立ちます。

リアルタイムログは、呼び出しログ、カスタムログ、エラー、捕捉されていない例外を取り込みます。トラフィックが多いアプリケーションでは、リアルタイムログがサンプリングモードに入ることがあります。その場合、一部のメッセージは破棄され、ログに警告が表示されます。

ダッシュボードでログを表示する

デプロイ済みの任意の Worker に紐づくリアルタイムログを、Cloudflare ダッシュボードで表示します。

  1. Cloudflare ダッシュボードで、Workers & Pages ページを開きます。

    公式ダッシュボードで Workers & Pages を開く ↗
  2. Overview で、対象の Worker を選びます。

  3. Logs を選びます。

  4. 右側のナビゲーションで Live を選びます。

wrangler tail でログを表示する

デプロイ済みの任意の Worker に紐づくリアルタイムログを、Wrangler で表示します。

  1. Worker プロジェクトのディレクトリに移動します。
  2. npx wrangler tail を実行します。

ローカルのターミナルに、アプリケーションへの受信リクエストが出力されます。

各 wrangler tail ログの出力は、構造化された JSON オブジェクトです。

{
	"outcome": "ok",
	"scriptName": null,
	"exceptions": [],
	"logs": [],
	"eventTimestamp": 1590680082349,
	"event": {
		"request": {
			"url": "https://www.bytesized.xyz/",
			"method": "GET",
			"headers": {},
			"cf": {}
		}
	}
}

出力を jq ↗ などのツールにパイプすると、リクエストを検索・加工して、特定の情報を探せます。

npx wrangler tail | jq .event.request.url
"https://www.bytesized.xyz/"
"https://www.bytesized.xyz/component---src-pages-index-js-a77e385e3bde5b78dbf6.js"
"https://www.bytesized.xyz/page-data/app-data.json"

wrangler tail の動作は、用途に合わせてカスタマイズできます。利用できる設定オプションは wrangler tail のドキュメント を参照してください。

制限

  • リアルタイムログは Workers Logs を保存しません。ログを保存するには Workers Logs を使います。
  • Worker のトラフィックが多いと、リアルタイムログがサンプリングモードに入ることがあります。その場合、一部のメッセージは破棄され、ログに警告が表示されます。
  • Worker が使っている Durable Objects のログも、ダッシュボードに表示されます。
  • 1 つの Worker のログを同時に閲覧できるクライアントは最大 10 です。ダッシュボードのセッションと wrangler tail の呼び出しを合わせた数です。
  • wrangler tail を WebSocket イベントハンドラー と併用する場合、そのハンドラー内の console.log は、WebSocket クライアントが接続を閉じるまで表示されません。close を受信すると、すべてのメッセージが一気にフラッシュされ、ターミナルにまとめて出力されます。

ログを永続化する

ログの永続化、フィルター、分析には Workers Logs を使えます。サードパーティへログを送るには、Workers Logpush または Tail Workers を使います。

関連リソース

  • エラーと例外 — よくある Workers のエラーを確認できます。
  • ローカル開発 — Worker をローカルで開発し、テストできます。
  • Workers Logs — Cloudflare Workers が出力するログデータを収集、保存、フィルター、分析できます。
  • Logpush — Workers Trace Event Logs を対応先へプッシュする方法を確認できます。
  • Tail Workers — Tail Workers を接続してログを変換し、HTTP エンドポイントへ送る方法を確認できます。
  • ソースマップとスタックトレース — Worker でソースマップを有効にし、スタックトレースを生成する方法を確認できます。

役に立ちましたか?