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 版本
Claude Platform 开放 OpenTelemetry 追踪公测:Messages API、Managed Agents 与 SDK 的每次模型调用和工具使用可直送 Datadog、Langfuse 等可观测平台
🖼️要闻配图
点击全屏高清查看
🧭

把技术选型换算成你的开发预算

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/月套餐盈亏平衡点。

接着读Cursor 推出 Rollouts 与升级版 Security Reviewer:部署监控 + 安全审查提速 21%
立即阅读→