pile·
인프라 / DevOps·cloudflare-blogCloudflare Blog·

로컬 트레이싱으로 AI 에이전트가 Workers를 직접 디버깅하다

Cloudflare가 wrangler dev와 vite dev에 OpenTelemetry 기반 자동 트레이스 캡처를 내장해, AI 코딩 에이전트가 Workers를 배포 없이 로컬에서 디버깅할 수 있게 했다. SDK 설치나 별도 설정 없이 자동 활성화되며, 에이전트가 SQL로 트레이스·로그를 쿼리해 장애 원인을 추적할 수 있다.

핵심 포인트
  • wrangler dev / vite dev 실행 시 OpenTelemetry 트레이스가 자동 캡처된다. 설정 변경 불필요.
  • KV, R2, D1, Durable Objects, Queues 등 바인딩 상호작용과 핸들러 생명주기 이벤트가 자동 계측된다.
  • 지원 코딩 에이전트 감지 시 개발 서버가 Local Explorer API 엔드포인트를 힌트로 표시한다.
  • 에이전트는 SQL 쿼리로 트레이스와 로그를 조회해 수동 로그 추가 없이 장애 원인을 파악할 수 있다.
  • 트레이스 데이터는 Miniflare가 조립해 로컬 SQLite에 저장하며, Local Explorer API로 노출된다.
상세 정리
  • 기존 문제: 코딩 에이전트가 Workers 버그를 디버깅하려면 로그를 추가하고 요청을 반복 실행하는 수동 사이클이 필요했다.
  • 자동 계측 구조: 계측 로직이 오픈소스 런타임 workerd 안에 내장됐다. 아웃바운드 HTTP, 바인딩(KV·R2·D1·Durable Objects·Queues) 상호작용, 핸들러 생명주기 이벤트를 자동으로 span으로 캡처.
  • 트레이스 저장 경로: Miniflare가 이벤트를 수집해 OpenTelemetry 형식으로 조립, 로컬 SQLite에 저장. Local Explorer API를 통해 에이전트가 접근.
  • 에이전트 발견 흐름: 지원 에이전트가 감지되면 개발 서버가 런타임에 API 엔드포인트 힌트를 표시한다. 에이전트가 하드코딩 없이 동적으로 엔드포인트를 탐색 가능.
  • 예시 디버깅: 에이전트가 D1 insert 실패 트레이스를 분석해 누락된 데이터베이스 마이그레이션을 발견한 사례 제시. 로그 추가 없이 트레이스만으로 원인 특정.
  • 시작 방법: npm install로 wrangler와 @cloudflare/vite-plugin 최신 버전 업데이트 후 바로 사용 가능. 추가 설정 불필요.
왜 읽나Cloudflare Workers 환경에서 AI 코딩 에이전트와 함께 개발하거나 배포 없이 로컬 디버깅 경험을 개선하려는 개발자에게.
cloudflare-blog
Cloudflare Blog 블로그
원문은 여기서 이어서 읽을 수 있어요
원문 읽기
읽음 (0)
·takedown 요청

이 글과 비슷한

  2. 인프라 / DevOps·cloudflare-blogCloudflare Blog·

    대규모 도그푸딩: cdnjs를 Cloudflare 개발자 플랫폼으로 이전하다

    cdnjs는 하루 90억 요청을 처리하는 오픈소스 JS/CSS CDN으로, 전 세계 웹사이트의 12%가 의존한다. 2026년 6월, Cloudflare는 6년간 GCP에서 운영하던 발행 파이프라인을 Workers, Workflows, R2, KV, Queues, Containers, Durable Objects로 완전 전환했다. 성능 문제가 아닌 관측성·유지보수성 한계가 동인이었으며, 마이그레이션 과정에서 플랫폼 한도를 직접 끌어올렸다.

    #durable-objects#workflows#cloudflare-workers+2
  3. 인프라 / DevOps·github-engGitHub Engineering·

    Dependabot 길들이기: 업데이트 묶고, 주기 늦추고, 보안은 빠르게

    GitHub의 Dependabot은 의존성 업데이트를 자동화하지만, 기본 설정에서는 10개 업데이트 = 10개 PR이 쏟아져 메인테이너가 알림을 무시하게 된다. Microsoft의 GCToolkit 사례(578개 커밋 중 92개가 Dependabot 버전 범프)를 바탕으로, 그룹핑·주기 조절·보안 업데이트 분리 3가지 설정으로 노이즈를 줄이면서 보안 속도는 유지하는 방법을 다룬다.

    #github-actions#devops#supply-chain-security+2