Observagent
Intégration CLI · Windows · macOS · Linux

Connectez Claude Code à Observagent.

Utilisez les exportateurs OpenTelemetry intégrés de Claude Code pour envoyer journaux, métriques et traces bêta directement à Observagent.

Choisir le système Vérifier la livraison
Claude CodeTélémétrie d'exécution
OTLP via HTTPSHTTP/protobuf
ObservagentJournaux + métriques + traces
Comment ça marche

Utiliser l'export OpenTelemetry intégré de Claude Code

Claude Code exporte les événements d'exécution en journaux OTLP, les compteurs d'usage en métriques OTLP, et les spans distribués optionnels en traces OTLP. Observagent accepte les trois signaux via OTLP/HTTP protobuf, donc cette intégration ne nécessite ni proxy local ni SDK supplémentaire.

  • Les journaux incluent les événements Claude Code tels que les requêtes API et l'activité des outils.
  • Les métriques incluent les sessions, l'usage de jetons, les estimations de coût, et l'activité de code prise en charge.
  • Les traces sont une fonctionnalité bêta de Claude Code et relient invites, requêtes de modèle, et exécution d'outils.
  • La télémétrie commence après configuration et redémarrage ; les sessions existantes ne sont pas réintégrées.
Avant de commencer

Offre minimum requise

Claude Pro (accès par abonnement).

  • Claude Free n’inclut pas Claude Code. Pro est le premier abonnement admissible ; les offres supérieures conviennent aussi lorsque l’accès à Claude Code est activé.
  • Vous pouvez aussi utiliser un accès API facturé via Claude Console ou un fournisseur cloud approuvé sans abonnement Claude. L’usage API est facturé séparément.
Accès ObservagentPréparez un projet Observagent avec la surveillance et les signaux nécessaires activés, ainsi qu’une clé de projet valide avec la permission telemetry:write.

Conditions examinées le .

Choisir le système

Étapes d'intégration

Sélectionnez une plateforme pour voir les commandes et chemins propres à votre ordinateur. La configuration du projet et la vérification de la livraison sont communes à toutes les plateformes.

WindowsPowerShell
  1. Étape 1

    Créer un projet et une clé de projet

    Dans les paramètres Observagent, créez ou sélectionnez un projet, activez Journaux, Métriques et Traces, puis activez la surveillance. Choisissez Connect source et générez une clé avec la permission telemetry:write. Copiez-la lorsqu’elle s’affiche.

    • Utilisez une clé distincte pour chaque projet et gardez-la hors du contrôle de version. Remplacer une connexion révoque son ancienne clé.
    • Le point de terminaison générique est https://dashboard.observagent.cloud.
  2. Étape 2

    Ouvrir vos paramètres Claude Code au niveau utilisateur

    Sauvegardez et modifiez ~/.claude/settings.json pour l’utilisateur qui lance Claude Code. Ajoutez env dans l’objet JSON de premier niveau existant au lieu de coller un second objet.

    • Sous Windows, le fichier utilisateur est normalement C:\Users\YOUR_NAME\.claude\settings.json.
    • Claude Code ignore les variables de destination OTLP dans le fichier .claude/settings.json du dépôt. Utilisez les paramètres utilisateur, les paramètres gérés ou le shell qui lance Claude Code.
    • Conservez un seul objet JSON de premier niveau valide. Fusionnez env avec les paramètres existants comme theme et autoUpdatesChannel.
    PowerShell
    claude --version
$config = Join-Path $HOME ".claude\settings.json"
New-Item -ItemType Directory -Force (Split-Path $config) | Out-Null
if (Test-Path $config) { Copy-Item $config "$config.backup" }
notepad $config
  3. Étape 3

    Ajouter les exportateurs OTLP

    Fusionnez ces valeurs dans les paramètres utilisateur existants et remplacez YOUR_PROJECT_KEY par la clé de projet complète. Conservez vos autres paramètres.

    • Utilisez un espace littéral après Bearer. N’utilisez pas Bearer%20YOUR_PROJECT_KEY : l’exportateur envoie %20 littéralement.
    • Utilisez le point de terminaison générique sans /v1/logs, /v1/metrics ou /v1/traces. Claude Code ajoute le chemin de chaque signal.
    ~/.claude/settings.json · JSON
    {
  "autoUpdatesChannel": "latest",
  "theme": "dark",
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA": "1",
    "OTEL_TRACES_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://dashboard.observagent.cloud",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer YOUR_PROJECT_KEY"
  }
}
  4. Étape 4

    Redémarrer Claude Code et vérifier la livraison

    Fermez complètement Claude Code, démarrez un nouveau processus avec un journal de débogage et effectuez une requête de modèle. Attendez jusqu’à 60 secondes pour l’intervalle d’export des métriques par défaut, puis vérifiez chaque signal activé dans les données de télémétrie Observagent.

    • Sélectionnez le projet Claude, Toutes les sources et une période qui inclut le test.
    • Recherchez claude_code.api_request, claude_code.token.usage ou claude_code.cost.usage et des spans récents. Le graphique d’usage affiche l’identifiant exact du modèle.
    • Les premières exportations de journaux, traces et métriques réussies indiquent SUCCESS dans le journal de débogage. Vérifiez les trois signaux séparément.
    PowerShell
    claude --debug-file "$env:TEMP\claude-otel-debug.log" -p "Reply with exactly: telemetry test"
Select-String -Path "$env:TEMP\claude-otel-debug.log" -Pattern "3P telemetry|OTLP|export|401|403|404|error" -CaseSensitive:$false
Dépannage

Diagnostiquer les échecs de l'exportateur

Utilisez les commandes de débogage de la dernière étape de configuration pour le système sélectionné ci-dessus.

  • Clé API de télémétrie manquante : utilisez un espace littéral après Bearer, confirmez que la vraie clé a remplacé le placeholder, et redémarrez Claude Code.
  • 401 Unauthorized : la clé est manquante, malformée, révoquée, expirée, ou appartient à une connexion remplacée.
  • 403 Forbidden : la surveillance est en pause, le signal est désactivé, ou la clé manque de telemetry:write.
  • 404 Not Found : utilisez le point de terminaison générique sans /v1/logs, /v1/metrics, ou /v1/traces.
  • Aucun modèle dans le graphique : démarrer une session ne suffit pas. Effectuez une requête de modèle et vérifiez un enregistrement de requête API, jeton, ou coût contenant model.
  • Erreur de paramètres : validez que settings.json contient un seul objet JSON de premier niveau valide.
Confidentialité

Garder le contenu masqué par défaut

Claude Code masque par défaut le texte des invites, les réponses de l'assistant, les arguments d'outils, et la sortie des outils. N'activez pas les variables d'export de contenu sauf si vos politiques de confidentialité et de conservation permettent que ces données soient stockées. Observagent applique ses propres contrôles de contenu côté serveur comme limite supplémentaire.

Les détails de configuration suivent la documentation de surveillance Claude Code d'Anthropic.