View a markdown version of this page

Configuration Claude Code statistiques sur Amazon CloudWatch avec un jeton au 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.

Configuration Claude Code statistiques sur Amazon CloudWatch avec un jeton au porteur

Sur cette voie, Claude Code envoie OpenTelemetry (OTel) des métriques 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 Coding Agent Insights.

Important

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

Conditions préalables

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

  • Méthode fonctionnelle permettant à Claude Code d'appeler un modèle 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 à partir d'un utilisateur IAM disposant d'autorisations de CloudWatch métriques. Pour la procédure qui crée l'utilisateur IAM et génère la clé, consultezConfiguration de l'authentification par jeton au porteur pour Metrics.

Configuration de l'exportateur de métriques

Claude Code se configure OpenTelemetry via des variables d'environnement. Définissez les variables suivantes dans le shell qui lance Claude Code (ou dans votre profil 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 du porteur comme un secret. Évitez de le confier à des profils de contrôle de source ou d'interpréteur de commandes partagés ou sauvegardés de manière non sécurisée. Faites tourner la touche périodiquement comme décrit dansConfiguration de l'authentification par jeton au 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 en tant qu'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

Les définir en tant qu'attributs de ressource (plutôt 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 des é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 statistiques

  1. Lancez une session Claude Code qui effectue un certain travail.

  2. Dans la CloudWatch console, choisissez GenAI Observability, Coding Agent Insights, puis l'onglet Claude Code. Les statistiques 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êtes ProMQL.

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