Claude Code OpenTelemetry : paramètres gérés
Claude Code envoie sa télémétrie OpenTelemetry à l’adresse de collecte que nous vous donnons, dès que votre administrateur l’active. Il n’y a rien à installer : c’est un réglage de Claude Code, posé depuis la console claude.ai, sans toucher aux postes. Pour l’usage de Claude en entreprise, sièges et agents compris, voir Claude en entreprise.
Ce qu’il faut
Section intitulée « Ce qu’il faut »- Claude Code à jour sur les postes des développeurs, connecté au compte Claude Team ou Claude Enterprise de l’organisation.
- Le propriétaire ou le propriétaire principal de l’organisation claude.ai, pour régler les paramètres gérés.
- L’adresse de collecte et le jeton d’accès que nous vous donnons au lancement de l’audit.
Les variables
Section intitulée « Les variables »| Variable | Valeur | Rôle |
|---|---|---|
CLAUDE_CODE_ENABLE_TELEMETRY |
1 |
Active la télémétrie. |
OTEL_LOGS_EXPORTER |
otlp |
Envoie les événements. |
OTEL_METRICS_EXPORTER |
otlp |
Envoie les métriques. |
OTEL_EXPORTER_OTLP_PROTOCOL |
grpc |
Le protocole de l’adresse de collecte. |
OTEL_EXPORTER_OTLP_ENDPOINT |
l’adresse donnée | Où partent les données. |
OTEL_EXPORTER_OTLP_HEADERS |
Authorization=Bearer … |
Le jeton d’accès donné. |
OTEL_LOG_USER_PROMPTS |
1 |
Ajoute le texte des demandes, sans quoi le Cockpit ne peut pas lire les cas d’usage. |
OTEL_LOG_ASSISTANT_RESPONSES |
1 |
Ajoute le texte des réponses. |
OTEL_RESOURCE_ATTRIBUTES |
department=… |
Le pôle du poste, pour lire les résultats par pôle. Sans espace dans la valeur. |
Les étapes
Section intitulée « Les étapes »-
Écrire les paramètres gérés
Dans la console claude.ai, le propriétaire ouvre « Paramètres de l’organisation », puis « Claude Code », puis « Paramètres gérés ». Il place les variables dans le bloc
envet enregistre. Les paramètres atteignent chaque membre de l’organisation au lancement suivant de Claude Code.{"env": {"CLAUDE_CODE_ENABLE_TELEMETRY": "1","OTEL_LOGS_EXPORTER": "otlp","OTEL_METRICS_EXPORTER": "otlp","OTEL_EXPORTER_OTLP_PROTOCOL": "grpc","OTEL_EXPORTER_OTLP_ENDPOINT": "<adresse de collecte>","OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <jeton>","OTEL_LOG_USER_PROMPTS": "1","OTEL_LOG_ASSISTANT_RESPONSES": "1","OTEL_RESOURCE_ATTRIBUTES": "department=<pole>"}} -
Faire accepter l’adresse de collecte
Au lancement suivant de Claude Code, chaque développeur voit une fenêtre qui nomme l’adresse de collecte, et l’accepte une fois. Claude Code demande cet accord pour toute adresse d’envoi réglée à distance ; si le développeur refuse, Claude Code se ferme.
-
Vérifier l’arrivée
Après une première session de Claude Code, l’écran Sources de données du Cockpit montre la source et la date de son dernier envoi.
Sans la console : le fichier sur les postes
Section intitulée « Sans la console : le fichier sur les postes »Les paramètres de la console n’atteignent pas une session de Claude Code passée par Amazon Bedrock, Google Cloud ou Microsoft Foundry, ni une session connectée par une clé de la Claude Console. Dans ces cas, ou si vous gérez déjà vos postes avec un outil de gestion, placez le même bloc env dans le fichier de paramètres gérés de Claude Code, puis déployez-le sur les postes. L’emplacement du fichier selon le système est dans la documentation d’Anthropic sur les paramètres gérés.
Ce qui est mesuré, et ce qui ne l’est pas
Section intitulée « Ce qui est mesuré, et ce qui ne l’est pas »- Mesuré : chaque demande et chaque réponse, les requêtes au modèle avec le modèle, les tokens, le coût estimé et la durée, et le pôle si
OTEL_RESOURCE_ATTRIBUTESle donne. - Pas rétroactif : la mesure commence à l’activation ; les sessions antérieures ne sont pas récupérables.
- Pas couvert : les conversations de claude.ai et de l’application Claude, qui ont leur propre connecteur claude.ai.
Questions fréquentes
Section intitulée « Questions fréquentes »Les données passent-elles par Anthropic ?
Section intitulée « Les données passent-elles par Anthropic ? »Non. La télémétrie part du poste vers l’adresse de collecte réglée dans les paramètres ; elle ne passe pas par Anthropic.
L’API Analytics de Claude Code ne suffit-elle pas ?
Section intitulée « L’API Analytics de Claude Code ne suffit-elle pas ? »Elle donne des compteurs par personne et par jour : sessions, lignes de code, commits, coût. Elle ne dit pas à quoi servent les sessions. La télémétrie donne les demandes elles-mêmes, et c’est d’elles que se tirent les cas d’usage.
Pour voir ce que l'outil montre sur vos propres outils, prenez rendez-vous.