跳到主要内容
api工厂
性能优化

前端性能监控体系:埋点、Performance API、错误上报与告警

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:前端性能监控的正确形态是 RUM(真实用户监控):用 web-vitals 采 LCP/INP/CLS,用 Performance API 采导航与资源耗时,用全局错误钩子采 JS 异常,统一上报后按 p75 与错误率设告警。Lighthouse 只是调试工具,真实用户的设备与网络才是你的成绩单。没有告警的监控等于没有监控。

一、指标分层:先想清楚看什么

层指标采集方式
体验LCP、INP、CLSweb-vitals 库
网络TTFB、DNS/TCP/TLS 耗时Navigation Timing
资源图片/JS/CSS 耗时与体积Resource Timing
稳定JS 错误率、Promise 拒绝、资源失败全局错误钩子
业务接口成功率、耗时 p95fetch 拦截统一上报

分层的意义在于定位:体验指标告诉你「用户觉得慢」,网络与资源指标告诉你「慢在哪一段」,业务指标告诉你「是不是接口拖了后腿」。

二、体验指标:web-vitals 上报

js
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:网络与资源细节

js
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 恶化的直接前兆。

四、错误上报:三类钩子一个都不能少

js
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 上传到监控服务端(不要公开发布),否则压缩后的堆栈无法还原。上报带版本号与灰度标识,才能回答「是不是这次发版引入的」。

五、采样、隐私与成本

  1. 采样:体验指标全量或 10% 起步,错误全量;大流量站按用户 ID 哈希稳定采样,保证同一会话数据完整。
  2. 隐私:URL 去掉查询参数中的手机号、token;不采集输入内容;采集范围与隐私政策声明一致。
  3. 成本控制:上报合并批量发送,单页面设条数上限,防止错误风暴打爆自己的接收端。
  4. 去重:同一错误指纹在短时间窗口内合并计数,避免一个死循环错误刷出百万条记录。

六、告警:让数字变成行动

  • 体验告警:LCP p75 连续 30 分钟超 2.5 秒、INP p75 超 200 毫秒,按页面维度触发。
  • 稳定告警:JS 错误率环比突增 3 倍、单错误指纹影响用户数超阈值。
  • 业务告警:核心接口成功率低于 99%、p95 耗时翻倍。
  • 分级:P1 即时通知到人,P2 工单跟进;每条告警附最近发版记录,缩短定位时间。

告警阈值要定期校准:业务形态变了(比如上了大量视频内容),旧阈值会产生噪音,噪音多了团队就会忽略告警,监控随之失效。

七、看板设计:三张图够用

  1. 核心页面体验趋势:LCP/INP/CLS 的 p75 按天曲线,叠加发版标记。
  2. 错误 Top 榜:按影响用户数排序的错误指纹列表,附首次出现版本。
  3. 接口健康度:成功率与 p95 耗时矩阵,按接口分组。

看板给周会用,告警给值班用,两者数据同源、口径一致,避免「会上一个数、线上一套数」。

八、接口侧的可观测性:统一结构事半功倍

接口成功率统计最怕返回结构五花八门。api工厂(https://www.it120.cc/)的前后台接口统一返回 {code,data,msg},前端一个拦截器就能按 code 判定成败并上报,六端 SDK 行为一致,小程序与 Web 的监控口径天然统一。容量规划可参考其增值版 50000 QPS 规格(https://www.it120.cc/price.html),把接口耗时告警阈值与后端容量对齐,而不是拍脑袋定数字。

文章标签

前端监控RUMPerformance API错误上报告警

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

浏览器缓存CDNCache-Control

浏览器缓存与 CDN 策略:Cache-Control、ETag 与指纹文件名

一份可直接抄用的缓存策略指南:指纹静态资源长缓存、HTML 协商缓存、接口不缓存,配合 CDN 缓存键与刷新规则,避免发版不生效与串数据事故。

性能优化约 5 分钟阅读
HTTP/3QUIC网络协议

HTTP/3 与 QUIC:前端能感知到什么收益

HTTP/3 普及已过临界点,前端无需改代码即可受益:1-RTT 握手、丢包不阻塞整条连接、网络切换不断连。文中给出启用、验证与监控的完整操作路径。

性能优化约 5 分钟阅读
Core Web VitalsINPLCP

Core Web Vitals 实战:LCP、INP、CLS 达标清单

以真实用户 p75 数据为准,给出 LCP、INP、CLS 三项核心指标的达标阈值、测量工具与逐项修复清单,并说明 INP 取代 FID 后前端优化重点的变化。

性能优化约 6 分钟阅读