View a markdown version of this page

Configurar o OpenTelemetry para Claude Code - Amazon CloudWatch
Escolha um caminho de configuração

Configurar o OpenTelemetry para Claude Code

O Claude Code emite métricas do OpenTelemetry (OTel) sobre uso de tokens, sessões, edições de código, chamadas de ferramentas e custo. Quando você envia essas métricas para o Amazon CloudWatch, elas preenchem a aba Claude Code dos painéis do Coding Agent Insights. Para saber mais sobre o painel, consulte Coding Agent Insights.

O Claude Code configura seu exportador OTel por meio de variáveis de ambiente. Dois caminhos de configuração estão disponíveis, a depender de como seus desenvolvedores executam o Claude Code.

Escolha um caminho de configuração

  • Token de portador — O Claude Code 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 Claude Code com um token de portador.

  • Implementação corporativa com o gateway de aplicativos Claude — Para organizações que precisam de controle centralizado sobre o acesso do desenvolvedor, a federação de identidades e a coleta de telemetria. Implante um gateway auto-hospedado que fique entre os clientes Claude Code de seus desenvolvedores e seu provedor de modelos. Os desenvolvedores fazem login com seu IdP corporativo em vez de manter chaves de API ou credenciais de nuvem. O gateway mantém a credencial upstream, impõe o acesso ao modelo e as configurações gerenciadas pelo grupo de IdP e retransmite a telemetria de uso para sua pilha de observabilidade. Suporta Amazon Bedrock, Claude Platform on AWS, Google Cloud e Microsoft Foundry como upstreams. Consulte Configure o Claude Code com o gateway de aplicativos Claude.

nota

O caminho do token portador configura somente como o Claude Code envia a telemetria para o CloudWatch; ele é independente de como o Claude Code chama um modelo para inferência, portanto, é possível utilizá-lo com qualquer provedor de modelo. A implementação corporativa com o gateway de aplicativos Claude combina configuração de telemetria com acesso centralizado à inferência e oferece suporte a vários backends, incluindo Amazon Bedrock, Claude Platform on AWS, Google Cloud e Microsoft Foundry.

Para obter a orientação completa e continuamente atualizada, incluindo modelos de implantação e scripts de configuração, veja a Orientação para Claude Code com o Amazon Bedrock no GitHub.

Tópicos