跳转到内容
Telemetry
浏览文档
指南更新于 2026年7月28日由 Telemetry 编辑团队和产品团队审核阅读约需 2 分钟

让编程智能体使用这篇文档

打开 Claude Code、Codex、Cursor 或其他编码代理的集中提示包,然后将其适应此处介绍的工作流程。

本页内容
  1. 设计有界浏览器事件
  2. 比较路线和版本
  3. 搭建释放护栏

使用 SQL 进行前端可靠性监控

前端可靠性不仅仅是单个站点范围的性能得分。一项有用的调查需要单独的指标、其单位、稳定的路线、前端版本以及足够的样本来区分回归和普通变化。结构化浏览器事件使这些边界变得明确,并让相同的 SQL 支持发布审核、仪表板和事件响应。

设计有界浏览器事件

使用 metric_namemetric_valuemetric_unitroute_templatereleasethreshold_versionpassedenvironment 的每个支持的测量发出一个事件。使用 /projects/:id 等路由,切勿使用原始 URL。仅当有界设备类改变实际决策并且该段将收到足够的样本时才添加有界设备类。

请勿收集查询字符串、DOM 内容、表单值、cookie、授权数据或不受限制的用户标识符。保留阈值版本,因为定义和产品目标可以独立于代码发布而更改。

比较路线和版本

核心 Web Vitals SQL 配方 将 LCP、INP 和 CLS 测量数据集中到每条路线和发布的一行中。它在指标平均值旁边保留样本计数和通过样本百分比,包括确定性输入行,并且可以在 浏览器 SQL 游乐场 中运行。

按以下顺序使用结果:

  1. 确认样品体积和观察窗口具有可比性。
  2. 找到通过采样率最弱的路线并发布。
  3. 检查发生移动的个人生命体,而不是将摘要视为原因。
  4. 将当前版本与之前的版本进行比较,并验证完整时间段内的恢复情况。

生产报告通常受益于百分位数和平均值。添加时保留相同的路线、版本、指标和单位合同。

搭建释放护栏

仪表板应显示样本计数、LCP、INP、CLS 和阈值版本。释放护栏应要求审查最小量和持续回归。它不应该因为一个稀疏的设备或路由段而阻止部署。

前端性能用例 提供仪器提示和检查清单。使用 浏览器遥测代理指南 将 Telemetry API 密钥保留在服务器端并强制执行列入白名单的浏览器合约。当缓慢的页面可能源自后端路由或依赖项时,将浏览器体验与 API 可靠性 SQL 配对。

相关产品功能

对结构化事件表运行只读 DataFusion SQL 并重用结果。

内容责任与技术参考

Telemetry 编辑团队负责维护本文;产品团队审核功能行为、示例和适用范围。

查看编辑规范