Saltar al contenido
Telemetry
Fiabilidad de la API receta SQL

Medir el impacto del incidente en el cliente por plan

Cuente las cuentas afectadas y la duración promedio del impacto por plan sin exponer los nombres de los clientes ni los datos de solicitudes sin procesar.

Intermedioincident_account_impact_eventsRevisado 2026-07-28Probado con Apache DataFusion 45.2.0

Revisado por el equipo de producto Telemetry en . Compatibilidad con SQL, contrato de eventos, resultados sintéticos y advertencias operativas. Revisar los estándares y la propiedad

Pregunta respondida

¿Cuántas cuentas se vieron afectadas por el incidente en cada plan?

Las tasas de error a nivel de servicio no responden a quién se vio afectado. Un evento de impacto limitado conecta un incidente con una cuenta seudónima, un plan, un tipo de impacto controlado y una duración para que los equipos de respuesta puedan priorizar la recuperación y la comunicación.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampHora de evaluación de impacto en UTC.
incident_idUtf8Identificador de incidentes estable.
account_idUtf8Identificador de cuenta seudónimo aprobado.
planUtf8Plan acotado o nivel de servicio.
impact_typeUtf8Categoría de impacto visible para el cliente controlada.
affectedBooleanSi la cuenta cumplió con la definición de impacto documentada.
impact_duration_msInt64Duración del impacto medida en milisegundos.
environmentUtf8Entorno de implementación.
DataFusionSQL

Copiar la consulta

sql
SELECT
  incident_id,
  plan,
  COUNT(*) AS assessed_accounts,
  SUM(CASE WHEN affected THEN 1 ELSE 0 END) AS affected_accounts,
  100.0 * SUM(CASE WHEN affected THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS affected_accounts_pct,
  AVG(CASE WHEN affected THEN impact_duration_ms ELSE NULL END)
    AS avg_impact_duration_ms
FROM incident_account_impact_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY incident_id, plan
ORDER BY affected_accounts DESC, plan;

Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.

Resultado de la consulta

Cuentas afectadas por plan

Tres cuentas empresariales y dos cuentas iniciales cumplen con la definición sintética de impacto de incidente.

incident_idplanassessed_accountsaffected_accountsaffected_accounts_pctavg_impact_duration_ms
incident-checkout-42enterprise437540.000
incident-checkout-42starter524020.000

Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.

Affected accounts by plan: gráfico estático de valores sintéticos de affected_accounts del resultado del ejemplo Measure Incident Customer Impact by Plan
SVG indexable de la salida del ejemplo determinista. Descárguelo para ver un artículo, un runbook o una revisión de diseño con atribución.

Reproducir el ejemplo

Descargar el accesorio público

El paquete JSON incluye el contrato de evento escrito, reproducible filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.

Cómo funciona el SQL

  1. 1El denominador de cuenta evaluada evita que una unión incompleta se haga pasar por una tasa de impacto baja.
  2. 2El plan es una dimensión de priorización limitada; la consulta no expone los nombres de los clientes.
  3. 3La duración del impacto se calcula solo para las cuentas afectadas, de modo que las filas no afectadas no acerquen el promedio a cero.

Casos extremos para decidir

  • Defina afectado una vez utilizando un resultado visible para el usuario, no simplemente un error interno correlacionado.
  • Una cuenta puede tener varios usuarios o regiones; Elija la unidad de informe antes de emitir filas.
  • Restrinja el desglose a nivel de cuenta y utilice el agregado solo para flujos de trabajo de respuesta aprobados.

Panel recomendado

  • Barras: affected_accounts por plano
  • Tendencia: cuentas recién afectadas y recuperadas
  • Tabla restringida: identificadores de cuenta aprobados y tipo de impacto

Guía de alerta

Utilice esta consulta para determinar el alcance y escalar después de la detección de incidentes; no cree una segunda página para cada fila a nivel de cuenta.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

Continuar el análisis

Ejecútelo en eventos reales.

Crea una tabla, adapta los campos y guarda el resultado.

Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.

Obtén una clave API