Anthropic 于 2026-10-14 宣布 Claude Platform 的 OpenTelemetry 追踪进入公测:Messages API 与 Claude Managed Agents 的请求可在 Claude Console 添加「遥测目的地」后由服务端直接导出,无需改代码;Claude SDK 则在应用内导出请求与工具执行的 span。span 遵循 OpenTelemetry gen_ai 语义约定,默认只带时长、状态、token 数、模型与工具名等元数据,也可切换为「完整内容」导出提示词与回复。
核心要点速览
- ✓两条接入路径:Console/Admin API 配置服务端目的地(Messages API + Managed Agents,零代码),或在 Claude SDK 内导出客户端 span(官方总览)
- ✓目的地要求 OTLP/HTTP + protobuf、HTTPS 443 端口;Admin API 使用
anthropic-beta: telemetry-destinations-2026-08-11头(API 文档) - ✓SDK 覆盖 Python、TypeScript、Go、Java(需 anthropic-java ≥ 2.72.0)等,支持 Claude API、AWS、Bedrock、Google Cloud、Microsoft Foundry,均为 beta(SDK 文档)
- ✓两种内容模式:仅元数据或完整内容;零数据保留(ZDR)客户的 Messages API 请求仍可导出完整内容,内容仅在内存中保留到送达;Managed Agents 不属于 ZDR
- ✓官方提醒公测期 span 名称与 SDK 选项可能出现破坏性变更,建议锁定 SDK 版本

开发者 3 秒速决决策指标
把技术选型换算成你的开发预算
40 款主流编程套餐横向比价,支持输入/输出 Token 真实账单模拟
相关资源与官方项目出处
免代理直达深度技术解析与实战评估
核心背景与行业痛点
智能体上线后最难的不是写提示词,而是排查:一次会话里有多轮模型调用和工具执行,哪一步慢、哪一步出错、token 花在哪,过去只能靠自己埋点。Anthropic 这次把追踪做进平台,Claude Platform OpenTelemetry 进入公测,数据直接发到团队已有的可观测平台,而不是锁在厂商自家面板里。
架构亮点与底层机制
分两层:服务端由管理员在 Console 或 Admin API 添加「遥测目的地」(OTLP/HTTP + protobuf,HTTPS 443),API 自动导出 Messages API 请求与 Managed Agents 会话的 span,零代码改动;客户端由 Claude SDK 为每次请求和 tool runner 执行的工具生成 span。只有服务端能看到 Managed Agents 的轮次和 Anthropic 托管的工具,只有 SDK 能看到你自己代码或自建沙箱里的工具,官方建议两者同开拼成一条完整 trace。span 遵循 gen_ai 语义约定,默认仅含时长、状态、token 数、模型与工具名。
权威 Benchmark 与实测跑分对比
这是基础设施功能,官方没有公布性能或开销跑分,本文不做推测。可核对的硬信息:官方合作方卡片列出 Datadog、Grafana Cloud、Honeycomb、Langfuse 等;Java SDK 需 2.72.0 以上;零数据保留客户的 Messages API 请求仍可导出完整内容,内容只在内存中保留到送达。
开发者实战落地与开箱指南
已用 Managed Agents 的团队,先在 Console 配一个「仅元数据」目的地看延迟和 token 分布;用 Python/TypeScript SDK 的项目升级到最新版,先接控制台导出器验证 span 嵌套,再换成 OTLP 导出器。统计 token 时同一请求只取 API 侧 span,避免与 SDK 侧重复计数。公测期 span 名称可能变化,记得锁定 SDK 版本,见 API 接入文档。
即刻查看该技术对应模型与主流工具的实测差异,或一键测算团队 API 调用与 $20/月套餐盈亏平衡点。
讨论与评论
0登录后即可参与深度讨论
与广大 AI 开发者、工程师交流评测心得与前沿洞察