Cloudflare cung cấp tracing cục bộ cho coding agent trên Workers
Wrangler và plugin Vite giờ tự động thu thập trace OpenTelemetry cho các lần chạy Worker cục bộ và hiển thị chúng cho coding agent qua Local Explorer API — không cần SDK, không cấu hình, không cần gợi ý trong prompt.
Cloudflare đã âm thầm làm cho công cụ Workers cục bộ của mình hữu ích hơn nhiều cho các AI coding agent. Kể từ hôm nay, wrangler dev và vite dev tự động thu thập trace OpenTelemetry cho mọi lần gọi Worker cục bộ. Khi dev server phát hiện phiên làm việc của agent, nó trỏ agent tới Local Explorer API — một endpoint gỡ lỗi cục bộ nơi trace và log tương quan có thể được truy vấn bằng SQL. Không SDK, không cấu hình tracing, không thiết lập agent, không đề cập đến observability trong prompt.
Quy trình vô cùng đơn giản. Agent khởi động dev server, tái hiện lỗi, sau đó truy cập endpoint observability chỉ đọc để lấy trace. Trace hiển thị chính xác binding nào bị lỗi và tại sao. Trong ví dụ Cloudflare trình bày, endpoint POST /api/orders bắt đầu trả về 500 sau khi thay đổi schema. Không có trace, agent sẽ thêm log quanh KV, D1 và Queue, chạy lại, kiểm tra, lặp lại — tốn token và thời gian. Với trace, nó thấy trong một truy vấn rằng KV đọc thành công, D1 insert thất bại với no such column: delivery_window, và Queue không bao giờ được gọi. Agent sau đó kiểm tra schema D1 qua API, tìm migration bị thiếu, áp dụng nó và xác minh bản sửa — tất cả trong một vòng lặp cục bộ duy nhất, không cần deploy.
Cách hoạt động bên trong
Việc instrumentation nằm trong workerd, runtime mã nguồn mở hỗ trợ Workers. Nó thu thập span cho các cuộc gọi fetch đi, tương tác binding (KV, R2, D1, Durable Objects, Queues) và vòng đời handler — cộng với bất kỳ span tùy chỉnh nào ứng dụng của bạn phát ra. Miniflare thu thập các sự kiện runtime và đầu ra console, ghép chúng thành trace OpenTelemetry và lưu trữ trong một Durable Object hỗ trợ SQLite đóng vai trò là kho lưu trữ trace cục bộ. Local Explorer API hiển thị dữ liệu đó qua dev server.
Agent tự động khám phá API vì root phục vụ một schema OpenAPI — không cần endpoint path được mã hóa cứng. Con người cũng có thể duyệt cùng dữ liệu trong Local Explorer dựa trên trình duyệt, chạy trên cùng origin localhost với Worker (nhấn e trong Wrangler hoặc truy cập /cdn-cgi/explorer).
Để bắt đầu, cập nhật Wrangler hoặc plugin Vite của Cloudflare và chỉ cần yêu cầu agent của bạn gỡ lỗi cục bộ. Agent đã có thể viết và chạy Worker của bạn — giờ nó có thể thấy điều gì đã xảy ra, sửa nó và xác minh kết quả trước khi bạn deploy.
Agent của bạn đã có thể viết và chạy Worker cục bộ — giờ nó có thể thấy điều gì đã xảy ra, sửa những gì thất bại và xác minh kết quả trước khi bạn deploy.