让摄取密钥远离浏览器
将一个小的白名单有效负载发送到应用程序拥有的端点，然后使用服务器端凭据和有限超时转发它。
选择框架
选择知道结果的边界
收集结果，而不是页面内容
使用路由模板、Web Vitals、受控错误类别和发布字段。排除原始 URL、DOM 文本、表单值、cookie 和任意消息。
将浏览器交付视为采样
导航、拦截器、连接和页面终止可能会丢失客户端事件。不要使用尽力而为的浏览器收集作为精确的计费或审计分类帐。
共享事件合约
保持第一个模式可互操作
- metric_name、metric_value、route_template、释放和 navigation_type
- 边缘区域、状态、duration_ms、缓存结果和环境
- 示例策略、同意状态、有界设备类别和相关 ID
使这些字段适应工作流程，但在多个服务依赖同一个表之前保持单位、状态类别、标识符和所有权明确。
验证
在发出警报之前练习故障路径
- 1检查生产浏览器捆绑包并确认它不包含 Telemetry API 密钥。
- 2拒绝未知来源、事件名称、字段、值和超大实体。
- 3行使同意、阻止传递、页面终止和速率限制。
- 4在每个 Web Vital、错误率或版本比较旁边查询样本计数。
实施指南
匹配框架、提供程序或运行时
首先验证一个端到端工作流程
创建一个免费的 API 密钥，选择最接近的运行时指南，并在扩大覆盖范围之前发送已知的成功和失败信息。