Saltar al contenido
Telemetry
Ejemplo de panel

Confiabilidad y latencia de API panel

Compare el tráfico, la tasa de errores y la latencia de cola por punto final mientras conserva suficiente volumen para juzgar si un percentil es estable.

Revisado por el equipo de producto Telemetry en . Decisión, grano de evento, métricas, DataFusion SQL, resultado sintético, suposiciones, actualidad y límite de interpretación. Revisar los estándares y la propiedad

Grano en hilera

Un resultado de solicitud de terminal antes de agrupar por plantilla de ruta.

Decisión apoyada

Priorice un punto final para comparar versiones, inspeccionar dependencias o revisar reversiones.

Contrato métrico

Pon el denominador y las unidades al lado del gráfico.

Adapte estas denominaciones a su contrato conservando el grano declarado. Inspeccione el esquema de eventos vinculados antes de asignar campos de los productores de producción.

  • Volumen de solicitud
  • Tasa de error
  • latencia p50
  • latencia p95
Inspeccionar el esquema del evento.
SQL completo DataFusion

Revisar la consulta antes de adaptar los campos.

Esta consulta pública es una definición inicial. Agregue un filtro de tiempo limitado, una política de segmento completo, un entorno y un volumen mínimo apropiados para su contrato de evento de producción.

SELECT
  endpoint,
  COUNT(*) AS requests,
  ROUND(
    100.0 * SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0),
    2
  ) AS error_rate_pct,
  approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
  approx_percentile_cont(latency_ms, 0.95) AS p95_ms
FROM api_requests
GROUP BY endpoint
ORDER BY error_rate_pct DESC, requests DESC;
Suposiciones de datos

Pruébelos antes de publicar el resultado.

  • Los valores de los puntos finales son plantillas de ruta limitadas en lugar de URL sin formato.
  • La latencia utiliza una definición de milisegundos de un extremo a otro entre los productores.
  • Los gráficos operativos omiten el período de tiempo incompleto más reciente.
Revisión de consultas

Comprobaciones que mantienen el panel confiable

  • Agregue un filtro de tiempo limitado antes de usar esta consulta en producción.
  • Mantenga el volumen de solicitudes al lado de cada percentil y tasa.
  • Segmente por versión y tipo de error después de detectar una regresión.

Límite de interpretación

Lo que este resultado no puede probar por sí solo

Muestre siempre el recuento de solicitudes junto a un percentil. Un p95 alto de un grupo pequeño no equivale a un impacto amplio en el cliente.

Ejemplos de paneles relacionados

Validar la definición con datos conocidos.

Ejecute un dispositivo con casos conocidos de éxito, error, faltantes, duplicados y límites antes de conectar la consulta a un panel de producción o alerta.