设置 Amazon CloudWatch 的 Claude Code OpenTelemetry 指标
Claude Code 会发出有关令牌使用情况、会话、代码编辑、工具调用和成本的 OpenTelemetry(OTel)指标。当您将这些指标发送到 Amazon CloudWatch 时,它们会填充编程代理洞察控制面板的 Claude Code 选项卡。有关控制面板的更多信息,请参阅 编程代理洞察。
Claude Code 通过环境变量配置其 OTel 导出程序。根据开发人员运行 Claude Code 的方式,有两种设置路径可供选择。
选择设置路径
-
持有者令牌:Claude Code 直接将 OTLP 指标发送到 CloudWatch 原生 OTLP 端点,并通过
Authorization: Bearer标头进行身份验证。身份和组织属性通过OTEL_RESOURCE_ATTRIBUTES环境变量提供。此路径无需收集器,是个人开发人员或小型团队最快的入门方式。请参阅 持有者令牌。 -
采用 Claude 应用程序网关的企业部署:适用于需要集中控制开发人员访问、身份联合验证和遥测数据收集的组织。部署一个位于开发人员的 Claude Code 客户端和模型提供商之间的自托管网关。开发人员使用公司 IdP 登录,而不是持有 API 密钥或云凭证。网关持有上游凭证,按 IdP 组强制执行模型访问和托管设置,并将使用情况遥测数据中继到可观测性堆栈。支持 Amazon Bedrock、AWS 云端 Claude Platform、Google Cloud 和 Microsoft Foundry 作为上游。请参阅 使用 Claude 应用程序网关设置 Claude Code。
注意
持有者令牌路径仅配置 Claude Code 如何向 CloudWatch 发送遥测数据;它与 Claude Code 如何调用模型进行推理无关,因此您可以将其与任何模型提供程序一起使用。采用 Claude 应用程序网关的企业部署将遥测配置与集中式推理访问相结合,并且支持多个后端,包括 Amazon Bedrock、AWS 云端 Claude Platform、Google Cloud 和 Microsoft Foundry。
有关持续更新的完整指导(包括部署模板和设置脚本),请参阅 GitHub 上的 Guidance for Claude Code with Amazon Bedrock