Descripción general

Lapdog es una herramienta de desarrollo local para LLM Observability. Ejecute un agente en localhost:8126 que capture cada span, prompt, llamada a herramienta y costo de su aplicación LLM, o de un agente de codificación como Claude Code, Codex o Pi, y transmita estos datos a un dashboard en el navegador en lapdog.datadoghq.com. No se requiere una cuenta de Datadog.

Lapdog está construido sobre el agente de prueba de código abierto Datadog APM test agent. También puede reenviar la telemetría capturada a Datadog para que los mismos datos aparezcan en LLM Observability junto con su tráfico de producción.

Lo que obtiene

• Trazas por sesión con prompts, llamadas a herramientas y respuestas
• Uso de tokens y costo estimado, desglosado por entrada, salida y aciertos de caché
• Fricción de permisos: llamadas a herramientas restringidas y tiempos de espera
• Uso de ventana de contexto y tasa de aciertos de caché durante la sesión
• Estado en vivo del agente de codificación en ejecución (ejecutándose, inactivo, bloqueado)

Instalar

brew install datadog/lapdog/lapdog

pipx install ddapm-test-agent
# or: pip install ddapm-test-agent

Para Docker, desde el código fuente y otros caminos de instalación, consulta la guía de instalación de Lapdog.

Ejecutar un agente de codificación

Lapdog instrumenta agentes de codificación de extremo a extremo. Cada prompt, llamada a herramienta y solicitud de permiso se convierte en un tramo en una sesión que puede reproducir desde el dashboard.

lapdog claude

lapdog codex

lapdog pi

lapdog python my_app.py

Nota: lapdog claude y lapdog codex están respaldados por proxy: el agente local de Lapdog se encuentra en la ruta de solicitud del modelo en vivo. Mantenga Lapdog en funcionamiento hasta que el agente de codificación salga. Si detiene o finaliza Lapdog a mitad de sesión, el agente de codificación lanzado puede dejar de avanzar en las llamadas al modelo. Reinicie el agente de codificación después de reiniciar Lapdog. lapdog pi y las configuraciones de hook-only fallan en modo abierto si Lapdog se detiene: el agente de codificación continúa ejecutándose, pero se pierden los datos capturados.

Ver sesiones

Mientras una sesión está en ejecución, abra lapdog.datadoghq.com. El dashboard lee directamente de su agente local en localhost:8126; no se requiere iniciar sesión ni tener una cuenta de Datadog.

Si ha cambiado el puerto local, sustitúyalo desde la Collecting sessions insignia en el encabezado del dashboard.

Reenviar eventos a Datadog

Para enviar eventos capturados a LLM Observability en Datadog de forma dual, configure su clave de API y pase --forward:

DD_API_KEY=<YOUR_API_KEY> lapdog --forward claude

Los tramos reenviados están etiquetados source:lapdog para que pueda distinguir las sesiones de desarrollo del tráfico de producción.

Comandos útiles

Para la lista completa de opciones, ejecute lapdog --help.

Desinstalar

Siga estos pasos para eliminar Lapdog y el estado que escribe en su directorio de inicio. Su gestor de paquetes (Homebrew, pip o pipx) solo limpia lo que instaló; no afecta ~/.lapdog/, el complemento Claude Code, ni la extensión Pi.

1. Detenga el agente local:

   lapdog stop
   

2. Elimine el complemento Claude Code (si está instalado):

   claude plugin uninstall lapdog@lapdog
   claude plugin marketplace remove lapdog
   

3. Elimine la extensión Pi (solo si ejecutó lapdog pi):

   rm -f ~/.pi/agent/extensions/lapdog.ts
   

4. Elimine el directorio de trabajo de Lapdog:

   rm -rf ~/.lapdog
   

5. Desinstale el paquete:

   brew uninstall lapdog
   brew untap datadog/lapdog
   

   pipx uninstall ddapm-test-agent
   # or: pip uninstall ddapm-test-agent
   

Lectura adicional

Más enlaces, artículos y documentación útiles:

README de Lapdog en GitHubGITHUB Instrumente su aplicación con LLM Observability SDK.DOCUMENTACIÓN Auto-instrumentación para LLM Observability.DOCUMENTACIÓN