您的代理现在可以使用本地跟踪调试Worker

wrangler dev现在为每个本地请求生成结构化跟踪。您的编码代理可以使用单个API来准确确定失败的原因—无需部署。

wrangler dev现在为每个本地请求生成结构化跟踪。您的编码代理可以使用单个API来准确确定失败的原因—无需部署。从今天开始, wrangler dev和vite dev会自动捕获本地Worker调用的OpenTelemetry跟踪。当Cloudflare的工具检测到代理会话时,它会将代理指向本地资源管理器API,这是一个本地调试API,可以在其中查询这些跟踪。

您无需安装SDK、启用跟踪、配置代理,甚至无需在提示中提及可观察性。提示可以很简单:这建立在多年来对当地发展的投资之上,从引入Miniflare到将本地模式作为Wrangler 3的默认模式。在部署代码之前,本地跟踪为编码代理提供来自开发环境的结构化反馈。

代理自动发现本地资源管理器API作为其正常工作流程的一部分,代理启动wrangler dev或vite dev以运行和测试Worker。当开发服务器识别受支持的编码代理会话时,它会自动打印一个提示,如下所示:本地资源管理器是一个基于浏览器的界面和REST API,用于在开发过程中查看和编辑本地资源数据以及查询可观察性数据。

API根目录提供OpenAPI架构,因此代理可以在运行时发现可用端点,而无需硬编码指令。自动捕获的跟踪可通过该API中的只读可观察性端点及其相关的控制台日志获得。代理可以查询此遥测,然后使用API的其他操作检查本地Worker和绑定,或检查D1、KV、R2、Durable Objects和工作流中的状态。

查找故障并验证修复考虑POST/api/orders,它从KV检索活动购物车,将结账详细信息保存到D1,并向队列发送消息以进行订单处理。架构更改后,端点突然开始返回500状态。没有本地跟踪500无法识别哪个操作失败。客服代表添加围绕KV、D1和队列的日志,重新运行请求,检查输出,然后重复。