Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# OpenTelemetry Für GitHub Copilot einrichten
<a name="coding-agents-copilot"></a>

GitHub Copilot sendet OpenTelemetry (oTEL) -Metriken über Token-Nutzung, Anfragen, Tool-Aufrufe und Latenz aus. Wenn Sie diese Metriken an Amazon senden CloudWatch, werden sie auf der Registerkarte „ GitHub Copilot“ der Coding Agent Insights-Dashboards angezeigt. Weitere Informationen zu den Dashboards finden Sie unter. [Einblicke in Coding Agent](coding-agents-insights.md)

Copilot sendet OTLP-Metriken direkt an den Endpunkt der CloudWatch systemeigenen OTLP-Metriken und authentifiziert sich mit einem Bearer-Token (einem Metrik-API-Schlüssel). CloudWatch OpenTelemetry Es ist kein Collector erforderlich. Das Bearer-Token ist derzeit der unterstützte Pfad für Copilot.

**Anmerkung**  
In diesem Leitfaden wird nur beschrieben, wie die oTEL-Metriken von Copilot übermittelt werden. Dies ist unabhängig davon CloudWatch, wie Copilot ein Inferenzmodell aufruft. Copilot verwendet standardmäßig seine eigenen Modelle, aber Unternehmen können ihre eigenen Modellanbieterschlüssel mitbringen — einschließlich Amazon Bedrock. Weitere Informationen finden Sie in der [Copilot-Dokumentation unter Verwenden Sie Ihre eigenen API-Schlüssel](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys). GitHub 

**Wichtig**  
Inhaber-Token sind langfristige Zugangsdaten. Wir empfehlen sie nur dort, wo kurzfristige AWS Anmeldeinformationen nicht möglich sind, wie z. B. bei Laptops für Entwickler im Freien AWS. Informationen zu Kompromissen bei der Sicherheit und Hinweise zur Schlüsselrotation finden Sie unter. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Voraussetzungen
<a name="coding-agents-copilot-prereqs"></a>
+ GitHub Copilot ist auf einer Version installiert, die den Export von Metriken unterstützt. OpenTelemetry 
+ Ein aktives GitHub Copilot-Abonnement für Modellinferenz. Copilot verwendet standardmäßig seine eigenen Modelle. Um stattdessen Amazon Bedrock zu verwenden, konfigurieren Sie einen benutzerdefinierten Modellschlüssel, wie in [Verwenden Sie Ihre eigenen API-Schlüssel](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) in der GitHub Copilot-Dokumentation beschrieben.
+ Ein API-Schlüssel (Bearer-Token) für CloudWatch Kennzahlen, der von einem IAM-Benutzer erstellt wurde, der über Metrikberechtigungen verfügt. CloudWatch Informationen zum Verfahren, mit dem der IAM-Benutzer erstellt und der Schlüssel generiert wird, finden Sie unter. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Konfigurieren Sie den Metrik-Exporter
<a name="coding-agents-copilot-configure"></a>

Konfigurieren Sie den OpenTelemetry Copilot-Exporter so, dass Metriken mit Ihrem Bearer-Token im Header an den CloudWatch Metrik-Endpunkt gesendet werden. `Authorization` Legen Sie in der Umgebung, in der Copilot gestartet wird, die folgenden Umgebungsvariablen fest. Auf Einschalten `COPILOT_OTEL_ENABLED=true` einstellen. OpenTelemetry Copilot verwendet die OpenTelemetry Standardvariablen für alle Signale; metrikspezifische Überschreibungen werden nicht unterstützt. Stellen Sie `OTEL_EXPORTER_OTLP_ENDPOINT` den Basisendpunkt *ohne* den Pfad ein — der Exporter fügt den `/v1/metrics` Signalpfad für Sie an.

```
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}}"
```

**Anmerkung**  
Behandeln Sie das Inhaber-Token als geheim. Vermeiden Sie es, es der Quellcodeverwaltung oder gemeinsam genutzten Shell-Profilen zuzuweisen, und wechseln Sie den Schlüssel regelmäßig, wie unter beschrieben. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Fügen Sie Identitäts- und Organisationsattribute hinzu
<a name="coding-agents-copilot-attributes"></a>

Die Coding Agent Insights-Dashboards gruppieren die Nutzung nach Entwickler, Team, Abteilung und anderen organisatorischen Dimensionen. Stellen Sie diese als *oTEL-Ressourcenattribute* über die `OTEL_RESOURCE_ATTRIBUTES` Umgebungsvariable bereit. Legen Sie die Werte anhand der Identität Ihres Entwicklers und der Struktur Ihrer Organisation fest.

```
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}}"
```

## Überprüfen und ansehen
<a name="coding-agents-copilot-verify"></a>

Verwenden Sie Copilot, um Metriken zu generieren, und bestätigen Sie dann, ob die Daten erreicht wurden. CloudWatch

**Um Metriken zu verifizieren**

1. Verwenden Sie Copilot, um einige Arbeiten auszuführen, bei denen Telemetrie generiert wird.

1. Wählen Sie in der CloudWatch Konsole **GenAI Observability**, **Coding Agent Insights** und dann die Registerkarte Copilot. GitHub Metriken werden in der Regel innerhalb weniger Minuten angezeigt.

1. Fragen Sie die Metriken optional direkt mit PromQL ab. Weitere Informationen finden Sie unter [PromQL abfragen](CloudWatch-PromQL-Querying.md).