View a markdown version of this page

Configuración de las métricas de Claude Code en Amazon CloudWatch con un token de portador - Amazon CloudWatch
Requisitos previosConfiguración del exportador de métricasCómo agregar atributos de identidad y de la organizaciónComprobación y visualización

Configuración de las métricas de Claude Code en Amazon CloudWatch con un token de portador

Mediante esta ruta, Claude Code envía las métricas de OpenTelemetry (OTel) directamente al punto de conexión nativo de métricas OTLP de Amazon CloudWatch y se autentica mediante un token de portador, es decir, una clave de API de métricas de CloudWatch. No se requiere ningún recopilador de OpenTelemetry. Esta es la forma más rápida de que un desarrollador individual o un equipo pequeño envíe las métricas de Claude Code a los paneles de Información de agentes de codificación.

importante

Los tokens de portador son credenciales de larga duración. Solo recomendamos su uso cuando no resulte viable utilizar credenciales de AWS de corta duración, como en los equipos portátiles de los desarrolladores que se encuentran fuera de AWS. Para obtener información sobre las ventajas y desventajas de seguridad y las recomendaciones para la rotación de claves, consulte Configurar la autenticación por token de portador para métricas. Las organizaciones que federan identidades mediante el SSO corporativo deben utilizar, en su lugar, el despliegue empresarial con la puerta de enlace de aplicaciones de Claude. Consulte Configuración de Claude Code con la puerta de enlace de aplicaciones de Claude.

Requisitos previos

  • Claude Code debe estar instalado en el equipo del desarrollador.

  • Debe existir un método funcional para que Claude Code llame a un modelo con fines de inferencia. Esta configuración de telemetría es independiente de la inferencia, por lo que puede utilizar una cuenta de Anthropic, el proveedor predeterminado de Claude Code, o Amazon Bedrock. Para utilizar Amazon Bedrock con fines de inferencia, consulte Claude Code en Amazon Bedrock en la documentación de Claude Code.

  • Una clave de API de métricas de CloudWatch (token de portador), creada a partir de un usuario de IAM con permisos para las métricas de CloudWatch. Para consultar el procedimiento de creación del usuario de IAM y generación de la clave, consulte Configurar la autenticación por token de portador para métricas.

Configuración del exportador de métricas

Claude Code configura OpenTelemetry mediante variables de entorno. Establezca las siguientes variables en el intérprete de comandos que lanza Claude Code, o en el perfil del intérprete de comandos, para habilitar las métricas, seleccionar el protocolo OTLP/HTTP y dirigir el exportador de métricas al punto de conexión de métricas de CloudWatch con el token de portador en el encabezado Authorization. Incluya la ruta completa de /v1/metrics.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.region.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer YOUR_API_KEY"
nota

Trate el token de portador como un secreto. Evite incluirlo en el control de versiones o en perfiles del intérprete de comandos que se compartan o cuyas copias de seguridad no sean seguras. Rote la clave periódicamente, como se describe en Configurar la autenticación por token de portador para métricas.

Cómo agregar atributos de identidad y de la organización

Los paneles de información del agente de codificación agrupan el uso por desarrollador, equipo, departamento y otras dimensiones de la organización. Proporcione estos datos como atributos de recurso de OTel mediante la variable de entorno OTEL_RESOURCE_ATTRIBUTES. Establezca los valores según la identidad del desarrollador y la estructura de la organización.

export OTEL_RESOURCE_ATTRIBUTES="\
user.id=alias,\
user.email=developer@example.com,\
user.name=Jane Doe,\
department=engineering,\
team.id=platform,\
cost_center=cc-1234,\
organization=example-corp,\
location=us-seattle,\
role=software-engineer,\
manager=manager@example.com"
nota

La configuración de estos valores como atributos del recurso, en lugar de atributos por punto de datos, se ajusta a la estructura que esperan los paneles, por lo que permite agrupar por @resource.team.id, @resource.department y otras etiquetas similares. Claude Code agrega automáticamente a las métricas dimensiones a nivel de métrica, como model y type.

Comprobación y visualización

Ejecute Claude Code para generar métricas y, a continuación, compruebe que los datos hayan llegado a CloudWatch.

Verificación de las métricas

  1. Ejecute una sesión de Claude Code que realice alguna tarea.

  2. En la consola de CloudWatch, seleccione Observabilidad de IA generativa, Información de agentes de codificación y, a continuación, la pestaña Claude Code. Por lo general, las métricas aparecen en unos minutos.

  3. De manera opcional, consulte las métricas directamente con PromQL. Para obtener más información, consulte Consultas PromQL.

Para obtener instrucciones completas y actualizadas continuamente, consulte Orientación para Claude Code con Amazon Bedrock en GitHub.