Cloudflare、コーディングエージェント向けにWorkersのローカルトレーシングを提供

Cloudflareは、ローカルWorkersツールをAIコーディングエージェントにとってはるかに有用なものに、静かにアップグレードしました。本日より、wrangler devとvite devは、ローカルでのWorker呼び出しごとにOpenTelemetryトレースを自動的にキャプチャします。開発サーバーがエージェントセッションを検出すると、エージェントをLocal Explorer API（トレースと関連ログをSQLでクエリできるローカルデバッグエンドポイント）に誘導します。SDK不要、トレース設定不要、エージェントのセットアップ不要、プロンプトに可観測性の言及も不要です。

ワークフローは極めてシンプルです。エージェントが開発サーバーを起動し、バグを再現し、読み取り専用の可観測性エンドポイントにアクセスしてトレースを取得します。トレースは、どのバインディングが失敗し、その理由を正確に示します。Cloudflareが説明する例では、スキーマ変更後にPOST /api/ordersエンドポイントが500を返し始めます。トレースがなければ、エージェントはKV、D1、Queueの周りにログを追加し、再実行、検査、繰り返しという、トークンと時間を消費するプロセスを踏むことになります。トレースがあれば、KV読み取りは成功し、D1挿入はno such column: delivery_windowで失敗し、Queueは呼び出されなかったことを、1回のクエリで確認できます。エージェントはAPI経由でD1スキーマを検査し、欠落したマイグレーションを見つけ、適用し、修正を検証します。すべて単一のローカルループ内で完結し、デプロイは不要です。

内部の仕組み

計装は、Workersを支えるオープンソースランタイムであるworkerdに組み込まれています。アウトバウンドのfetch呼び出し、バインディング操作（KV、R2、D1、Durable Objects、Queues）、ハンドラーライフサイクル、そしてアプリが発行するカスタムスパンもキャプチャします。Miniflareはランタイムイベントとコンソール出力を収集し、OpenTelemetryトレースに組み立て、ローカルトレースストアとして機能するSQLiteバックアップのDurable Objectに保存します。Local Explorer APIは、そのデータを開発サーバー経由で公開します。

エージェントは、ルートがOpenAPIスキーマを提供するため、APIを自動的に発見します。ハードコードされたエンドポイントパスは不要です。人間も、Workerと同じlocalhostオリジンで動作するブラウザベースのLocal Explorer（Wranglerでeを押すか、/cdn-cgi/explorerにアクセス）で同じデータを閲覧できます。

始めるには、WranglerまたはCloudflare Viteプラグインを更新し、エージェントにローカルでデバッグを依頼するだけです。エージェントはすでにWorkerを作成・実行できます。今や、何が起こったかを確認し、修正し、デプロイ前に結果を検証できるのです。