跳转到内容
Telemetry
浏览文档

指南更新于 2026年7月28日阅读约需 2 分钟

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

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

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

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

前端版本让页面变慢时,全站评分无法指出哪条路由出了问题。记录每项浏览器指标的单位、路由和版本。比较足够多的样本,区分性能退化和正常波动,再把查询用于仪表板或故障调查。

设计有界浏览器事件

使用 metric_name、metric_value、metric_unit、route_template、release、threshold_version、passed 和 environment 的每个支持的测量发出一个事件。使用 /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 编辑团队负责维护本文;产品团队审核功能行为、示例和适用范围。

我们如何审核文档