OpenAICloudflare Developer Platform2026/05/07 0:00

Workers - Automatic tracing across Durable Object and Worker subrequests

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

元記事

OpenAI Claude

Quick Digest

要約

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

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

Worker間サブリクエストでのトレース自動統合

workers durable-objects tracing opentelemetry w3c-trace-context

Key Points

Worker間トレースが統合
Durable Objectが子スパンに
Wranglerでトレース有効化が必要

Summary

Cloudflare Workers間（サービスバインディング/ Durable Object を含む）のサブリクエストで、トレースコンテキストが自動伝搬されるようになり、単一の統合トレースとして表示されます。以前はWorker間呼び出しが分断されたトレースになっていましたが、今回の変更で呼び出しはネストした子スパンとして追跡できるようになります。トレースはCloudflareダッシュボードで確認でき、OpenTelemetryで外部の可観測性プラットフォームにエクスポートできます。

Key Points

Worker→Worker（サービスバインディング、Durable Object含む）のサブリクエストでトレースコンテキストが自動伝搬され、単一トレースとして表示される
サービスバインディングやDurable Object呼び出しは親スパンの子スパンとしてネストされるため、クロスWorkerのフローを可視化できる
トレースを記録するにはWranglerの設定でトレースを有効化する必要がある（例: tracing = true を設定）
トレースはCloudflareダッシュボードで確認可能、またはOpenTelemetry経由で外部プラットフォームへ送信可能
今後、W3C Trace Context準拠の外部トレースコンテキスト伝搬をサポート予定（Cloud外サービスとの連携が容易に）

実務での短い手順例:

wrangler設定でトレースを有効化
Worker呼び出しとDurable Objectの挙動をダッシュボードで確認
必要に応じてOpenTelemetryエクスポーターを設定して外部可観測性ツールに連携

Full Translation

翻訳

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

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

Workers - Durable Object と Worker サブリクエストをまたいだ自動トレーシング

Durable Object と Worker サブリクエストをまたいだ自動トレーシング

Worker 間のサブリクエストでトレースコンテキストが自動的に伝播し、単一の統合トレースを取得できるようになりました。以前は、Worker が service binding や Durable Object を介して別の Worker を呼び出すと、自動トレーシングが切断されたトレースを生成していました。

これにより、次のことが可能になります：

リクエストを Worker アーキテクチャ全体で単一のトレースビューとして追跡できる
service binding および Durable Object の呼び出しを、別々のトレースではなく入れ子になった子スパンとして表示できる
Cloudflare ダッシュボードまたは OpenTelemetry を介した外部の可観測性プラットフォームで Worker 間のリクエストフローをデバッグできる

トレースを記録するには、Wrangler の設定で Tracing を有効にする必要があります。開始するには Workers tracing を参照してください。

次の取り組みとして、W3C Trace Context standards ↗ を使用した外部トレースコンテキストの伝播に対応する作業を進めています。これにより、Workers のトレースを Cloudflare 外部のサービスのトレースとリンクできるようになります。