DocsDigest
Back to listLanguage: JA
ClaudeCloudflare Developer PlatformApr 28, 2026, 12:00 AM

Queues - Realtime backlog metrics now available for Queues

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

claudeenmodel: claude-haiku-4-5

Realtime backlog metrics now available for Queues

queuesmetricsrealtimeapicloudflaremessage-queuebacklog

Key Points

  • Realtime backlog metrics for message queues
  • Available via REST API, JavaScript API, and dashboard
  • Three new metrics: backlog_count, backlog_bytes, oldest_message_timestamp_ms

Summary

Cloudflare Queues now exposes realtime backlog metrics through the dashboard, REST API, and JavaScript API, enabling better visibility into queue health and message processing.

Key Points

  • Three new metrics fields available:

    • backlog_count — number of unacknowledged messages
    • backlog_bytes — total size of unacknowledged messages in bytes
    • oldest_message_timestamp_ms — timestamp of the oldest unacknowledged message

  • REST API updates: Message consumption endpoints now include a metadata.metrics object on successful responses

    • /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: Call env.QUEUE.metrics() to retrieve realtime backlog metrics; send() and sendBatch() methods now return metrics objects

  • Additional access methods: Query metrics via GraphQL Analytics API or view on the dashboard

Full Translation

Translations

A translation section that keeps the flow of the original article.

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を参照してください。