View a markdown version of this page

Configura Claude Code con un token al portatore - Amazon CloudWatch
PrerequisitiConfigura l'esportatore di metricheAggiungi attributi identificativi e organizzativiVerifica e visualizza

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura Claude Code con un token al portatore

Su questo percorso, Claude Code invia i parametri OpenTelemetry (Otel) direttamente all'endpoint dei parametri OTLP CloudWatch nativo di Amazon e si autentica con un token bearer (una chiave API Metrics). CloudWatch Non è richiesto alcun raccoglitore. OpenTelemetry Questo è il modo più veloce per un singolo sviluppatore o un piccolo team per inserire le metriche di Claude Code nelle dashboard di Coding Agent Insights.

Importante

I token Bearer sono credenziali a lungo termine. Li consigliamo solo laddove non sia possibile utilizzare AWS credenziali a breve termine, ad esempio quando si utilizzano computer portatili per sviluppatori esterni. AWS Per i compromessi in materia di sicurezza e le indicazioni sulla rotazione dei tasti, consulta. Configurazione dell'autenticazione con token al portatore per Metrics Organizations che federano l'identità tramite SSO aziendale dovrebbero invece utilizzare l'implementazione aziendale con Claude apps gateway. Per informazioni, consulta Configura Claude Code con il gateway delle app Claude.

Prerequisiti

  • Claude Code installato sul computer dello sviluppatore.

  • Un modo efficace per Claude Code di richiamare un modello per l'inferenza. Questa configurazione di telemetria è indipendente dall'inferenza, quindi puoi utilizzare un account Anthropic (il provider Claude Code predefinito) o Amazon Bedrock. Per utilizzare Amazon Bedrock per l'inferenza, consulta Claude Code su Amazon Bedrock nella documentazione di Claude Code.

  • Una chiave API CloudWatch Metrics (bearer token), creata da un utente IAM che dispone delle autorizzazioni per le metriche. CloudWatch Per la procedura che crea l'utente IAM e genera la chiave, consulta. Configurazione dell'autenticazione con token al portatore per Metrics

Configura l'esportatore di metriche

Claude Code configura tramite variabili OpenTelemetry di ambiente. Imposta le seguenti variabili nella shell che lancia Claude Code (o nel tuo profilo di shell) per abilitare le metriche, seleziona il OTLP/HTTP protocollo e indirizza l'esportatore delle metriche verso l'endpoint delle metriche con il token bearer nell' CloudWatchintestazione. Authorization Includi il percorso completo. /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

Considera il gettone al portatore come un segreto. Evita di affidarlo al controllo del codice sorgente o ai profili della shell condivisi o sottoposti a backup in modo non sicuro. Ruotate periodicamente la chiave come descritto in. Configurazione dell'autenticazione con token al portatore per Metrics

Aggiungi attributi identificativi e organizzativi

Il pannello di controllo di Coding Agent Insights illustra l'utilizzo dei gruppi per sviluppatore, team, reparto e altre dimensioni organizzative. Forniscili come attributi di risorsa OTel tramite la variabile di OTEL_RESOURCE_ATTRIBUTES ambiente. Imposta i valori dell'identità del tuo sviluppatore e della struttura della tua organizzazione.

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

L'impostazione di questi attributi come attributi di risorsa (anziché attributi per punto dati) corrisponde alla forma prevista dai dashboard, quindi puoi raggruppare per @resource.team.id etichette e simili. @resource.department Claude Code timbra automaticamente le dimensioni a livello metrico come e sulle metriche. model type

Verifica e visualizza

Esegui Claude Code per generare metriche, quindi conferma i dati raggiunti. CloudWatch

Per verificare le metriche

  1. Esegui una sessione di Claude Code che esegua alcune operazioni.

  2. Nella CloudWatch console, scegli GenAI Observability, Coding Agent Insights, quindi la scheda Claude Code. Le metriche vengono in genere visualizzate entro pochi minuti.

  3. Facoltativamente, interroga le metriche direttamente con PromQL. Per ulteriori informazioni, consulta Interrogazione ProMQL.

Per una guida completa e continuamente aggiornata, consulta la Guida per Claude Code with Amazon Bedrock on. GitHub