Contrato de evento
Campos que espera la consulta
| Campo | Tipo | Por que existe |
|---|---|---|
| timestamp_utc | Timestamp | Solicitar tiempo de finalización. |
| release_version | Utf8 | Versión de la aplicación o identificador de compilación. |
| status_code | Int64 | Código de estado de respuesta HTTP. |
| latency_ms | Float64 | Duración de la solicitud en milisegundos. |
Copiar la consulta
SELECT
release_version,
COUNT(*) AS requests,
100.0 * SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END)
/ NULLIF(COUNT(*), 0) AS error_rate_pct,
approx_percentile_cont(latency_ms, 0.95) AS p95_latency_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '7 days'
AND release_version IS NOT NULL
GROUP BY release_version
HAVING COUNT(*) >= 100
ORDER BY error_rate_pct DESC, p95_latency_ms DESC;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
Tasa 5xx por lanzamiento
La versión 2026.07.27.2 tiene la tasa de error y latencia p95 más alta.
| release_version | requests | error_rate_pct | p95_latency_ms |
|---|---|---|---|
| 2026.07.27.2 | 22.640 | 1,82 | 1180 |
| 2026.07.27.1 | 18.110 | 0,44 | 620 |
| 2026.07.26.4 | 39.400 | 0,31 | 590 |
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
- 1La agrupación por lanzamiento mantiene separado el tráfico de lanzamiento superpuesto.
- 2La regla del volumen mínimo protege la comparación de pequeñas muestras canarias.
- 3Trate el resultado como una correlación: siga los desgloses de ruta, región, cliente y tipo de error antes de asignar la causa.
Casos extremos para decidir
- Las solicitudes sin un identificador de versión no pueden admitir el análisis de implementación.
- Una implementación gradual necesita una hora de inicio de la implementación y una participación del tráfico junto con estos agregados.
- No compare lanzamientos que sirvieron a rutas o segmentos de clientes fundamentalmente diferentes sin segmentación.
Panel recomendado
- Barras: error_rate_pct por lanzamiento
- Barras agrupadas: latencia p95 y volumen de solicitud
- Tabla: tipos de errores para la versión seleccionada
Guía de alerta
Alerta cuando la versión más reciente supera la versión estable anterior tanto en velocidad como en volumen mínimo.
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.