サーバーWorkers料金・無料枠

Workers Observabilityとは?ログ・トレースの見方と料金

フレアはゆるフレアはゆる
こんな人におすすめ
・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つは答える問いが違い、さかのぼれる期間にも差があります。

データ答える問い中身の例さかのぼれる期間
ログ何が起きたか呼び出しのログ、console.log、エラー、例外最長7日
トレースどこで時間がかかったか外への fetch や KV の呼び出しの時間7日
メトリクス全体はどう推移したかリクエスト数、エラー、CPU 時間、メモリ使用量過去3か月

ログを調べる道具として、次の2つも用意されています。

  • Query Builder:保存されたログを条件で絞り込み、件数・平均・P99 などで集計してグラフにします。有効にする操作は要りません
  • Issues:例外や 5xx の応答など本番の失敗を記録し、似たものを1つにまとめます。オープンベータの間は無料です

編集部としては、まずメトリクスで異常に気づき、ログで中身を読み、遅さはトレースで探す順番をおすすめします。

Worker の本番の動きを見る3つのデータ。ログは何が起きたか、トレースはどこで時間がかかったか、メトリクスは件数とエラーの推移を示す
何が起きたかはログ、どこが遅いかはトレース、全体の推移はメトリクスで見ます。

ログの見方:保存と即時表示

後から探すなら 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 に残します。

項目Workers LogsReal-time logs
ログの保存する(最長7日)しない
向く場面後から原因を探す・集計するデプロイ直後の確認
主な制限1日1アカウント50億件まで多いと間引かれる・同時に10まで
左は wrangler tail で、今のログをその場で見るだけで保存されない。右は Workers Logs で、ログを保存して後から探せ、保存は最長7日
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日です。間引きの率はログと別に決められ、記録しないリクエストにはトレースの処理の負担がかかりません。

利用者のリクエストを Worker が受け、KV を読み書きして応答を返す。トレースは Worker から KV への呼び出しを1区間として、かかった時間とともに記録する
トレースは、Worker から KV などへの呼び出しを1区間ずつ、かかった時間とともに残します。

料金と無料枠:12月に変わる

2026年11月時点の公式ページでは、11月30日まではログの件数で、12月1日からは取り込んだ量と保存した量(GB)で料金を数えます。

11月30日までの料金

項目Workers FreeWorkers Paid
ログの記録1日 200,000 件月 2,000万件込み。超過は100万件ごとに0.60ドル
保存期間3日7日

公式の試算では、月1,500万リクエストで、1リクエストにつきログを2件残すと月6.00ドルです。

12月1日からの料金

項目FreePaid
取り込み1日 0.5GB請求期間あたり 50GB 込み。超過は1GBごとに0.25ドル
保存7日。保存量の課金なし請求期間あたり 10GB-月込み。超過は1GB-月ごとに0.10ドル

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 ならログは最初から有効です。トレースも見るなら設定を足してデプロイし直します。

  1. Wrangler の設定ファイルに observability を書く(無い Worker だけ)
  2. トレースも見るなら traces を足し、必要なら間引きの率を決める
  3. npx wrangler deploy でデプロイし直す
  4. ダッシュボードで 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ログとトレース使っている監視ツールへ送る送り先をダッシュボードで作る
Workers LogpushTrace Event LogsR2・S3 などに貯める有料プラン。月1,000万件込み、超過は100万件ごとに0.05ドル
Tail Workers状態・console.log・例外自分で加工して送る有料プランと Enterprise。CPU 時間で課金

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件のログを開いてみてください。

無料ダウンロード資料「Cloudflareが漫画でわかる」資料を受け取る

この記事を書いた人

フレアはゆる

編集長

フレアはゆるフレア ハユル

Cloudflare を知り尽くした(未来形)、フレアはゆるの編集長。Webサイト制作とサーバー運用の現場で Cloudflare を使い、迷ったところ・つまずいたところをそのまま記事にしています。

フレアはゆるについて詳しく見る →

サーバーの記事一覧へ戻る
フレアはゆるとははゆるに相談