Saltar al contenido
Telemetry
Fiabilidad de la API receta SQL

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

Intermedioapi_requestsRevisado 2026-07-27Probado 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

¿Con qué rapidez está consumiendo la API su presupuesto de disponibilidad del 99,9 %?

Una tasa de error resulta operativamente útil cuando se compara con un objetivo de confiabilidad explícito. La tasa de quema expresa la tasa actual de solicitudes incorrectas como un múltiplo de la tasa que permite el SLO.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampHora de finalización de la solicitud en UTC.
status_codeInt64Código de estado de respuesta HTTP.
environmentUtf8Entorno de implementación.
DataFusionSQL

Copiar la consulta

sql
WITH hourly AS (
  SELECT
    date_trunc('hour', timestamp_utc) AS hour,
    COUNT(*) AS requests,
    SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END) AS bad_requests
  FROM api_requests
  WHERE timestamp_utc >= now() - INTERVAL '24 hours'
    AND environment = 'production'
  GROUP BY date_trunc('hour', timestamp_utc)
)
SELECT
  hour,
  requests,
  bad_requests,
  100.0 * bad_requests / NULLIF(requests, 0) AS error_rate_pct,
  (1.0 * bad_requests / NULLIF(requests, 0)) / 0.001 AS burn_rate
FROM hourly
ORDER BY hour;

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 de consumo de presupuesto de error por hora

El segmento de las 13:00 consumió el presupuesto a 3,72 veces la tasa sostenible.

hourrequestsbad_requestserror_rate_pctburn_rate
12:0018.42090,050,49
13:0019.110710,373,72
14:0018.780240,131,28

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

Hourly error-budget burn rate: gráfico estático de valores sintéticos de burn_rate del resultado del ejemplo Calculate API Error-Budget Burn Rate
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, 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

  1. 1Un objetivo de éxito del 99,9% permite una proporción de solicitudes incorrectas del 0,1% o 0,001.
  2. 2Dividir la proporción observada por 0,001 produce una tasa de consumo: 1× es exactamente sostenible, mientras que 3× consume el presupuesto tres veces más rápido.
  3. 3El CTE mantiene visible el denominador de la solicitud para que los cubos pequeños puedan tratarse por separado.

Casos extremos para decidir

  • Defina qué códigos de estado cuentan como malos para el SLI de cara al usuario; No todos los 5xx tienen el mismo impacto.
  • Utilice alertas de ventanas múltiples para la paginación de producción en lugar de un umbral horario ruidoso.
  • Excluya las comprobaciones sintéticas o el tráfico interno solo cuando la definición de SLO los excluya explícitamente.

Panel recomendado

  • Tendencia: burn_rate por hora
  • Estadística: presupuesto de error mensual restante
  • Tabla: rutas que contribuyen con la mayor cantidad de solicitudes incorrectas

Guía de alerta

Página solo cuando una ventana de tasa de grabación corta y larga supera los umbrales en un volumen de solicitudes significativo.

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