JA EN
shiichan

まさかの自動トレース！AI エージェントが Workers を自分でデバッグできるようになったよ

Cloudflare Changelog ★★★★ Markdown で見る
#cloudflare#serverless#devops#ai

こんにちは、しぃちゃんだよ！今日は Cloudflare Changelog から、AI エージェントで開発してる人にはたまらないニュースだよ！

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog によると、wrangler dev と vite dev が、ローカルでの Worker 呼び出し中に構造化された OpenTelemetry トレースと、それに紐づくコンソールログを自動で記録するようになったよ。

さらに、ツールが AI エージェントのセッションを検知すると、ターミナルに /cdn-cgi/explorer/api の Local Explorer API を指すヒントを表示してくれるの。この API は OpenAPI スキーマを提供していて、テレメトリの検索やトレース・ログの照会、バインディングの状態確認ができる読み取り専用のオブザーバビリティ用エンドポイントになっているんだって。エージェントはこれを使って、どの処理が失敗しているかを特定し、コードを直して、リクエストを再実行し、結果を確認する、というループを回せるようになるよ。

なぜ重要なの？

AI エージェントに Worker の開発やデバッグを任せるとき、これまではエージェント自身がエラーの原因を突き止めるのに、コンソール出力を頼りにしたり、自分でログを仕込んだりする必要があったの。今回の機能は、デプロイや一時的なログ埋め込みなしに、ローカル環境のトレースを直接クエリできる仕組みを用意することで、エージェントが自律的に「原因特定 → 修正 → 再実行 → 確認」のデバッグループを回せるようにしてくれるんだよ。

これで何が変わるの？

  • wrangler dev や vite dev を動かすだけで、ハンドラ呼び出しや fetch() の呼び出し、バインディング呼び出しにスパンが自動で付くようになる
  • 自分で仕込んだカスタムスパンも、この自動スパンと一緒に表示される
  • 人間は Local Explorer のブラウザ UI で、同じトレースと紐づくコンソールログを確認できる。各トレースにはスパン・タイミング・属性・エラーが表示されるよ
  • AI エージェントは Local Explorer API 経由で同じ情報にプログラムからアクセスできる

まとめ

  • wrangler dev / vite dev がローカル呼び出し中の OpenTelemetry トレースとコンソールログを自動記録するようになった
  • AI エージェントのセッションを検知すると、Local Explorer API(/cdn-cgi/explorer/api)へのヒントが表示される
  • Local Explorer API は読み取り専用で、テレメトリの検索・トレースやログの照会・バインディング状態の確認ができる
  • 人間は Local Explorer のブラウザ UI で、スパン・タイミング・属性・エラーを含むトレースを確認できる
  • デプロイや一時的なログ埋め込みなしにデバッグループを回せる

AI コーディングエージェントに Workers の実装やデバッグを任せている人、ローカル開発でのトレース可視化を求めていた人には、うれしいアップデートだよ！

関連記事