이제 로컬 트레이싱으로 Workers를 디버깅할 수 있다

Cloudflare의 wrangler dev와 vite dev가 이제 로컬 Worker 호출에 대한 OpenTelemetry 트레이스를 자동으로 수집한다. 개발 서버가 AI 코딩 에이전트 세션을 감지하면 에이전트가 Local Explorer API를 통해 트레이스와 로그를 조회하도록 안내한다.

SDK 설치, 트레이싱 활성화, 에이전트 설정은 필요 없다. 에이전트는 다음과 같은 간단한 요청만으로 오류를 재현하고 원인을 찾아 수정한 뒤 로컬에서 결과를 검증할 수 있다.

POST /api/orders is returning 500. Find the cause, fix it, and verify the fix locally.

Local Explorer API는 브라우저 인터페이스와 REST API를 제공하며, API 루트에서 OpenAPI 스키마를 확인할 수 있어 에이전트가 실행 중 필요한 엔드포인트를 자동으로 탐색한다. 관측성 엔드포인트에서는 다음 데이터를 조회할 수 있다.

• SQL로 조회하는 로컬 트레이스와 로그
• 트레이스와 연결된 console 로그
• 로컬 Worker와 바인딩 정보
• D1, KV, R2, Durable Objects, Workflows의 상태

예를 들어 /api/orders가 500 오류를 반환하면 트레이스에서 KV 조회는 성공했지만 D1 삽입이 no such column: delivery_window 오류로 실패했고, Queue 호출은 실행되지 않았다는 사실을 확인할 수 있다. 에이전트는 반복적으로 로그를 추가하는 대신 구조화된 실행 데이터를 바탕으로 원인을 파악하고 수정 사항을 검증한다.