链路追踪与会话
把一次 agent 运行看成一条时间线,把一整段对话看成一个会话:哪些调用是并行的、时间花在了哪里、哪里出了错、花了多少钱。
控制台侧边栏位置(该功能适用于你的账户时才会出现): Traces 打开 ↗
操作步骤
- 同一次运行(一次用户请求、一个 agent 任务)里的每个调用都带上
X-Trace-Id,用X-Span-Id给每个调用起名,同一段对话的每个调用都带上X-Session-Id。自带 trace 或会话请求头的工具(例如 Claude Code)无需改动就能归组。 - 打开链路追踪。这里列出最近 7 天的 trace 和会话,以及各自的调用次数、时长和花费,最近有请求的排在最前;点击列标题可以按该列排序。在 trace 或会话页面点重命名可以给它起个名字,工作区内所有人都能看到。搜索可以输入完整的 ID,也可以输入名称中的任意一段。
- 打开一个 trace 就能看到瀑布图:每个调用一条横条,按时间排布,你自己的代码在运行的那段时间显示为你的应用。并行的调用会重叠显示。失败的调用带斜纹并标出状态码;选中一个调用可以看到它的延迟、token 和花费。
- 打开一个会话可以看到它的汇总、用到的模型、按状态码统计的错误,以及调用随时间的分布。在日志中查看这些调用会列出这个会话的每一个请求。
限制与注意事项
- trace 和会话是根据你的请求日志汇总出来的,所以覆盖的是同样的 90 天、同样的调用。
- 失败调用显示的是你的代码实际收到的状态码,包括供应商返回的错误。
- ID 由你自己定:每个最多 128 个可打印 ASCII 字符。它们会回显在响应里,不会发给供应商。
- 如果编程 agent 标明了它的子 agent,会话页会列出各个 agent 及其调用数和花费,链路里会标出压缩和辅助调用,并写出两次调用之间运行的工具。
- 网关重试过的请求,会在详情里列出每次尝试的模型、状态码和耗时。瀑布图里,失败的尝试画成这条调用开头的斜纹段。
同一功能的 API 参考: 请求头