View a markdown version of this page

Richten Sie OpenAI Codex mit einem Bearer-Token ein - Amazon CloudWatch
VoraussetzungenKonfigurieren Sie den Metrik-ExporterFügen Sie Identitäts- und Organisationsattribute hinzuVerifizieren und ansehen

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.

Richten Sie OpenAI Codex mit einem Bearer-Token ein

Auf diesem Pfad sendet OpenAI Codex OpenTelemetry (OTel) -Metriken direkt an den Endpunkt der CloudWatch nativen OTLP-Metriken von Amazon und authentifiziert sich mit einem Bearer-Token (einem CloudWatch Metrik-API-Schlüssel). Es ist kein Collector erforderlich. OpenTelemetry Dies ist der schnellste Weg für einen einzelnen Entwickler oder ein kleines Team, Codex-Metriken in die Coding Agent Insights-Dashboards zu integrieren.

Wichtig

Inhaber-Token sind langfristige Referenzen. Wir empfehlen sie nur dort, wo kurzfristige AWS Zugangsdaten 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 Organizations, die Identitäten über Unternehmens-SSO bündeln, sollten stattdessen den Enterprise-Rollout verwenden. Siehe Richten Sie OpenAI Codex für einen Rollout im Unternehmen ein.

Voraussetzungen

  • OpenAI Codex ist auf dem Computer des Entwicklers installiert.

  • Eine funktionierende Methode für Codex, ein Modell zur Inferenz aufzurufen. Dieses Telemetrie-Setup ist unabhängig von Inferenzen, sodass Sie entweder ein OpenAI-Konto (den Standard-Codex-Anbieter) oder Amazon Bedrock verwenden können. Informationen zur Verwendung von Amazon Bedrock für Inferenzen finden Sie unter Amazon Bedrock in der OpenAI Codex-Dokumentation.

  • 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

Konfigurieren Sie den Metrik-Exporter

Codex liest seine Konfiguration von. ~/.codex/config.toml Fügen Sie einen [otel.metrics_exporter] Abschnitt hinzu, der auf den OTLP-Endpunkt der CloudWatch Metriken verweist und Ihr Bearer-Token im Header sendet. Authorization Geben Sie den vollständigen /v1/metrics Pfad an; Codex fügt ihn nicht für Sie an.

[otel]
environment = "production"

[otel.metrics_exporter]
otlp-http = { endpoint = "https://monitoring.region.amazonaws.com/v1/metrics", protocol = "binary", headers = { "Authorization" = "Bearer YOUR_API_KEY" } }
Anmerkung

Einige Codex-Versionen erweitern keine Umgebungsvariablen innerhalb von Header-Werten, sodass der API-Schlüssel inline angezeigt wird. config.tomlAls geheim behandeln: Beschränken Sie die Dateiberechtigungen (zum Beispielchmod 600 ~/.codex/config.toml) und überlassen Sie es nicht der Quellcodeverwaltung.

Fügen Sie Identitäts- und Organisationsattribute hinzu

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 in der Shell bereit, die Codex startet. 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"
Anmerkung

Wenn Sie diese als Ressourcenattribute (und nicht als Attribute pro Datenpunkt) festlegen, entspricht dies der Form, die die Dashboards erwarten, sodass Sie nach, und ähnlichen Bezeichnungen @resource.team.id gruppieren können. @resource.department Codex stempelt die Metriken automatisch mit Dimensionen auf Metrikebene, wie z. B. und. model token_type

Verifizieren und ansehen

Führen Sie Codex einige Runden lang aus, um Metriken zu generieren, und bestätigen Sie dann, ob die Daten erreicht CloudWatch wurden.

Um Metriken zu verifizieren

  1. Führen Sie eine Codex-Sitzung aus, die bestimmte Aufgaben ausführt (bitten Sie sie beispielsweise, einen Befehl auszuführen und eine Datei zu bearbeiten).

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

  3. Fragen Sie die Metriken optional direkt mit PromQL ab. Weitere Informationen finden Sie unter PromQL abfragen.

Die vollständigen, ständig aktualisierten Leitlinien finden Sie in den Leitlinien für Codex auf Amazon Bedrock unter. GitHub