View a markdown version of this page

Configurazione Codice Claude metriche in Amazon CloudWatch con un token al portatore - Amazon CloudWatch
PrerequisitiConfigura l'esportatore delle 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à.

Configurazione Codice Claude metriche in Amazon CloudWatch con un token al portatore

In questo percorso, Claude Code invia le metriche OpenTelemetry (OTel) direttamente all'endpoint delle metriche OTLP CloudWatch native di Amazon e si autentica con un token al portatore (una chiave API di metrica). CloudWatch Non è richiesto alcun raccoglitore. OpenTelemetry Questo è il modo più veloce per un singolo sviluppatore o un piccolo team di inserire le metriche di Claude Code nelle dashboard di Coding Agent Insights.

Importante

I token al portatore sono credenziali a lungo termine. Li consigliamo solo laddove AWS le credenziali a breve termine non sono possibili, come i laptop per sviluppatori esterni. AWS Per i compromessi in termini di sicurezza e le indicazioni sulla rotazione dei tasti, consulta. Impostazione dell'autenticazione del token al portatore per Metrics Le organizzazioni che uniscono le identità tramite l'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 chiamare un modello per l'inferenza. Questa configurazione di telemetria è indipendente dall'inferenza, quindi puoi utilizzare un account Anthropic (il provider predefinito di Claude Code) 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 metrica (token al portatore), creata da un utente IAM che dispone delle autorizzazioni relative alle metriche. CloudWatch Per la procedura che crea l'utente IAM e genera la chiave, consulta. Impostazione dell'autenticazione del token al portatore per Metrics

Configura l'esportatore delle metriche

Claude Code si configura tramite variabili OpenTelemetry di ambiente. Imposta le seguenti variabili nella shell che avvia Claude Code (o nel tuo profilo shell) per abilitare le metriche, seleziona il OTLP/HTTP protocollo e indirizza l'esportatore delle metriche all'endpoint delle metriche con il token al portatore 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 un segreto. Evita di affidarlo al controllo del codice sorgente o ai profili di shell condivisi o sottoposti a backup in modo non sicuro. Ruota periodicamente la chiave come descritto in. Impostazione dell'autenticazione del token al portatore per Metrics

Aggiungi attributi identificativi e organizzativi

Le dashboard di Coding Agent Insights raggruppano l'utilizzo per sviluppatore, team, reparto e altre dimensioni organizzative. Forniscili come attributi delle risorse OtEL tramite la variabile di OTEL_RESOURCE_ATTRIBUTES ambiente. Imposta i valori in base all'identità dello sviluppatore e alla 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 di dati) corrisponde alla forma prevista dalle @resource.team.id dashboard, quindi puoi raggrupparli per ed etichette simili. @resource.department Claude Code stampa automaticamente le dimensioni a livello di metrica 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 e quindi la scheda Claude Code. Le metriche vengono visualizzate in genere 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 con Amazon Bedrock on. GitHub