・Workerのエラーの原因を本番で調べたい人
・console.logがどこに出るか知りたい人
・12月からのログの料金が気になる人
Workers Observability は、Cloudflare Workers のコードが本番でどう動いたかを、ログ・トレース・メトリクスで確かめる機能のまとまりです。新しく作る Worker はログの記録が最初から有効で、ダッシュボードでは全 Worker のログを1か所で調べられます。
この記事では、3つのデータの違い、ログとトレースの見方、12月1日に切り替わる料金、始め方と注意点を整理します。サイトの訪問者を数えるアクセス解析は扱いません。
この記事のゴール(読了目安 約8分)
ログ・トレース・メトリクスの違いと料金を知り、自分のWorkerで記録を有効にできるようになる
Workers Observabilityとは
Workers Observability は、Worker が本番で何をして、どこで時間を使い、どれだけ失敗したかを見るための道具の集まりです。Cloudflare Workers は Cloudflare の世界中のネットワークの上でアプリを動かすサーバーレスの基盤で、2026年11月時点の公式ページでは無料プランで1日 100,000 リクエストまで使えます。Workers の仕組みと始め方は、Cloudflare Workers の記事で解説しています。
公式の概要ページでは、主に次のものが案内されています。
- ログ・トレース・メトリクス:本番の動きを記録したデータ
- Issues:本番の失敗をまとめて1件にする機能
- Query Builder:保存したログを絞り込み、集計する機能
コードの動きを見るのが Workers Observability、訪問者が体験した表示の速さを知るのが Web Analytics です。 後者は Cloudflare Web Analyticsとは?無料で測れることと始め方 で解説しています。
ログ・トレース・メトリクスの違い
3つは答える問いが違い、さかのぼれる期間にも差があります。
ログを調べる道具として、次の2つも用意されています。
- Query Builder:保存されたログを条件で絞り込み、件数・平均・P99 などで集計してグラフにします。有効にする操作は要りません
- Issues:例外や 5xx の応答など本番の失敗を記録し、似たものを1つにまとめます。オープンベータの間は無料です
編集部としては、まずメトリクスで異常に気づき、ログで中身を読み、遅さはトレースで探す順番をおすすめします。

ログの見方:保存と即時表示
後から探すなら Workers Logs、デプロイの直後にその場で見るなら wrangler tail(Real-time logs)を使います。
Workers Logs:残して後から探す
Worker が1回呼ばれるごとに呼び出しのログが1件残り、コードの console.log もすべて入ります。呼び出しのログには、CPU 時間と経過時間(待ち時間を含めた時間)も含まれます。
ログは JSON の形(キーと値)で出すと、user_id などのキーで絞り込めます。
console.log("user_id: " + 123); // 文字列に埋め込むと全文検索になる
console.log({ user_id: 123 }); // キーと値なら user_id で絞り込める
2026年2月の更新で、JSON・CSV での書き出しと、特定のログを開く共有用の URL も使えるようになりました。
wrangler tail:今の動きを見る
Real-time logs は、世界中で起きたログをほぼ即時に流して見る機能です。手元では、プロジェクトのフォルダで次のコマンドを実行します。
npx wrangler tail
流れを見るだけなので、後から探したいログは Workers Logs に残します。

トレースで遅い処理を探す
トレースは、1件のリクエストの中でどの呼び出しにどれだけ時間がかかったかを、区間(スパン)ごとに残す記録です。有効にすれば、コードを変えなくても次のものが自動で記録されます。
- 外への
fetch(サブリクエスト) - KV・R2・Durable Objects などのバインディングの呼び出し
- Worker と Durable Objects の間の RPC
- fetch・scheduled・queue などのハンドラー
KV の読み書きが遅いかどうかも、区間の長さで分かります。KV そのものは、Workers KVとは?Cloudflareのキー・バリュー保存の仕組みと料金で説明しています。
設定には observability.traces.enabled = true を書きます。observability.enabled = true だけでは、トレースは記録されません。 2026年11月時点の公式ページでは、ベータ版の扱いです。
業界標準の OpenTelemetry に沿うので、外部のツールにも送れます。保存は7日です。間引きの率はログと別に決められ、記録しないリクエストにはトレースの処理の負担がかかりません。

