サーバーWorkersQueuesストレージ

Cloudflare K2とは?イベントを残して複数で読む仕組みと料金

フレアはゆるフレアはゆる
こんな人におすすめ
・大量のイベントを複数の仕組みで読みたい人
・QueuesとK2の違いが分からない人
・K2のベータ版の料金と上限を知りたい人

Cloudflare K2 は、Worker や HTTP で送ったイベントを保持期間(既定7日・最長30日)まで残し、複数の読み手がそれぞれのペースで読める耐久性のあるログです。2026年10月にパブリックベータとして公開され、Workers の有料プラン(Workers Paid)で使えます。ベータ中は K2 の利用料が請求されません。

この記事では、仕組み、Queues・Basin との使い分け、予定の料金とベータ版の上限、始め方、注意点を扱います。Kafka との細かい比較には踏み込みません。ベータ版のため、仕様と料金は変わることがあります。

この記事のゴール(読了目安 約8分)

K2の仕組みと提供条件を知り、QueuesやBasinではなくK2を選ぶ場面を判断できるようになる

K2とは?イベントを残すログ

K2 は、イベントを作る側と読む側の間に置き、書かれた記録を残しておく「耐久性のあるログ」です。

公式ブログによると、送る側が読む側を直接呼び出す作りでは、読む側が追いつかなかったり止まっていたりするとイベントが失われます。EC の取引完了のイベントを分析と不正検知の両方が読むように、読み手が複数だとさらに難しくなります。K2 は間で書き込みを受け止め、読み手が自分のペースで読めるようにします。

  • 2026年10月1日に、パブリックベータとして公開
  • Workers Paid なら申し込みなしで使え、無料プラン(Workers Free)では使えない
  • ベータ中は K2 の利用料を請求しない(Workers Paid の月5ドルの最低料金はかかる)

K2 は R2 の上に作られたサーバーレスの仕組みで、クラスターの管理は要りません。K2 の「ログ」は、アプリのイベントをためる入れ物です。 Worker の console.log などの実行ログを見る機能は、Workers Observability の解説記事で扱っています。

K2の仕組み:ストリームと購読

送る側はストリームに記録を追記し、読む側はサブスクリプション(購読)ごとに自分の位置を持って読みます。

用語役割
ストリーム記録をためる順序付きのログ。名前と保持期間を持つ
レコード中身のバイト列と任意のヘッダー。1件 約1MB まで
サブスクリプション読んだ位置を持つ読み口。earliest か latest から読む
リース5分間貸し出す記録のまとまり。ack で確定、nack か期限切れで再配信

従来のキューは、読むと項目が消えます。ログは読んでも記録が消えず、読み手の位置が進むだけです。 そのため、読む側が遅れても書き込みは止まらず、過去の記録を読み直せます。

送る側は記録をバッチで送り、バッチは全部保存か1件も保存しないかのどちらかです。読む側は /consume で最大 max_records 件を5分間借り、処理して ack を返します。5分を超えそうならリースを延長し、新しい記録が無ければ少し待ってから取りに行きます。

送る側は Worker や HTTP で K2 のストリームに記録を追記する。K2 は記録のまとまりを読む側に5分間貸し出し、読む側は ack を返して読んだ位置を進める
K2 は記録を保持期間まで残し、読む側はサブスクリプションごとに自分のペースで読みます。

K2でできること

公式が挙げる K2 の強みは「同じイベントを複数の仕組みで読める」「大量のイベントを動かせる」「後から読み直せる」の3つです。

読み方を2通りから選べる

1つのサブスクリプションを複数の読み手で分け合えば、記録を分担できます。同じ記録を同時に2つの読み手へ貸すことはありません。読み手ごとにサブスクリプションを作れば、全員が全件を受け取ります。2つは組み合わせられます。

同じストリームを、警告・保存・特徴量作りなど用途の違う読み手が別々に読めます。

左は1つのサブスクリプションを複数の読み手で分け合い、記録を分担して読む方法。右は読み手ごとにサブスクリプションを作り、全員が全件を読む方法
1つのサブスクリプションを分け合えば分担でき、読み手ごとに作れば全員が全件を読めます。

後から読み手を足せる

読み終えた記録も保持期間までは残るので、後から作ったサブスクリプションでも earliest から過去分を読めます。

Worker・HTTP・ブラウザから送れる

Worker からはバインディング(Worker にストリームをつなぐ設定)で、API トークンなしに送れます。ほかのサーバーからは HTTP、ブラウザからも CORS を設定すれば送れます(注意は「使う前の注意点」の章)。

QueuesやBasinとの使い分け

1件ずつ確実にこなす仕事は Queues、大量のイベントを複数の仕組みで読むなら K2、R2 のテーブルで SQL の分析をするなら Basin Pipelines が候補です。2026年11月時点の公式ページから、Queues と K2 を比べます。

項目QueuesK2
向く仕事1件ずつ完了・再試行・追跡大量のイベントを複数で読む
読み手1キューにコンシューマー1つ1ストリームに購読100まで
失敗の扱い1件単位の再試行・デッドレターキューバッチごとに nack
料金の数え方操作数(64KB ごと)データ量(GB)
無料プラン使える(1日1万操作)使えない
記録の保持無料24時間・有料最長14日最長30日

1件の結果を追いたいなら Queues、全件を何度でも配りたいなら K2、というのが編集部の目安です。 1件ずつ確実に処理する Queues の仕組みと無料枠は、Cloudflare Queuesとは?非同期処理の仕組みと無料枠・料金で解説しています。

