发布可观测性覆盖范围 | SaaS SQL 实验室

基础中级

在比较回归之前审核发布覆盖率

产品和 API 事件是否足够好地覆盖相同的版本以进行回归比较？

在计算速率之前构建一个共享的发布主干，因此缺失的埋点保持为空，而不是看起来完美的可靠性。

只读 SQL

WITH releases AS (
  SELECT release FROM product_events
  UNION
  SELECT release FROM api_requests
),
product_coverage AS (
  SELECT
    release,
    COUNT(*) AS product_events,
    SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END)
      AS successful_product_events
  FROM product_events
  GROUP BY release
),
api_coverage AS (
  SELECT
    release,
    COUNT(*) AS api_requests,
    SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END) AS api_errors
  FROM api_requests
  GROUP BY release
)
SELECT
  releases.release,
  COALESCE(product.product_events, 0) AS product_events,
  COALESCE(product.successful_product_events, 0)
    AS successful_product_events,
  COALESCE(api.api_requests, 0) AS api_requests,
  COALESCE(api.api_errors, 0) AS api_errors,
  ROUND(
    100.0 * api.api_errors / NULLIF(api.api_requests, 0),
    1
  ) AS api_error_pct
FROM releases
LEFT JOIN product_coverage AS product
  ON product.release = releases.release
LEFT JOIN api_coverage AS api
  ON api.release = releases.release
ORDER BY releases.release;

数据集和查询保留在此浏览器中。

Published expected result

按版本划分的 API 请求覆盖率

图表值

release	product_events	successful_product_events	api_requests	api_errors	api_error_pct
2026.07.1	13	12	0	0	—
2026.07.2	8	8	10	6	60

如何读取查询

发布主干包括任一源中存在的版本，而不是从恰好有行的表开始。
没有 API 请求的版本会保持空错误率，从而防止缺失的覆盖率显示为零百分比错误。
产品事件计数和 API 请求计数揭示了在做出回归声明之前总体是否具有可比性。

SQL 无法做出的决定

1定义哪些服务和客户端共享有意义的版本标识符。
2在比较比率之前需要最小覆盖范围和完整的观察窗口。
3将埋点变化与产品回归分开调查。

继续本课

功能推出分析模式采用秘诀按版本划分的 API 可靠性

保留结果

对您自己的事件运行此查询

仅当您准备好保存查询、连接真实事件并监视结果时，才创建空闲工作区。不需要信用卡。

保存我的活动