料金と無料枠:12月に変わる
2026年11月時点の公式ページでは、11月30日まではログの件数で、12月1日からは取り込んだ量と保存した量(GB)で料金を数えます。
11月30日までの料金
公式の試算では、月1,500万リクエストで、1リクエストにつきログを2件残すと月6.00ドルです。
12月1日からの料金
GB-月は、1GB を30日保つと 1GB-月と数える単位です。公式の試算では、月75GB を取り込むと追加は7.00ドルです。Free は1日の上限に達すると、UTC の0時(日本時間の朝9時)まで新しいデータを取り込みません。Paid は超えた分を課金して取り込みを続けます。
この枠は、Workers のログ・トレース・Issues に AI Gateway のログなども含めて、アカウントで1つを共有します。AI Gateway のログの扱いは、Cloudflare AI Gatewayとは?AI APIの記録・節約・制限の料金の章で整理しています。
ダッシュボードでの検索や分析に、追加の料金はかかりません。費用を抑えるには、次の方法があります。
head_sampling_rateで記録する割合を下げる(0.01 なら100件に1件)invocation_logs = falseで呼び出しのログを止める- 外部へ送るだけなら
persist: falseにして Cloudflare に残さない
12月からは量で数えるので、ログに大きなデータを出しすぎないようにします。 細かい条件は公式の料金ページで確かめてください。
始め方と外部ツールへの送り方
新しい Worker ならログは最初から有効です。トレースも見るなら設定を足してデプロイし直します。
- Wrangler の設定ファイルに
observabilityを書く(無い Worker だけ) - トレースも見るなら
tracesを足し、必要なら間引きの率を決める npx wrangler deployでデプロイし直す- ダッシュボードで Worker を選び、Observability でログとトレースを見る
ログを60%、トレースを5%だけ記録する設定の例です。Workers Logs には Wrangler 3.78.6 以上が必要です。
{
"observability": {
"logs": {
"enabled": true,
"head_sampling_rate": 0.6
},
"traces": {
"enabled": true,
"head_sampling_rate": 0.05
}
}
}
外部のツールへ送るとき
方法は3つあり、公式は OpenTelemetry export を勧めています。
OpenTelemetry export でも、Cloudflare に残す既定の設定(persist: true)のままだと、12月1日からはその分も利用量に数えられます。
使う前の注意点
特につまずきやすいのは、ログが残っていない、取り込みが止まる、トレースが見えない、の3つです。
- 設定に
observabilityの無い Worker は、書き足してデプロイし直すまでログが残りません - トレースは
traces.enabledを書くまで記録されません - 1リクエストのログは 256KB までで、超えた分は記録されません
- 保存は最長7日です。長く残したいログは外部へ送ります
- 12月からの Free は、1日 0.5GB を超えると日本時間の朝9時まで取り込みが止まります
- エラーを元のコードの行で見るには、Wrangler 4.150.0 以上でデプロイします(ソースマップが既定で送られます)
- WAF などで止めたリクエストは、メトリクスに数えません
よくある質問
Web Analyticsとは何が違いますか?
Web Analytics は、訪れた人が体験したページの速さなどを知るためのアクセス解析です。Workers Observability は Worker のコードの動きを見るもので、対象が違う別の機能です。
前からあるWorkerもログは残っていますか?
設定に observability が無い Worker は、書き足してデプロイし直すまで保存されません。新しく作る Worker は最初から有効です。Issues も、有効にしたあとの失敗だけが対象です。
ログは何日前まで見られますか?
2026年11月時点の公式ページでは、11月30日までは Workers Free が3日、Workers Paid が7日です。12月1日からは既定で7日になります。メトリクスは過去3か月までさかのぼれます。
Tail WorkersやLogpushは無料で使えますか?
どちらも Workers の有料プランの機能です。外部の監視ツールへ送るだけなら、公式は OpenTelemetry export を勧めています。
申し込み数など独自の数字も記録できますか?
アプリ独自の数字は、Workers Analytics Engine という別の機能で記録します。OpenTelemetry export では、独自のメトリクスは送れません。
この記事のポイント
- ログ・トレース・メトリクスでWorkerの本番の動きを確かめる機能群
- 新しいWorkerはログが既定で有効。トレースは別に設定し、今はベータ
- 12月から料金は件数でなく量で計算。Freeの枠は1日0.5GBまで
- 外部へ送るならOpenTelemetry exportが推奨。保存は既定で7日
まとめ
Workers Observability は、ログ(何が起きたか)・トレース(どこが遅いか)・メトリクス(全体の推移)で、Worker の本番の動きを確かめる機能のまとまりです。新しい Worker ではログが最初から有効で、トレースはベータ版として設定で足します。
料金は2026年12月1日に件数から量へ切り替わり、Free の枠は1日 0.5GB です。まず自分の Worker の設定に observability があるかを確かめ、Observability のタブで1件のログを開いてみてください。






