Changelog — Cloudflare の新しい更新と改善

公開日: 2026-04-01 カテゴリ: Workers

Workers — 新しい L4 トランスポート テレメトリ フィールド

Workers の request.cf に、クライアント接続からのレイヤ 4 トランスポート テレメトリを公開する新しいプロパティが 3 つ追加されました。これらのプロパティを使用すると、クライアント側の変更を必要とせずに、ラウンドトリップタイムやデータ配信速度などのリアルタイム接続品質シグナルに基づいて Worker 内で意思決定ができます。

以前は、このテレメトリは Server-Timing: cfL4 レスポンスヘッダーでのみ利用可能でした。今回の新しいプロパティは同じデータを Workers ランタイム内に直接露出するため、ルーティング、ログ記録、レスポンスのカスタマイズなどに利用できます。

新しいプロパティ

• clientTcpRtt — number | undefined

  • Cloudflare とクライアント間の平滑化された TCP ラウンドトリップタイム (RTT) をミリ秒単位で返します。TCP 接続 (HTTP/1, HTTP/2) の場合にのみ存在します。例: 22。

• clientQuicRtt — number | undefined

  • Cloudflare とクライアント間の平滑化された QUIC ラウンドトリップタイム (RTT) をミリ秒単位で返します。QUIC 接続 (HTTP/3) の場合にのみ存在します。例: 42。

• edgeL4 — Object | undefined

  • レイヤ 4 トランスポートの統計情報を含むオブジェクト。deliveryRate (number) を含み、接続に対する最新のデータ配信速度の推定値をバイト/秒で示します。例: 123456。

例: 接続品質メトリクスをログ出力

export default {
  async fetch ( request ) {
    const cf = request . cf ;
    const rtt = cf . clientTcpRtt ?? cf . clientQuicRtt ?? 0 ;
    const deliveryRate = cf . edgeL4 ?. deliveryRate ?? 0 ;
    const transport = cf . clientTcpRtt ? "TCP" : "QUIC" ;
    console . log ( `Transport: ${ transport } , RTT: ${ rtt } ms, Delivery rate: ${ deliveryRate } B/s` ) ;
    const headers = new Headers ( request . headers ) ;
    headers . set ( "X-Client-RTT" , String ( rtt )) ;
    headers . set ( "X-Delivery-Rate" , String ( deliveryRate )) ;
    return fetch ( new Request ( request , { headers } )) ;
  },
};

詳細

詳しくは Workers Runtime APIs: Request を参照してください。