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
<a name="coding-agents-copilot"></a>

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](coding-agents-insights.md)

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. ](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) 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](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Prerequisiti
<a name="coding-agents-copilot-prereqs"></a>
+ 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. ](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) 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](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Configura l'esportatore delle metriche
<a name="coding-agents-copilot-configure"></a>

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](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Aggiungi attributi identificativi e organizzativi
<a name="coding-agents-copilot-attributes"></a>

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
<a name="coding-agents-copilot-verify"></a>

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.

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

1. Facoltativamente, interroga le metriche direttamente con ProMQL. Per ulteriori informazioni, consulta [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md).