View a markdown version of this page

Configurazione OpenTelemetry per GitHub Copilot - 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 OpenTelemetry per GitHub Copilot

GitHub Copilot emette parametri OpenTelemetry (OtEL) sull'utilizzo dei token, sulle richieste, sulle chiamate agli strumenti e sulla latenza. Quando invii queste metriche ad Amazon CloudWatch, vengono inserite nella scheda GitHub Copilot delle dashboard di Coding Agent Insights. Per ulteriori informazioni sulle dashboard, consulta. Informazioni sugli agenti di codifica

Copilot invia le metriche OTLP direttamente all'endpoint CloudWatch nativo delle metriche OTLP e si autentica con un token al portatore (una chiave API delle metriche). CloudWatch OpenTelemetry Non è richiesto alcun raccoglitore. Il token al portatore è il percorso supportato da Copilot oggi.

Nota

Questa guida spiega solo come inviare le metriche Otel di Copilot CloudWatch, indipendentemente dal modo in cui Copilot chiama un modello per l'inferenza. Copilot utilizza i propri modelli per impostazione predefinita, ma le aziende possono portare le proprie chiavi di fornitore di modelli, incluso Amazon Bedrock. Per ulteriori informazioni, consulta Usa le tue chiavi API nella documentazione di Copilot. GitHub

Importante

I token Bearer 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

Prerequisiti

  • GitHub Copilot è installato, in una versione che supporta l'esportazione delle metriche. OpenTelemetry

  • Un abbonamento GitHub Copilot attivo per l'inferenza dei modelli. Copilot utilizza i propri modelli per impostazione predefinita; per utilizzare invece Amazon Bedrock, configura una chiave modello personalizzata come descritto in Usa le tue chiavi API nella documentazione di Copilot. GitHub

  • Una chiave API per CloudWatch le metriche (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

Configura l' OpenTelemetry esportatore di Copilot per inviare le metriche all'endpoint delle metriche con il token CloudWatch al portatore nell'intestazione. Authorization Imposta le seguenti variabili di ambiente nell'ambiente che avvia Copilot. Impostato per COPILOT_OTEL_ENABLED=true accendere. OpenTelemetry Copilot utilizza le OpenTelemetry variabili standard per tutti i segnali; non supporta sostituzioni specifiche delle metriche. Imposta l'endpoint OTEL_EXPORTER_OTLP_ENDPOINT di base senza il percorso: l'esportatore aggiunge il /v1/metrics percorso del segnale al posto tuo.

export COPILOT_OTEL_ENABLED=true
export OTEL_EXPORTER_OTLP_ENDPOINT="https://monitoring.region.amazonaws.com"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer YOUR_API_KEY"
Nota

Considera il token al portatore un segreto. Evita di affidarlo al controllo del codice sorgente o ai profili di shell condivisi e 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"

Verifica e visualizza

Usa Copilot per generare metriche e quindi confermare i dati raggiunti. CloudWatch

Per verificare le metriche

  1. Usa Copilot per eseguire alcune operazioni che generano telemetria.

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

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