Saltar al contenido
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

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.
  • Revisa el evento verificado y el SQL antes de añadir paneles guardados.
  • 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

    Elige una acción completada de la aplicación para que Claude Code la instrumente.

  2. 2

    Captura el resultado

    Elige solo los campos necesarios para la acción seleccionada; excluye contenido privado y credenciales.

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

aviso del agente

Mensaje de configuración Claude Code observability

text
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ón

Pasos de configuración

  1. 1Empieza sin registrarte o usa tu clave API existente del lado del servidor.
  2. 2Elige una acción completada de la aplicación para que Claude Code la instrumente.
  3. 3Ejecuta esa acción y verifica su evento almacenado con SQL. Un evento de ejemplo no completa la configuración.
  4. 4Reclama el espacio de trabajo para guardar paneles y revisa el resultado antes de publicar.

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

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.

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.

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

Siguiente 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