View a markdown version of this page

Configuración de las métricas de OpenTelemetry de Claude Code para Amazon CloudWatch - Amazon CloudWatch
Elija una ruta de configuración

Configuración de las métricas de OpenTelemetry de Claude Code para Amazon CloudWatch

Claude Code emite métricas de OpenTelemetry (OTel) sobre el uso de tokens, las sesiones, las modificaciones del código, las llamadas a herramientas y los costos. Cuando envía estas métricas a Amazon CloudWatch, la pestaña Claude Code de los paneles de Información de agentes de codificación las muestra. Para obtener más información acerca de los paneles, consulte Información de agentes de codificación.

Claude Code configura el exportador de OTel mediante variables de entorno. Hay dos opciones de configuración disponibles, según la forma en que los desarrolladores ejecuten Claude Code.

Elija una ruta de configuración

  • Token de portador: Claude Code envía las métricas OTLP directamente al punto de conexión OTLP nativo de CloudWatch y se autentica mediante un encabezado Authorization: Bearer. Los atributos de identidad y de la organización se proporcionan mediante la variable de entorno OTEL_RESOURCE_ATTRIBUTES. Esta ruta no requiere ningún recopilador y es la forma más rápida de comenzar para un desarrollador individual o un equipo pequeño. Consulte Token de portador.

  • Despliegue empresarial con la puerta de enlace de aplicaciones de Claude: para organizaciones que necesitan un control centralizado del acceso de los desarrolladores, la federación de identidades y la recopilación de telemetría. Implemente una puerta de enlace autohospedada que se sitúe entre los clientes de Claude Code de los desarrolladores y el proveedor de modelos. Los desarrolladores inician sesión mediante el IdP corporativo, en lugar de utilizar claves de API o credenciales de servicios en la nube. La puerta de enlace almacena la credencial del servicio ascendente, aplica el acceso a los modelos y la configuración administrada según el grupo del IdP, y transmite la telemetría de uso a la pila de observabilidad. Admite Amazon Bedrock, Claude Platform en AWS, Google Cloud y Microsoft Foundry como servicios ascendentes. Consulte Configuración de Claude Code con la puerta de enlace de aplicaciones de Claude.

nota

La ruta del token de portador solo configura cómo Claude Code envía la telemetría a CloudWatch. Es independiente de cómo Claude Code llama a un modelo para la inferencia, por lo que se puede utilizar con cualquier proveedor de modelos. El despliegue empresarial con la puerta de enlace de aplicaciones de Claude combina la configuración de la telemetría con el acceso centralizado a la inferencia y admite varios backend, incluidos Amazon Bedrock, Claude Platform en AWS, Google Cloud y Microsoft Foundry.

Para consultar orientación completa y actualizada continuamente, incluidas plantillas de implementación y scripts de configuración, consulte Orientación para Claude Code con Amazon Bedrock en GitHub.

Temas