ClaudeCloudflare Developer Platform2026/04/28 0:00

Queues - Realtime backlog metrics now available for Queues

要点だけを先に読めるように短く再構成したセクションです。

元記事

OpenAI Claude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

claudejamodel: claude-haiku-4-5

Cloudflare Queues にリアルタイムバックログメトリクスが追加

cloudflare queues metrics api realtime backlog monitoring

Key Points

リアルタイムバックログメトリクス公開
複数APIで統一的にアクセス可能
メッセージ監視の詳細化

Summary

Cloudflare Queuesがリアルタイムバックログメトリクスをダッシュボード、REST API、JavaScript APIを通じて公開しました。キューの状態を詳細に監視できるようになります。

Key Points

3つの新しいメトリクスフィールド
- backlog_count: 未確認メッセージ数
- backlog_bytes: メッセージの合計サイズ（バイト）
- oldest_message_timestamp_ms: 最古の未確認メッセージのタイムスタンプ
API エンドポイント対応
- /accounts/{account_id}/queues/{queue_id}/messages/pull
- /accounts/{account_id}/queues/{queue_id}/messages
- /accounts/{account_id}/queues/{queue_id}/messages/batch
- メッセージ消費後の結果にmetadata.metricsオブジェクトが含まれます
JavaScript API
- env.QUEUE.metrics()でリアルタイムメトリクスを取得
- env.QUEUE.send()とenv.QUEUE.sendBatch()がレスポンスにmetricsオブジェクトを返却
その他の利用方法
- GraphQL Analytics APIでのクエリ対応
- ダッシュボードでのリアルタイム表示

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

claudejamodel: claude-haiku-4-5

Queues - リアルタイムバックログメトリクスがQueuesで利用可能に

Queuesのリアルタイムバックログメトリクスが利用可能に

公開日: 2026年4月28日

CloudflareのマネージドメッセージキューであるQueuesが、ダッシュボード、REST API、およびJavaScript APIを通じてリアルタイムバックログメトリクスを公開するようになりました。

新しいフィールド

以下の3つの新しいフィールドが利用可能です:

backlog_count — キューのバックログ内の未確認メッセージの数
backlog_bytes — これらのメッセージの合計サイズ(バイト単位)
oldest_message_timestamp_ms — 最も古い未確認メッセージのタイムスタンプ

REST API エンドポイント

以下のエンドポイントは、メッセージ消費成功後の結果フィールドにmetadata.metricsオブジェクトを含むようになりました:

/accounts/{account_id}/queues/{queue_id}/messages/pull
/accounts/{account_id}/queues/{queue_id}/messages
/accounts/{account_id}/queues/{queue_id}/messages/batch

JavaScript API

env.QUEUE.metrics()を呼び出してリアルタイムバックログメトリクスを取得します:

const {
  backlogCount,           // number
  backlogBytes,           // number
  oldestMessageTimestamp  // Date | undefined
} = await env.QUEUE.metrics();

env.QUEUE.send()およびenv.QUEUE.sendBatch()も、レスポンスにmetricsオブジェクトを返すようになりました。

その他の方法

これらのフィールドはGraphQL Analytics APIを通じてクエリすることも、ダッシュボードでリアルタイムバックログを表示することもできます。詳細については、Queues metricsを参照してください。