Claude Code observability: de la implementación a la decisión
Un bucle de medición completo claude code observability conecta un flujo de trabajo propio, un contrato de evento limitado, un dispositivo controlado y una pregunta sobre la que alguien puede actuar.
- 1
Establecer el límite
Elige una acción completada de la aplicación para que Claude Code la instrumente.
- 2
Captura el resultado
Elige solo los campos necesarios para la acción seleccionada; excluye contenido privado y credenciales.
- 3
probar las filas
Ejecuta esa acción y verifica su evento almacenado con SQL. Un evento de ejemplo no completa la configuración.
- 4
Toma la decisión
Revisa el evento observado y las lagunas de cobertura antes de ampliar la instrumentación.
Mensaje del agente
Pega esto en tu agente de codificación
Sustituye YOUR_API_KEY por tu clave existente del lado del servidor o prueba el primer evento sin registrarte. Guardar paneles requiere reclamar el espacio de trabajo.
Mensaje de configuración Claude Code observability
Verifica una integración de Telemetry autenticada con un evento real de la aplicación usando /skill.md.
Usa esta clave API de Telemetry solo en código del lado del servidor: YOUR_API_KEY
Las claves anónimas permiten registrar eventos y ejecutar SQL síncrono sin registrarte. Reclama el espacio de trabajo existente en https://telemetry.sh/register con la misma clave antes de crear paneles o alertas. Si aún no se ha reclamado, consulta el evento para verificar el envío e indica qué funciones necesitan registro.
Por favor:
1. Elige una acción completada de la aplicación y captura event_name, service, route, status, duration_ms y release cuando estén disponibles.
2. No registres credenciales, cuerpos de solicitudes sin procesar ni contenido de clientes.
3. Ejecuta esa acción real una vez y verifica que su evento aparezca en el espacio de trabajo previsto. No uses telemetry_quickstart para este hito.
4. Revisa la respuesta del envío y consulta el evento para confirmar que coinciden la clave, el espacio de trabajo y la tabla. Si el envío falla, informa del código de respuesta sin revelar la clave.
5. Indica qué evento real se verificó, qué significa el resultado y cómo volver a consultarlo tras la siguiente ejecución de la aplicación.Empieza con una acción real de la aplicación y verifica su evento almacenado. Un evento de ejemplo solo sirve como diagnóstico.
Prueba con tu agente de programaciónPasos de configuración
- 1Empieza sin registrarte o usa tu clave API existente del lado del servidor.
- 2Elige una acción completada de la aplicación para que Claude Code la instrumente.
- 3Ejecuta esa acción y verifica su evento almacenado con SQL. Un evento de ejemplo no completa la configuración.
- 4Reclama el espacio de trabajo para guardar paneles y revisa el resultado antes de publicar.
Eventos para capturar
Preguntas que esto desbloquea
- ¿Qué funciones creadas por agentes se utilizan realmente después del lanzamiento?
- ¿Dónde están los cambios de Claude Code que crean riesgos de soporte o confiabilidad?
- ¿Qué flujos de trabajo deberían recibir alertas antes de que se agregue más automatización?
Ejemplos de esquemas de eventos
Esquemas de eventos para este flujo de trabajo
Revise el detalle de la fila, el límite de emisión, los tipos requeridos, las clases de privacidad, la carga útil de ejemplo y la lista de verificación de validación antes de adaptar una consulta o fragmento a producción.
user_signed_up
Un registro aceptado por usuario y cuenta.
Ver esquemaproduct_milestone_completed
Un hito completado por actor, cuenta y ocurrencia.
Ver esquemaai_agent_run_completed
Un resultado de terminal por ejecución de agente lógico.
Ver esquemaFunción relacionada del producto
Continúe este flujo de trabajo en Paneles de control
Convierta una consulta de ingresos o un producto validado en una superficie de decisión enfocada.
Recetas SQL relacionadas
Más ejemplos de SQL
Ejecute la consulta en los campos estructurados de este flujo de trabajo, inspeccione el resultado del ejemplo y convierta una respuesta útil en un panel o alerta.
Calcular la tasa de errores de API por ruta
¿Qué rutas de API tienen la mayor tasa de errores 5xx con al menos 20 solicitudes?
Receta abiertaMedir el reintento del trabajo en segundo plano y la tasa de fallas
¿Qué trabajos en segundo plano consumen más reintentos o aún fallan?
Receta abiertaCree un embudo de registro para activación en SQL
¿Dónde se van los nuevos usuarios antes de alcanzar el primer valor?
Receta abiertaSiguiente paso
Verifica un evento real de la aplicación
Envía y consulta un evento real sin registrarte. Reclama el espacio de trabajo para guardar paneles.
Páginas relacionadas
Agente de IA Telemetry y observabilidad
Instrumente la telemetría del agente de IA para ejecuciones, llamadas de herramientas, reintentos, latencia, costo del modelo, fallas y resultados aceptados en tablas de eventos listas para SQL.
Abrir páginaConfiguración de Cursor Telemetry
Un mensaje de configuración copiable para agregar tablas de eventos, seguimiento de embudos y paneles desde Cursor.
Abrir páginaAviso de instrumentación Codex
Un mensaje enfocado que solicita a Codex que instrumente el resto del producto, verifique eventos y resuma las brechas de cobertura.
Abrir página