跳转到内容
Telemetry
前端可靠性 SQL查询示例

按路线和版本比较核心网络生命力

按稳定路线和释放比较 LCP、INP 和 CLS 样品,同时保持通过样品的百分比可见。

中级frontend_vital_events已审核 2026-07-28测试用 阿帕奇 DataFusion 45.2.0

审阅者 Telemetry产品团队 . SQL 兼容性、事件契约、合成输出和操作注意事项. 审查标准和所有权

问题已回答

哪个路线和版本的前端性能最弱?

当前端平均保留路线并释放边界时,它们就变得可行。此查询将键入的 Web-vital 样本按路线和版本转换为一行,然后按通过产品审核阈值的样本比例对结果进行排序。

活动合约

查询期望的字段

字段类型为什么存在
timestamp_utcTimestampUTC 测量时间。
route_templateUtf8没有用户或查询字符串值的稳定路由模板。
releaseUtf8前端版本标识符。
metric_nameUtf8受控 LCP、INP 或 CLS 指标名称。
metric_valueFloat64以其记录单位表示的度量值。
passedBoolean示例是否通过了产品的版本阈值。
environmentUtf8部署环境。
DataFusion SQL

复制查询

sql
SELECT
  route_template,
  release,
  COUNT(*) AS samples,
  AVG(CASE WHEN metric_name = 'LCP' THEN metric_value ELSE NULL END) AS avg_lcp_ms,
  AVG(CASE WHEN metric_name = 'INP' THEN metric_value ELSE NULL END) AS avg_inp_ms,
  AVG(CASE WHEN metric_name = 'CLS' THEN metric_value ELSE NULL END) AS avg_cls,
  100.0 * SUM(CASE WHEN passed THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS passing_samples_pct
FROM frontend_vital_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY route_template, release
ORDER BY passing_samples_pct ASC, route_template, release;

此只读查询是针对空类型表计划和执行的 阿帕奇 DataFusion 45.2.0。确定性样本输出是综合的并单独审查;根据您自己的数据验证字段类型、阈值和业务定义。 阅读测试方法。

查询结果

通过路由传递前端样本

一半的合成 LCP、INP 和 CLS 样品通过 Checkout;搜索通过所有样本。

route_templatereleasesamplesavg_lcp_msavg_inp_msavg_clspassing_samples_pct
/checkoutweb-10262,8002200.150
/searchweb-10261,8501200.05100

综合示例输出。在将其用于操作决策之前,针对您自己的事件架构和阈值运行查询。

Passing frontend samples by route:来自 Compare Core Web Vitals by Route and Release 示例结果的合成 passing_samples_pct 值的静态图表
确定性示例输出的可索引 SVG。下载它以获取带有归属的文章、操作手册或设计评论。

重现示例

下载公共装置

JSON 包包含类型化事件契约, reproducible 输入行、确切的 SQL、预期输出、审阅注释和引擎版本。 CSV 包含显示的结果。

SQL 是如何工作的

  1. 1路由模板可防止每个原始 URL 或客户标识符出现一个图表系列。
  2. 2发布维度将性能变化转变为部署范围的调查。
  3. 3特定指标的平均值保留在单个通过样本摘要旁边,以便审核者可以看到哪个重要部分发生了变化。

需要决定的边缘情况

  • 使用经过审查的特定指标阈值,并在定义更改时记录其版本。
  • 仅当样本量可以保护比较免受噪声影响时,才对设备类别和地理位置进行细分。
  • 当 SQL 引擎和样本量允许时,在生产体验报告中优先使用百分位数而不是平均值。

推荐仪表板

  • 酒吧:passing_samples_pct(按路线和发布)
  • 趋势:全天 LCP、INP 和 CLS
  • 表:包含样本数量和版本变化的路线

警报指导

仅当样本量足够并且路线仍低于其审核的完整存储桶性能目标时才发出警报。

读取警报设置

让查询示例发挥作用

相关埋点和指南

定义源数据

此分析的事件模式

继续分析

在真实事件中运行它

创建表,调整字段并保存结果

免费开始,发送结构化事件,并将查询结果用作图表、共享仪表板小部件或警报输入。

获取 API 密钥