View a markdown version of this page

Einrichten Claude Codex Metriken in Amazon CloudWatch mit einem Inhaber-Token - Amazon CloudWatch
VoraussetzungenKonfigurieren Sie den Metrik-ExporterFügen Sie Identitäts- und Organisationsattribute hinzuVerifizieren und anzeigen

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.

Einrichten Claude Codex Metriken in Amazon CloudWatch mit einem Inhaber-Token

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

Wichtig

Inhaber-Token sind langfristige Anmeldeinformationen. Wir empfehlen sie nur, wenn kurzfristige AWS Anmeldedaten nicht möglich sind, wie z. B. Entwickler-Laptops im Freien AWS. Hinweise zu Sicherheitsabwägungen und Anleitungen zur Schlüsselrotation finden Sie unter. Inhaber-Token-Authentifizierung für Metriken einrichten Unternehmen, die Identitäten über Unternehmens-SSO bündeln, sollten stattdessen das Enterprise-Rollout mit Claude Apps Gateway nutzen. Siehe Claude Code mit dem Claude Apps Gateway einrichten.

Voraussetzungen

  • Claude Code ist auf dem Computer des Entwicklers installiert.

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

  • Ein CloudWatch Metrik-API-Schlüssel (Bearer-Token), der von einem IAM-Benutzer mit Metrikberechtigungen erstellt wurde. CloudWatch Informationen zum Verfahren, das den IAM-Benutzer erstellt und den Schlüssel generiert, finden Sie unter. Inhaber-Token-Authentifizierung für Metriken einrichten

Konfigurieren Sie den Metrik-Exporter

Claude Code konfiguriert OpenTelemetry mithilfe von Umgebungsvariablen. Stellen Sie die folgenden Variablen in der Shell ein, die Claude Code startet (oder in Ihrem Shell-Profil), um Metriken zu aktivieren, wählen Sie das OTLP/HTTP Protokoll aus und richten Sie den Metrik-Exporter auf den CloudWatch Metrik-Endpunkt mit Ihrem Bearer-Token im Header. Authorization Geben Sie den vollständigen /v1/metrics Pfad an.

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"
Anmerkung

Behandeln Sie das Inhaber-Token als Geheimnis. Vermeiden Sie es, es in Quellcodeverwaltungs- oder Shell-Profile zu übertragen, die gemeinsam genutzt oder unsicher gesichert werden. Drehen Sie den Schlüssel in regelmäßigen Abständen, wie unter beschrieben. Inhaber-Token-Authentifizierung für Metriken einrichten

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 bereit. Legen Sie die Werte fest, die sich aus der Identität Ihres Entwicklers und der Struktur Ihrer Organisation ergeben.

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 von den Dashboards erwarteten Form, sodass Sie nach und ähnlichen Bezeichnungen @resource.team.id gruppieren können. @resource.department Claude Code stempelt Dimensionen auf Metrikebene wie und automatisch auf die Metriken. model type

Verifizieren und anzeigen

Führen Sie Claude Code aus, um Metriken zu generieren, und bestätigen Sie dann, dass die Daten erreicht wurden CloudWatch.

Um Metriken zu verifizieren

  1. Führen Sie eine Claude Code-Sitzung aus, in der einige Arbeiten ausgeführt werden.

  2. Wählen Sie in der CloudWatch Konsole GenAi Observability, Coding Agent Insights und dann den Tab Claude Code. Metriken werden in der Regel innerhalb weniger Minuten angezeigt.

  3. Optional können Sie die Metriken direkt mit PromQL abfragen. Weitere Informationen finden Sie unter PromQL-Abfrage.

Die vollständige, ständig aktualisierte Anleitung finden Sie in der Anleitung für Claude Code mit Amazon Bedrock. GitHub