Contrato de evento
Campos que espera la consulta
| Campo | Tipo | Por que existe |
|---|---|---|
| timestamp_utc | Timestamp | Tiempo de fracaso. |
| error_fingerprint | Utf8 | Grupo de errores normalizado estable. |
| team_id | Utf8 | Identificador seguro de la cuenta afectada. |
| status_code | Int64 | Código de estado HTTP. |
Copiar la consulta
SELECT
error_fingerprint,
COUNT(*) AS occurrences,
COUNT(DISTINCT team_id) AS affected_teams
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND status_code >= 500
AND error_fingerprint IS NOT NULL
GROUP BY error_fingerprint
ORDER BY affected_teams DESC, occurrences DESC
LIMIT 20;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
Equipos afectados por error de huella dactilar
El tiempo de espera del servicio de impuestos tiene menos repeticiones que el error de OAuth pero un impacto mucho más amplio.
| error_fingerprint | occurrences | affected_teams |
|---|---|---|
| checkout.tax_service_timeout | 184 | 73 |
| sync.oauth_token_expired | 920 | 18 |
| report.pdf_render_failed | 44 | 16 |
Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.
Reproducir el ejemplo
Descargar el accesorio público
El paquete JSON incluye el contrato de evento escrito, illustrative 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
- 1Una huella digital estable debería eliminar los ID de solicitud y otros fragmentos de mensajes volátiles.
- 2COUNT DISTINCT team_id mide la amplitud mientras que las ocurrencias miden la repetición.
- 3Ordenar por cuentas afectadas hace que la primera vista de clasificación se acerque más al impacto en el usuario.
Casos extremos para decidir
- El hash de un mensaje de error sin formato completo crea un nuevo grupo cada vez que cambian los identificadores.
- Las solicitudes anónimas o no autenticadas necesitan una dimensión de impacto diferente.
- No incluya seguimientos de pila sin procesar ni datos personales en el campo de agrupación.
Panel recomendado
- Barra: affected_teams por huella dactilar
- Tabla: ocurrencias y versión más reciente
- Tendencia: principales huellas dactilares a lo largo del tiempo
Guía de alerta
Alerta sobre una nueva huella digital que afecta a varias cuentas, no a cada excepción individual.
Leer configuración de alertaPon la receta a trabajar
Instrumentación y guías relacionadas.
Continuar el análisis
Calcular la tasa de errores de API por ruta
Utilice SQL para clasificar las rutas API según una tasa de error 5xx mientras protege el resultado del ruido de bajo volumen.
Receta abiertaCalcule la latencia API p50, p95 y p99
Compare la latencia media y de cola por punto final con SQL percentil compatible con DataFusion.
Receta abiertaCalcular la tasa de consumo de presupuesto de errores de API
Convierta los errores de solicitud por hora en una serie de tasa de quemado de SLO que muestre qué tan rápido se consume el presupuesto de errores permitido.
Receta abiertaEjecú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.