Saltar al contenido
Telemetry
Para equipos que solicitan a Claude Code que modifique aplicaciones de producción

Observabilidad Claude Code

Proporcione a Claude Code un mensaje que haga que la telemetría forme parte del paso de implementación en lugar de un proyecto de limpieza separado.

Revisado por el equipo de producto Telemetry en . Revisamos los campos de los eventos, las consultas sugeridas y los datos que deben excluirse. Quién revisa esta página

Flujos de trabajo del instrumento Claude CodeCopia el mensaje

Reutilice las mismas instrucciones revisadas en todos los repositorios con la guía de habilidades de telemetría del agente.md.

¿Por qué esto funciona?
  • Registros estructurados generados a partir del mismo contexto que el cambio de código.
  • Paneles y consultas SQL que los humanos pueden inspeccionar una vez finalizado el agente.
  • Guía de redacción primero para que las indicaciones, los secretos y las cargas útiles sin procesar permanezcan fuera de los datos del evento.
Ruta de evidencia de casos de uso

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. 1

    Establecer el límite

    Cree una cuenta Telemetry y una clave API.

  2. 2

    Captura el resultado

    Begin with agent_task_started, agent_task_completed, feature_used and document the grain of each event.

  3. 3

    probar las filas

    Revise las tablas, gráficos y alertas resultantes antes del envío.

  4. 4

    Toma la decisión

    ¿Qué funciones creadas por agentes se utilizan realmente después del lanzamiento?

Mensaje del agente

Pega esto en tu agente de codificación

Reemplazar YOUR_API_KEY después del registro, solicite al agente que ejecute el flujo del producto y verifique los primeros eventos.

aviso del agente

Mensaje de configuración Claude Code observability

text
Instrument this project with structured logs using /skill.md. Use this Telemetry API key: YOUR_API_KEY Anonymous keys support logging and synchronous SQL without signup. Claim the existing workspace at https://telemetry.sh/register with the same key before creating dashboards or alerts. If it is unclaimed, query the event to verify delivery and report which features need signup. Please: 1. Find the most important user-facing flows, background jobs, and AI/tooling workflows. 2. Add structured logging with snake_case table and field names. 3. Capture the key signals for each workflow, including status, latency, identifiers, and error context when relevant. 4. Run one real user-facing or operational flow through the instrumented application and verify its event appears en Telemetry. Do not use telemetry_quickstart for this milestone. 5. Run a read-only query over that real event, then create a high-level dashboard with charts and tables that summarize the most important signals in this project. 6. Tell me what you instrumented, which real flow you verified, which tables you created, and which dashboard views I should review first. Keep event payloads small and focused. Make dashboard labels and charts easy to scan.

Cree la clave API para este mensaje, obtenga una vista previa de un evento de agente en funcionamiento y reemplace la muestra cuando su aplicación esté lista.

Abra esta configuración gratis

Pasos de configuración

  1. 1Cree una cuenta Telemetry y una clave API.
  2. 2Pegue el mensaje en Claude Code al comienzo de una característica o pase de observabilidad.
  3. 3Solicite a Claude Code que ejecute el flujo de la aplicación, envíe eventos de prueba y cree un panel.
  4. 4Revise las tablas, gráficos y alertas resultantes antes del envío.

Eventos para capturar

agent_task_startedagent_task_completedfeature_usedapi_request_completedcheckout_completedbackground_job_failed

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.

Ciclo de vida del producto7 campos

user_signed_up

Un registro aceptado por usuario y cuenta.

Ver esquema
Análisis de producto8 campos

product_milestone_completed

Un hito completado por actor, cuenta y ocurrencia.

Ver esquema
Operaciones de agentes de IA10 campos

ai_agent_run_completed

Un resultado de terminal por ejecución de agente lógico.

Ver esquema

Funció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.

Explorar Paneles de controlLeer historias de clientes

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.

Explorar todas las recetas
Fiabilidad de la APIPrincipiante

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 abierta
Tareas en segundo planoPrincipiante

Medir 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 abierta
Análisis de productoIntermedio

Cree un embudo de registro para activación en SQL

¿Dónde se van los nuevos usuarios antes de alcanzar el primer valor?

Receta abierta
Colecciones de consultasFiabilidad de la API SQLTareas en segundo plano SQLAnálisis de producto SQL

Siguiente paso

Cree la clave API que utilizará su agente

El plan gratuito es suficiente para ejecutar el mensaje, enviar eventos de prueba y revisar el primer panel.

Colección de promptsFlujos de trabajo del instrumento Claude Code

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ágina

Configuración de Cursor Telemetry

Un mensaje de configuración copiable para agregar tablas de eventos, seguimiento de embudos y paneles desde Cursor.

Abrir página

Aviso 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