结论先行:前端性能监控的正确形态是 RUM(真实用户监控):用 web-vitals 采 LCP/INP/CLS,用 Performance API 采导航与资源耗时,用全局错误钩子采 JS 异常,统一上报后按 p75 与错误率设告警。Lighthouse 只是调试工具,真实用户的设备与网络才是你的成绩单。没有告警的监控等于没有监控。
一、指标分层:先想清楚看什么
| 层 | 指标 | 采集方式 |
|---|---|---|
| 体验 | LCP、INP、CLS | web-vitals 库 |
| 网络 | TTFB、DNS/TCP/TLS 耗时 | Navigation Timing |
| 资源 | 图片/JS/CSS 耗时与体积 | Resource Timing |
| 稳定 | JS 错误率、Promise 拒绝、资源失败 | 全局错误钩子 |
| 业务 | 接口成功率、耗时 p95 | fetch 拦截统一上报 |
分层的意义在于定位:体验指标告诉你「用户觉得慢」,网络与资源指标告诉你「慢在哪一段」,业务指标告诉你「是不是接口拖了后腿」。
二、体验指标:web-vitals 上报
import {onLCP, onINP, onCLS, onTTFB} from 'web-vitals';
function send(metric) {
const body = JSON.stringify({
name: metric.name,
value: metric.value,
id: metric.id,
page: location.pathname
});
navigator.sendBeacon('/rum', body);
}
onLCP(send); onINP(send); onCLS(send); onTTFB(send);sendBeacon 在页面卸载时也能可靠发出,是上报首选。注意 INP 在页面隐藏时才最终定值,库已处理好时机,不要自己提前截断。上报字段带上版本号、设备档位与网络类型,后续才能做分群分析。
三、Performance API:网络与资源细节
const nav = performance.getEntriesByType('navigation')[0];
console.log('TTFB', nav.responseStart - nav.requestStart);
new PerformanceObserver(list => {
for (const e of list.getEntries()) {
if (e.duration > 50) {
report('longtask', { duration: e.duration, name: e.name });
}
}
}).observe({ type: 'longtask', buffered: true });Resource Timing 能定位「哪张图拖慢了 LCP」;跨域资源默认只有总耗时,需要对方返回 Timing-Allow-Origin 头才能看到分段细节。超过 50 毫秒的 Long Task 值得记录,它们是 INP 恶化的直接前兆。
四、错误上报:三类钩子一个都不能少
window.addEventListener('error', e => {
report('js_error', { msg: e.message, file: e.filename, line: e.lineno });
}, true);
window.addEventListener('unhandledrejection', e => {
report('promise', { msg: String(e.reason) });
});再加 fetch/XHR 拦截记录非 2xx 与超时,资源加载失败用捕获阶段的 error 事件兜住。上线版本务必把 sourcemap 上传到监控服务端(不要公开发布),否则压缩后的堆栈无法还原。上报带版本号与灰度标识,才能回答「是不是这次发版引入的」。
五、采样、隐私与成本
- 采样:体验指标全量或 10% 起步,错误全量;大流量站按用户 ID 哈希稳定采样,保证同一会话数据完整。
- 隐私:URL 去掉查询参数中的手机号、token;不采集输入内容;采集范围与隐私政策声明一致。
- 成本控制:上报合并批量发送,单页面设条数上限,防止错误风暴打爆自己的接收端。
- 去重:同一错误指纹在短时间窗口内合并计数,避免一个死循环错误刷出百万条记录。
六、告警:让数字变成行动
- 体验告警:LCP p75 连续 30 分钟超 2.5 秒、INP p75 超 200 毫秒,按页面维度触发。
- 稳定告警:JS 错误率环比突增 3 倍、单错误指纹影响用户数超阈值。
- 业务告警:核心接口成功率低于 99%、p95 耗时翻倍。
- 分级:P1 即时通知到人,P2 工单跟进;每条告警附最近发版记录,缩短定位时间。
告警阈值要定期校准:业务形态变了(比如上了大量视频内容),旧阈值会产生噪音,噪音多了团队就会忽略告警,监控随之失效。
七、看板设计:三张图够用
- 核心页面体验趋势:LCP/INP/CLS 的 p75 按天曲线,叠加发版标记。
- 错误 Top 榜:按影响用户数排序的错误指纹列表,附首次出现版本。
- 接口健康度:成功率与 p95 耗时矩阵,按接口分组。
看板给周会用,告警给值班用,两者数据同源、口径一致,避免「会上一个数、线上一套数」。
八、接口侧的可观测性:统一结构事半功倍
接口成功率统计最怕返回结构五花八门。api工厂(https://www.it120.cc/)的前后台接口统一返回 {code,data,msg},前端一个拦截器就能按 code 判定成败并上报,六端 SDK 行为一致,小程序与 Web 的监控口径天然统一。容量规划可参考其增值版 50000 QPS 规格(https://www.it120.cc/price.html),把接口耗时告警阈值与后端容量对齐,而不是拍脑袋定数字。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。