跳到正文
小佑Blog 站点标识小佑Bloglordblog.cn

前端埋点与监控:9KB 采集脚本的取舍

工具与模板更新 2026-11-12埋点采集

这套采集脚本压缩后 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 章有完整实现。

同方向的其他两期