View a markdown version of this page

Richten Sie Claude Code mit einem Inhaber-Token ein - Amazon CloudWatch
VoraussetzungenKonfigurieren Sie den Metrik-ExporterFügen Sie Identitäts- und Organisationsattribute hinzuÜberprüfen 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 Claude Code mit einem Inhaber-Token ein

Auf diesem Pfad sendet Claude Code OpenTelemetry (OTel) -Metriken direkt an den Endpunkt für CloudWatch native OTLP-Metriken von Amazon und authentifiziert sich mit einem Bearer-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 integrieren.

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 Organizations, die ihre Identität über Unternehmens-SSO bündeln, sollten stattdessen den Enterprise-Rollout mit Claude Apps Gateway verwenden. 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. Diese Telemetrieeinrichtung ist unabhängig von Inferenzen, sodass Sie entweder ein Anthropic-Konto (den standardmäßigen Claude Code-Anbieter) oder Amazon Bedrock verwenden können. Informationen zur Verwendung von Amazon Bedrock als Inferenz finden Sie unter Claude Code on Amazon Bedrock in der Claude Code-Dokumentation.

  • Ein API-Schlüssel (Bearer-Token) für CloudWatch Kennzahlen, der von einem IAM-Benutzer mit Metrikberechtigungen erstellt wurde. CloudWatch Informationen zum Verfahren, mit dem der IAM-Benutzer und der Schlüssel erstellt werden, finden Sie unter. Einrichtung der Bearer-Token-Authentifizierung für Metrics

Konfigurieren Sie den Metrik-Exporter

Claude Code konfiguriert OpenTelemetry über Umgebungsvariablen. Legen Sie die folgenden Variablen in der Shell fest, 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 mit Ihrem Bearer-Token im Header auf den CloudWatch Metrik-Endpunkt. 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 an Quellcodeverwaltungs- oder Shell-Profile zu übergeben, die gemeinsam genutzt oder unsicher gesichert werden. Drehen Sie den Schlüssel regelmäßig, wie unter beschrieben. Einrichtung der Bearer-Token-Authentifizierung für Metrics

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 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 Claude Code stempelt automatisch Dimensionen auf Metrikebene wie und auf die Metriken. model type

Überprüfen und ansehen

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

Um Metriken zu verifizieren

  1. Führen Sie eine Claude Code-Sitzung aus, die einige Arbeiten ausführt.

  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. 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 Claude Code with Amazon Bedrock on GitHub.