OpenAICloudflare Developer Platform2026/04/28 0:00

Queues - Realtime backlog metrics now available for Queues

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

元記事

OpenAI Claude

Quick Digest

要約

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

openaijamodel: gpt-5-mini-2025-08-07

Queues: リアルタイムのバックログ指標が利用可能に

queues metrics realtime rest-api javascript graphql cloudflare

Key Points

リアルタイムバックログ
metadata.metrics追加
env.QUEUE.metrics対応

Summary

Cloudflare Queuesでリアルタイムのバックログ指標がダッシュボード、REST API、JavaScript API（およびGraphQL Analytics）で取得可能になりました。追加されたフィールドは backlog_count（未ackのメッセージ数）、backlog_bytes（合計バイト数）、oldest_message_timestamp_ms（最古未ackメッセージのタイムスタンプ、ミリ秒、存在しない場合は undefined）です。メッセージ取得／送信のレスポンスには metadata.metrics が含まれます。

Key Points

利用可能箇所:
- ダッシュボード、REST API、JavaScript API、GraphQL Analytics
レスポンスに 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での取得方法:
- await env.QUEUE.metrics() で backlogCount / backlogBytes / oldestMessageTimestamp を取得
- env.QUEUE.send() / env.QUEUE.sendBatch() のレスポンスにも metrics が含まれる
実務上の注意点:
- backlog_count は未ackの件数、backlog_bytes はバイト単位の合計、oldest_message_timestamp_ms はミリ秒で返るため変換に注意
- 監視、スケーリング、アラートのトリガーに活用できる

Full Translation

翻訳

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

openaijamodel: gpt-5-mini-2025-08-07

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

公開日: 2026-04-28

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

新しいメトリクスフィールド

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

backlog_count — キュー内の未ack（未確認）メッセージ数
backlog_bytes — それらのメッセージの合計サイズ（バイト単位）
oldest_message_timestamp_ms — 最も古い未ackメッセージのタイムスタンプ（ミリ秒）

変更されたエンドポイント

メッセージ消費が成功した後、以下のエンドポイントの結果フィールドに 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() を呼び出してください。

TypeScript

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

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

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