anthropic-sdk-go v1.81.0 于 10 月 14 日发布。对已经注册全局 OpenTelemetry tracer provider 和 propagator 的 Go 服务来说，升级后无需修改业务代码，SDK 会为 Claude 调用创建 span，并向请求中注入全局 propagator 生成的头。若使用的是官方入门示例中的复合 propagator，除 traceparent 外，baggage 也会被发送到 Anthropic API。对工程团队而言，这既降低了模型调用接入门槛，也把“哪些上下文可以外发”的治理问题提前。
接入依赖全局 OTel 配置，升级不等于简单开关
根据发布说明，如果应用注册了全局 tracer provider，SDK 升级后会基于该 provider 创建 span；请求也会带上全局 propagator 写入的 trace context headers。SDK 端不需要额外配置，它读取 otel.GetTracerProvider() 和 otel.GetTextMapPropagator()。
素材作者通过本地 httptest 服务器对比了 v1.80.0 和 v1.81.0：在未使用 API key、请求未真实到达 Anthropic 的情况下，v1.80.0 发出的请求中 traceparent 和 baggage 均为空，只存在业务 handler span；v1.81.0 则带有 traceparent 和 baggage，并新增名为 anthropic.messages.create 的客户端 span。测试中的 baggage 成员为 [email protected]。
不过，自动接入的边界取决于全局配置。若服务没有设置全局 tracer provider，而是把 provider 显式传给其他 instrumentation，测试中 SDK 不会记录自己的 span，但请求仍可能携带来自当前 span 的 traceparent 和 baggage。只有当上下文里没有 span、也没有注册 propagator 时，进程才不会发送这些内容。
Baggage 默认可能外发，敏感字段要先盘点
这次更新把 OpenTelemetry 的 baggage 传播问题推到台前。SDK 文档提到，如果 propagator 会写 baggage，SDK 也会发送 baggage；OpenTelemetry 官方也提示，敏感 baggage 项可能被共享给非预期资源，而现在 api.anthropic.com 属于这类外部资源。
对使用官方复合 propagator 的服务来说，变更尤其明显。过去，Claude 请求通常只有在开发者包装 HTTP client 或手动设置头时才带这些内容；现在，只要注册了包含 TraceContext 和 Baggage 的复合 propagator，就会自动发送。需要盘点的不只是本服务设置的 baggage，还包括从入站请求提取、并由上游服务继续添加的成员，仅靠检索创建成员的代码并不完整。
- 保留 traceparent，但在 Anthropic 请求前删除
baggage头，可通过option.WithMiddleware实现，适合其他出站调用仍需要 baggage 的场景。 - 只注册
propagation.TraceContext{}，不再注册 Baggage propagator，这也是 SDK 指南推荐的方式。
Span 属性覆盖模型调用与重试，提示词记录需显式控制
在默认 metadata_only 模式下，一次非流式调用会生成名为 anthropic.messages.create 的 CLIENT span，并挂在业务 span 下。素材给出的属性包括 gen_ai.operation.name=chat、gen_ai.provider.name=anthropic、gen_ai.request.model=claude-sonnet-5-5、gen_ai.request.max_tokens=256、gen_ai.usage.input_tokens=12、gen_ai.usage.output_tokens=3、http.request.method=POST、http.response.status_code=200、http.route=/v1/messages 等。该模式不记录 prompt 文本。
如果设置环境变量 ANTHROPIC_OPEN_TELEMETRY_TRACES_CONTENT_MODE=content，span 会增加输入与输出消息属性。测试中，输入消息包含提示词，输出消息包含模型回复。由于 v1.81.0 源码会在每次调用时读取该变量，而不是在客户端构建时读取一次，开发者若希望确保提示词不进入 tracing 后端，应在 anthropic.NewClient 时显式传入 option.WithOpenTelemetryTracesContentMode(option.OpenTelemetryContentModeMetadataOnly)，使环境变量无法覆盖该策略。
重试行为也纳入同一链路。当测试服务器首次返回 529 overloaded_error 时，SDK 使用同一 traceparent 重试，并记录一个带有 http.request.resend_count=1 的 span。
对排障、成本归因和 Agent 监控的直接价值
这次更新的核心意义，是把 Claude API 调用从一次普通 HTTP 请求变成服务调用链中的一段可查询记录。对排障来说，span 可以把业务入口、模型调用、HTTP 状态码、request id 和重试次数放在同一条 trace 中；对成本归因来说，input_tokens、output_tokens、model 等属性提供了按请求聚合用量的基础；对 Agent 或多步骤工作流来说，多次模型调用可以沿现有调用链展开，便于观察调用位置和链路关系。
需要注意的是，该功能仍处于 beta。SDK tracing 指南提示，span 名称、属性、选项和环境变量可能在版本之间变化。如果团队要基于这些属性构建仪表盘或告警，应固定 SDK 版本，并在升级前验证字段兼容性。与此同时，Claude Platform 同日发布说明也列出了 OpenTelemetry export beta：管理员在 Console 添加 destination 后，API 可将服务端 span 发送到用户 collector。客户端 span 与服务端导出若同时启用，模型调用链路会更完整，但 baggage 和内容模式带来的隐私边界，也需要在接入前先划清。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/go-fu-wu-diao-yong-claude-zi-dong-jin-ru-otel-lian-lu
