View a markdown version of this page

Configurez Claude Code avec un jeton porteur - Amazon CloudWatch
Conditions préalablesConfiguration de l'exportateur de métriquesAjouter des attributs d'identité et d'organisationVérifiez et visualisez

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurez Claude Code avec un jeton porteur

Sur ce chemin, Claude Code envoie des métriques OpenTelemetry (OTel) directement au point de terminaison des métriques OTLP CloudWatch natif d'Amazon et s'authentifie à l'aide d'un jeton porteur (une clé API de CloudWatch métriques). Aucun OpenTelemetry collecteur n'est requis. C'est le moyen le plus rapide pour un développeur individuel ou une petite équipe d'intégrer les métriques de Claude Code dans les tableaux de bord de Coding Agent Insights.

Important

Les jetons au porteur sont des informations d'identification à long terme. Nous les recommandons uniquement lorsque les AWS informations d'identification à court terme ne sont pas réalisables, par exemple lorsque des ordinateurs portables destinés aux développeurs ne sont pas disponibles à l'extérieur AWS. Pour les compromis en matière de sécurité et les conseils relatifs à la rotation des clés, voirConfiguration de l'authentification par jeton porteur pour Metrics. Organisations qui fédérent les identités par le biais de l'authentification unique d'entreprise devraient plutôt utiliser le déploiement d'entreprise avec Claude Apps Gateway. Consultez Configurer Claude Code avec la passerelle des applications Claude.

Conditions préalables

  • Claude Code est installé sur la machine du développeur.

  • Une méthode efficace pour Claude Code d'appeler un modèle à des fins d'inférence. Cette configuration de télémétrie est indépendante de l'inférence. Vous pouvez donc utiliser un compte Anthropic (le fournisseur Claude Code par défaut) ou Amazon Bedrock. Pour utiliser Amazon Bedrock à des fins d'inférence, consultez Claude Code sur Amazon Bedrock dans la documentation Claude Code.

  • Une clé d'API de CloudWatch métriques (jeton porteur), créée par un utilisateur IAM autorisé à utiliser CloudWatch des métriques. Pour connaître la procédure de création de l'utilisateur IAM et de génération de la clé, consultezConfiguration de l'authentification par jeton porteur pour Metrics.

Configuration de l'exportateur de métriques

Claude Code se configure OpenTelemetry par le biais de variables d'environnement. Définissez les variables suivantes dans le shell qui lance Claude Code (ou dans votre profil de shell) pour activer les métriques, sélectionnez le OTLP/HTTP protocole et pointez l'exportateur de métriques vers le point de terminaison CloudWatch des métriques avec votre jeton porteur dans l'Authorizationen-tête. Incluez le /v1/metrics chemin complet.

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

Traitez le jeton porteur comme un secret. Évitez de le transférer dans des profils de contrôle de source ou de shell partagés ou sauvegardés de manière non sécurisée. Faites pivoter la clé périodiquement, comme décrit dansConfiguration de l'authentification par jeton porteur pour Metrics.

Ajouter des attributs d'identité et d'organisation

Les tableaux de bord Coding Agent Insights regroupent l'utilisation par développeur, équipe, département et autres dimensions organisationnelles. Fournissez-les sous forme d'attributs de ressource OTel via la variable d'OTEL_RESOURCE_ATTRIBUTESenvironnement. Définissez les valeurs à partir de l'identité de votre développeur et de la structure de votre organisation.

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

Leur définition en tant qu'attributs de ressource (plutôt qu'en tant qu'attributs par point de données) correspond à la forme attendue par les tableaux de bord. Vous pouvez donc les regrouper par @resource.team.id@resource.department, et par étiquettes similaires. Claude Code estampille automatiquement les dimensions au niveau des métriques, telles que model et type sur les métriques.

Vérifiez et visualisez

Exécutez Claude Code pour générer des métriques, puis confirmez les données atteintes CloudWatch.

Pour vérifier les métriques

  1. Lancez une session Claude Code qui exécute certaines tâches.

  2. Dans la CloudWatch console, choisissez GenAI Observability, Coding Agent Insights, puis l'onglet Claude Code. Les métriques apparaissent généralement en quelques minutes.

  3. Vous pouvez éventuellement interroger les métriques directement avec ProMQL. Pour de plus amples informations, veuillez consulter Requête ProMAL.

Pour obtenir des conseils complets et continuellement mis à jour, consultez les conseils pour Claude Code avec Amazon Bedrock on GitHub.