View a markdown version of this page

Configurar o OpenTelemetry para o OpenAI Codex - Amazon CloudWatch

Configurar o OpenTelemetry para o OpenAI Codex

O OpenAI Codex emite métricas do OpenTelemetry (OTel) sobre uso de tokens, latência por turno, solicitações de API, chamadas de ferramentas e aprovações. Quando você envia essas métricas para o Amazon CloudWatch, elas preenchem a guia Codex dos painéis do Coding Agent Insights. Para saber mais sobre o painel, consulte Coding Agent Insights.

O Codex configura seu exportador de métricas por meio da seção [otel] do arquivo config.toml. Dois caminhos de configuração estão disponíveis, a depender de como seus desenvolvedores executam o Codex.

Escolha um caminho de configuração

  • Token de portador — O Codex envia métricas de OTLP diretamente para o endpoint OTLP nativo do CloudWatch, autenticando com um cabeçalho Authorization: Bearer. Os atributos de identidade e organizacionais são fornecidos através da variável de ambiente OTEL_RESOURCE_ATTRIBUTES. Esse caminho não precisa de coletor e é a maneira mais rápida para um desenvolvedor individual ou uma pequena equipe começar. Consulte Configure o OpenAI Codex com um token de portador.

  • Implementação corporativa — Para organizações que federam a identidade do desenvolvedor por meio de autenticação única (SSO) corporativa, como Okta, Microsoft Entra ID, Auth0 ou AWS IAM Identity Center, centralize o acesso ao Amazon Bedrock e distribua uma configuração padrão para uma frota de desenvolvedores. Os atributos de identidade e organizacionais são derivados do provedor de identidades (IdP). Consulte Configure o OpenAI Codex para uma implementação corporativa.

nota

O caminho do token portador configura somente como o Codex envia telemetria para o CloudWatch; ele é independente de como o Codex chama um modelo para inferência, portanto, é possível utilizá-lo com qualquer provedor de modelo. A implantação corporativa, por outro lado, é construída com base no acesso centralizado ao Amazon Bedrock, portanto, o Amazon Bedrock é o backend de inferência para esse caminho. Para usar o Amazon Bedrock para inferência com o Codex, vejaAmazon Bedrock na documentação do OpenAI Codex.

Para obter a orientação completa e continuamente atualizada, incluindo modelos de implantação e scripts de configuração, consulte a orientação para o Codex no Amazon Bedrock no GitHub.