公式ブログによると、K2 はもともと Basin Pipelines の取り込み口として作られました。最終的に R2 のオブジェクトストレージや Iceberg テーブルへ書くなら Pipelines、自分で処理する・ほかの行き先へ書くなら K2 が勧められています。イベントを R2 のテーブルに入れて SQL で分析する流れは、Cloudflare Basin の解説記事で扱っています。

料金とベータ版の上限

2026年11月時点の公式ページでは、K2 はベータ中のため利用料を請求していません。請求の30日以上前に知らせるとしており、料金表は請求を始めた後の予定です。

予定の料金

項目予定の料金
書き込んだ量1GB あたり 0.04ドル
読み出した量1GB あたり 0.04ドル
保存している量1GB・月あたり 0.02ドル

量は圧縮前のバイト数で数えます。読み出しはサブスクリプションごとに数えるので、サブスクリプションが増えるほど読み出しの料金も増えます。 公式の試算では、月100GB を書き込み、平均25GB を保存すると、読み手1つで月 8.50ドル、同じストリームを3つのサブスクリプションで読むと 16.50ドルです。K2 を使うには、月5ドルの最低料金がかかる Workers Paid の契約が要ります。

ベータ版の上限

項目上限
アカウントの保存量全ストリームで10GB
ストリームの数1アカウント20本
書き込みの速さ1ストリーム 30MB/s
1レコードの大きさ約1MB
保持期間1時間〜30日
サブスクリプション1ストリーム100

上限を上げたいときは、上限引き上げのフォームか Discord で頼めます。

K2の始め方

公式の Get started は、API トークンを作り、REST API でストリームを作って、curl で送る・読むを試す流れです。Workers Paid のアカウント、アカウント ID、curl と jq を用意します。

  1. 「Account API tokens」で、K2 Config Write・K2 Produce・K2 Consume の権限を付けたトークンを作る
  2. REST API でストリーム orders を作り、応答の id と endpoint を控える
  3. /produce に base64 にした記録を送る
  4. /subscriptions で、earliest から読むサブスクリプションを作る
  5. /consume で読み、処理したら /batches/<batch_id>/ack で確定する

トークンの値は、作った画面を離れると二度と見られません。 コマンドの全文は K2 の Get started にあります。

K2 を試す5つの段階。権限を3つ付けた API トークンを作り、REST API でストリームを作成し、/produce に記録を送り、earliest から読むサブスクリプションを作り、読んで5分以内に ack する
API トークンとストリームを作り、記録を送ってサブスクリプションから読み、ack します。

Worker から送るときは、Wrangler の設定ファイルに k2 のバインディングを書きます。コードでは env.ORDERS.send() の結果の result.success を確かめます。

"k2": [{ "binding": "ORDERS", "stream": "<STREAM_ID>" }]

使う前の注意点

K2 の配信は「少なくとも1回」です。重複と順番のずれを前提に、読む側を作ります。

  • 同じ記録が2回以上届くことがあります。 K2 は重複を除かないので、記録に一意の ID を入れ、データベースの主キーや API の冪等キーに使います
  • 分け合う読み手の間では、処理の順序は保証されません
  • ack はバッチ単位で、失敗した1件を除いて確定することはできません
  • 未読でも保持期間を過ぎると消えます。保持期間は、読み手が止まる時間より長くします
  • HTTP 入力の認証を有効にしないと、/produce はストリーム ID を知っている人なら誰でも書けます。ブラウザから送るなら、読む側で中身を確かめます
  • send() は失敗しても例外を投げません。result.success を確かめ、retryable が true のときだけ送り直します

書き込み先のデータベースに D1 を使う場合は、Cloudflare D1とは?SQLiteベースのDBの料金・無料枠と使い分けも参考にしてください。

発表時の公式ブログでは、送る側の待ち時間は 99 パーセンタイルで約1秒でした。すぐ届かないと困る処理には向かない、というのが編集部の見方です。

よくある質問

無料プランでも使えますか?

使えません。K2 は Workers Paid 専用で、Workers Paid には月5ドルの最低料金がかかります。ベータ中は K2 自体の利用料は請求されません。

Workers AIのKimi K2とは関係ありますか?

関係ありません。Kimi K2 は Workers AI で使える Moonshot AI の AI モデルの系列で、この記事の K2 はイベントを残すログです。

Kafkaの代わりに使えますか?

クラスターを運用せずに、イベントを複数の読み手へ配る用途なら使えます。Kafka のクライアントをそのまま使う対応は、今後の予定に挙がっている段階です。

記録は送った順番に処理されますか?

分け合う読み手の間では、処理の順序は保証されません。キーごとの順序の保証は今後の予定なので、今は順番に頼らない作りにします。

Workerで自動的に受け取れますか?

今のドキュメントにある読み方は、読み手が /consume に取りに行く形だけです。記録が届くと Worker が呼ばれるプッシュ型は、今後の予定に挙がっています。

この記事のポイント

  • K2は記録を保持期間まで残し、複数の読み手が別々に読めるログ
  • パブリックベータでWorkers Paid専用。ベータ中はK2の課金なし
  • 予定の料金は送る・読む1GB 0.04ドル、保存は1GB・月 0.02ドル
  • 配信は少なくとも1回。重複と順序を前提に読む側を作る

まとめ

Cloudflare K2 は、イベントを保持期間まで残し、サブスクリプションごとに複数の読み手が読める耐久性のあるログです。1件ずつの仕事は Queues、R2 のテーブルで分析するなら Basin Pipelines、大量のイベントを複数で読むなら K2 を選びます。

2026年11月時点ではパブリックベータで Workers Paid 専用ですが、K2 の利用料はまだ請求されません。まず公式の手順どおりに送る・読む・ack を試し、重複と順番のずれを前提に読む側を設計してください。

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

この記事を書いた人

フレアはゆる

編集長

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

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

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

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