Supervisión de los agentes de codificación de IA con información de agentes de codificación de Amazon CloudWatch
Los agentes de codificación de IA, como OpenAI Codex, Claude Code y GitHub Copilot, emiten telemetría de OpenTelemetry (OTel) sobre el uso que les dan los desarrolladores, incluido el consumo de tokens, la latencia por turno, las llamadas a herramientas, las solicitudes de API y las aprobaciones. Al enviar esta telemetría a Amazon CloudWatch, puede supervisar la adopción, atribuir el uso y los costos a equipos y departamentos, y detectar problemas de rendimiento o confiabilidad en la flota de desarrolladores.
CloudWatch proporciona Información de agentes de codificación, un conjunto de paneles listos para usar disponible en la consola, en Observabilidad de IA generativa, Información de agentes de codificación. Estos paneles permiten segmentar y analizar el uso según atributos organizativos como la organización, el departamento, el equipo, el centro de costos y el usuario, a fin de comparar la adopción y los costos en la flota. También puede exportar los datos subyacentes en formato CSV para realizar análisis adicionales. No es necesario crear ni importar estos paneles. Aparecen automáticamente y se completan en cuanto los agentes envían métricas con la estructura esperada. La única tarea consiste en configurar cada agente para que publique sus métricas de OTel en CloudWatch.
importante
Los paneles de información sobre agentes de codificación dependen de una estructura específica de métricas y atributos. Las métricas OTel nativas de cada agente contienen las dimensiones principales del panel, como model y token_type. Los atributos de identidad y de la organización, como user.email, team.id, department, cost_center y organization, se deben enviars como atributos de recurso de OTel. Las guías de configuración de esta sección permiten configurar cada agente para que emita telemetría con esta estructura. Si cambia los nombres de las métricas o traslada los atributos de identidad fuera del recurso, es posible que esos datos no aparezcan en los paneles.
Requisitos previos
Los agentes de codificación envían métricas al punto de conexión nativo de métricas OTLP de CloudWatch. Antes de configurar un agente, familiarícese con el punto de conexión. Para obtener más información, consulte Puntos de conexión de OTLP y Introducción.
Guías de configuración
Elija la guía correspondiente a su agente de codificación. Cada guía abarca una o más rutas de configuración, por lo que puede elegir el enfoque que mejor se adapte a la forma en que los desarrolladores ejecutan el agente.
Temas
-
Claude Code: configure Claude Code con un token de portador, para usuarios individuales y equipos pequeños, o mediante un despliegue empresarial con inicio de sesión único (SSO) corporativo.
-
Configuración de OpenTelemetry para OpenAI Codex: configure OpenAI Codex con un token de portador, para usuarios individuales y equipos pequeños, o mediante un despliegue empresarial con inicio de sesión único (SSO) corporativo.
-
Configuración de OpenTelemetry para GitHub Copilot: configure GitHub Copilot con un token de portador.
Visualización de los paneles
Cuando un agente comience a enviar métricas, consulte los paneles en la consola.
Para ver los paneles de Información de agentes de codificación
-
Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/
. -
En el panel de navegación, seleccione Observabilidad de IA generativa y, a continuación, seleccione Información de agentes de codificación.
-
Seleccione la pestaña correspondiente al agente de codificación. Por lo general, las métricas aparecen unos minutos después de que el agente envía datos.
nota
Las métricas se pueden consultar mediante PromQL, por lo que también puede crear sus propios paneles y alarmas. Para obtener más información, consulte Consultas PromQL.
