跳转到内容
Telemetry
仪表板示例

API 可靠性和延迟 仪表板

按端点比较流量、错误率和尾部延迟,同时保留足够的量来判断百分位是否稳定。

审阅者 Telemetry产品团队 . 决策、事件粒度、指标、DataFusion SQL、综合结果、假设、新鲜度和解释边界. 审查标准和所有权

行纹

按路由模板分组之前,一个终端请求结果。

支持决策

优先考虑版本比较、依赖性检查或回滚审查的端点。

公制合约

将分母和单位放在图表旁边

使这些名称适应您的合同,同时保留声明的谷物。在映射来自生产生产者的字段之前检查链接的事件模式。

  • 请求量
  • 错误率
  • p50潜伏期
  • p95潜伏期
检查事件架构
完整的DataFusion SQL

在调整字段之前检查查询

此公共查询是一个起始定义。添加适合您的生产事件合同的有限时间过滤器、完整桶策略、环境和最小数量。

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;
数据假设

在发布结果之前证明这些

  • 端点值是有界路由模板而不是原始 URL。
  • 延迟使用跨生产者的端到端毫秒定义。
  • 运营图表省略了最新的不完整时间段。
查询审核

确保仪表板值得信赖的检查

  • 在生产中使用此查询之前添加有限时间过滤器。
  • 将请求量放在每个百分位数和费率旁边。
  • 检测到回归后按版本和错误类型进行细分。

解释边界

这个结果本身不能证明什么

始终在百分位数旁边显示请求计数。小群体的高 p95 并不等同于广泛的客户影响。

相关仪表板示例

用已知数据验证定义

在将查询连接到生产仪表板或警报之前,运行具有已知成功、失败、缺失、重复和边界情况的固定装置。