Ce produit n'est pas pris en charge par le
site Datadog que vous avez sélectionné. (
).
Aperçu
Lapdog est un outil de développement local pour LLM Observability. Il exécute un agent sur localhost:8126 qui capture chaque span, prompt, appel d’outil et coût de votre application LLM, ou d’un agent de codage tel que Claude Code, Codex ou Pi, et les transmet dans un tableau de bord accessible via votre navigateur à lapdog.datadoghq.com. Aucun compte Datadog n’est requis.
Lapdog est construit sur l’agent de test open-source Datadog APM test agent. Il peut également transférer la télémétrie capturée à Datadog afin que les mêmes données apparaissent dans LLM Observability aux côtés de votre trafic de production.
Ce que vous obtenez
- Traces par session avec invites, appels d’outils et réponses
- Utilisation des jetons et coût estimé, décomposé par entrée, sortie et hits de cache
- Friction d’autorisation : appels d’outils restreints et temps d’attente.
- Utilisation de la fenêtre de contexte et taux de hits de cache au cours de la session
- État en direct de l’agent de codage en cours d’exécution (en cours, inactif, bloqué)
Installer
brew install datadog/lapdog/lapdog
pipx install ddapm-test-agent
# or: pip install ddapm-test-agent
Pour Docker, pour l’installation à partir du code source et d’autres méthodes, consultez le guide d’installation de Lapdog.
Exécutez un agent de codage
Lapdog instrumente les agents de codage de bout en bout. Chaque invite, appel d’outil et demande d’autorisation devient un span dans une session que vous pouvez rejouer depuis le tableau de bord.
Démarre l’agent local, installe le plugin Claude Code de Lapdog et lance Claude Code.
Démarre l’agent local, puis lance Codex avec un proxy compatible OpenAI et un observateur JSONL qui capturent chaque demande LLM, appel d’outil et étape dans une session.
Démarre l’agent local, installe l’extension Pi de Lapdog et lance Pi avec LAPDOG_URL configuré.
Exécutez n’importe quelle commande avec ddtrace auto-instrumentation pointée vers l’agent local. Utile pour instrumenter votre propre application alimentée par LLM pendant le développement.
Remarque: lapdog claude et lapdog codex sont soutenus par un proxy : l’agent local de Lapdog se trouve dans le chemin des requêtes de modèle en direct. Gardez Lapdog en cours d’exécution jusqu’à ce que l’agent de codage quitte. Si vous arrêtez ou tuez Lapdog en cours de session, l’agent de codage lancé peut cesser de progresser sur les appels de modèle. Redémarrez l’agent de codage après avoir redémarré Lapdog. lapdog pi et les configurations en mode hook uniquement échouent en mode ouvert si Lapdog tombe : l’agent de codage continue de fonctionner, mais les données de capture sont perdues.
Voir les sessions
Tandis qu’une session est en cours, ouvrez lapdog.datadoghq.com. Le tableau de bord lit directement depuis votre agent local sur localhost:8126 ; aucune connexion ou compte Datadog n’est nécessaire.
Si vous avez changé le port local, remplacez-le depuis le badge Collecting sessions dans l’en-tête du tableau de bord.
Transférez les événements vers Datadog
Pour expédier simultanément les événements capturés vers LLM Observability dans Datadog, définissez votre clé API et passez --forward :
DD_API_KEY=<YOUR_API_KEY> lapdog --forward claude
Les spans transférés sont étiquetés source:lapdog afin que vous puissiez distinguer les sessions de développement du trafic de production.
Commandes utiles
| Commande | Ce qu’elle fait |
|---|
lapdog claude | Lancez Claude Code avec la capture configurée |
lapdog codex | Lancez Codex avec le proxy OpenAI et l’observateur JSONL configurés |
lapdog pi | Lancez Pi avec l’extension lapdog installée |
lapdog python app.py | Exécutez n’importe quelle application avec instrumentation de traçage |
lapdog start | Démarrez l’agent local en arrière-plan |
lapdog stop | Arrêtez l’agent en arrière-plan |
lapdog status | Affichez si l’agent est en cours d’exécution |
Pour la liste complète des options, exécutez lapdog --help.
Désinstaller
Suivez ces étapes pour supprimer Lapdog et l’état qu’il écrit dans votre répertoire personnel. Votre gestionnaire de paquets (Homebrew, pip ou pipx) ne nettoie que ce qu’il a installé ; il ne touche pas ~/.lapdog/, le plugin Claude Code, ou l’extension pi.
Arrêtez l’agent local :
Supprimez le plugin Claude Code (si installé) :
claude plugin uninstall lapdog@lapdog
claude plugin marketplace remove lapdog
Supprimez l’extension pi (uniquement si vous avez exécuté lapdog pi) :
rm -f ~/.pi/agent/extensions/lapdog.ts
Supprimez le répertoire de travail de Lapdog :
Désinstallez le paquet :
brew uninstall lapdog
brew untap datadog/lapdog
pipx uninstall ddapm-test-agent
# or: pip uninstall ddapm-test-agent
Lectures complémentaires
Documentation, liens et articles supplémentaires utiles:
