Saltar al contenido
Telemetry
Explorar documentación
GuíasActualizado el 29 de julio de 2026Revisado por los equipos editorial y de producto de Telemetry2 min de lectura

Usa esta documentación con tu agente de programación

Abra un paquete de mensajes enfocados para Claude Code, Codex, Cursor u otro agente de codificación, luego adáptelo al flujo de trabajo que se describe aquí.

En esta página
  1. Definir una fila de impacto
  2. Alcance del incidente
  3. Verificar recuperación

Análisis de impacto del cliente con SQL

Una tasa de error interno no establece el impacto en el cliente. La respuesta a incidentes necesita un resultado del producto documentado: pago fallido, exportación retrasada, datos no disponibles u otro efecto controlado que un cliente pueda experimentar.

Definir una fila de impacto

Emitir o derivar una fila acotada por incidente y unidad de informe aprobada. Los campos útiles incluyen incident_id, account_id seudónimo, plan o nivel de servicio, impact_type controlado, affected, impact_duration_ms, entorno y hora UTC.

Mantener la población evaluada así como la población afectada. Si una unión encuentra sólo cuentas afectadas, el porcentaje resultante no tiene un denominador confiable. Evite nombres de clientes, correos electrónicos, cuerpos de solicitudes, mensajes de soporte y contenido sin procesar en la tabla agregada. Restrinja el desglose a nivel de cuenta a los respondedores aprobados.

Alcance del incidente

El impacto en el cliente receta SQL cuenta las cuentas evaluadas y afectadas por plan, calcula la participación afectada y promedia la duración solo para las filas afectadas. Su accesorio muestra tres cuentas empresariales afectadas y dos cuentas iniciales afectadas.

Utilice la consulta después de la detección del nivel de servicio:

  1. Verificar el inicio del incidente y el resultado del producto afectado.
  2. Cree la población de cuentas evaluadas para la misma ventana completa.
  3. Compare el impacto por plan, región, ruta u otra dimensión delimitada revisada.
  4. Realice un seguimiento de las cuentas recientemente afectadas y recuperadas como flujos separados.
  5. Preservar la consulta, definición y resultado en el registro de incidentes.

No equipare un plan superior con un mayor impacto humano sin una política de respuesta aprobada. El plan es una dimensión de priorización, no un sustituto de los requisitos contractuales o de seguridad.

Verificar recuperación

La recuperación significa que el flujo de trabajo visible para el cliente vuelve a tener éxito y que los reintentos retrasados ​​o los trabajos se han agotado. Una marca de tiempo de reversión por sí sola no es una prueba. Continúe observando los depósitos completos y asegúrese de que el volumen de solicitudes no desaparezca.

El esquema del evento incident_impact_observed proporciona un contrato inicial a nivel de campo. El guía de respuesta a incidentes cubre la detección, el alcance de la ruta y la liberación, los cronogramas y la recuperación. El Caso de uso de confiabilidad API proporciona la estrategia de medición más amplia que puede alimentar el análisis de impacto.

Función relacionada del producto

Ejecute DataFusion SQL de solo lectura sobre tablas de eventos estructurados y reutilice el resultado.

Responsabilidad y referencias técnicas

El equipo editorial de Telemetry es responsable de esta explicación; el equipo de producto revisa el comportamiento, los ejemplos y las limitaciones.

Consultar los criterios editoriales