前端埋点与监控:9KB 采集脚本的取舍
这套采集脚本压缩后 9KB,采 6 个指标:LCP、INP、CLS、首字节、JS 报错率、资源失败率。采样率 30%,上报成功率 98.6%,剩下 1.4% 在网络断开时进了本地队列。
这一期要解的问题
埋点脚本最容易变成第二个业务代码库。加一个指标就加一个监听,加一个维度就多一个字段,半年后脚本 60KB,自己拖慢了自己要监控的页面。
这一期把指标砍到 6 个,每个都写清“为什么是它、它替代了谁”。采样率按页面类型分档,首屏 100% 采、内页 30% 采,队列在离线时落本地,恢复后补发。
六个指标与取舍
- 指标 1 LCP:只采首屏最大内容绘制,不采每张图的加载时间
- 指标 2 INP:交互延迟取 98 分位,不用平均值掩盖长尾
- 指标 3 CLS:布局偏移只算首屏 5 秒内,避免滚动误报
- 指标 4 首字节:区分 CDN 命中与回源,靠响应头判断
- 指标 5 JS 报错率:按错误指纹聚合,同一错误只报一次
- 指标 6 资源失败率:只统计 JS 与 CSS,图片失败单独走降级
- 第 7 章 采样:首屏 100%、内页 30%、接口异常 100%
- 第 8 章 上报:sendBeacon 优先,失败落 localStorage,恢复后补发
// 第 8 章:优先 sendBeacon,失败回落到本地队列
function report(payload) {
const body = JSON.stringify(payload);
if (navigator.sendBeacon && navigator.sendBeacon(ENDPOINT, body)) return;
try {
const q = JSON.parse(localStorage.getItem('xy-q') || '[]');
q.push(payload);
localStorage.setItem('xy-q', JSON.stringify(q.slice(-50)));
} catch (e) { /* 隐私模式下忽略 */ }
}
参数与交付
| 项目 | 内容 |
|---|---|
| 难度 | 中等,需了解 PerformanceObserver |
| 章节 | 8 章,含完整采集脚本与服务端接收要点 |
| 实测时长 | 6 小时(读 4 小时 + 接入 2 小时) |
| 验证环境 | Chrome 142 / Safari 26.0 / 移动端 Chrome 142 |
| 前置知识 | 知道 PerformanceObserver 与 sendBeacon |
| 配套资源 | 9KB 脚本、采样配置、离线队列实现、指标口径表 |
| 更新节奏 | 每季度按指标口径变化复核 |
| 阅读授权 | 单账号,可读 24 个月 |
三个会用到它的场合
不知道线上到底慢在哪
本地跑分都是绿的,用户还在说卡。6 个指标按页面类型分组后,能直接看出是首屏资源慢还是交互长尾,不必再靠猜。
上报量把服务端压垮
全量上报一天 1200 万条,服务端撑不住。按页面类型分档采样后降到 380 万条,关键页仍然 100% 覆盖,指标置信区间没有明显变宽。
移动端网络抖动导致数据缺失
移动端断网比例能到 8%。第 8 章的本地队列让上报成功率从 91.2% 提到 98.6%,补发时按时间戳排序,不会污染分位数计算。
和常见讲法差在哪
- 指标只有 6 个,每个都写了“替代了谁”。多数方案上来就是 20 个指标,最后没人看。
- 采样率不是拍脑袋定的,文中给了按页面类型与置信区间反推的过程,包括 30% 这个数字的误差范围。
- 上报失败的处理单独一章,含隐私模式下的降级与队列上限,这些细节决定了数据能不能信。
交付周期与阅读节奏
开通 10 分钟内可读,脚本与队列实现随页面下载。8 章建议一天读完,第 1—4 章看指标口径,第 5—6 章看实现,第 7—8 章在接入前读。中位耗时 6 小时,接入 2 小时左右。
服务条款
14 天内可退。脚本可商用,可修改。指标口径若因浏览器规范调整而变化,会在季度更新里补说明与新的阈值;补丁附前后数据对比,便于你判断是否需要回填历史数据。
选型建议
日活低于 1000 的站点,直接用一个现成的分析工具更省事,自建采集的收益不够。值得自建的是三种:日活超过 5 万、需要按页面类型看指标、或者有合规要求不能把数据给第三方。第三种在内部系统里很常见。
读完常见的问题
- 会不会采集个人信息?
- 不会。脚本不写 cookie、不取 UA 全串、不采 URL 查询参数,只上报页面路径与指标值,路径在服务端再做聚合。
- 9KB 是压缩前还是压缩后?
- 压缩后。源文件 24KB,gzip 后 9KB,文中给了拆解:6 个指标各占多少字节。
- INP 怎么取 98 分位?
- 本地先按 100 次交互滚动统计,上报 p98 值而非全部原始值,第 4 章有完整实现。