在 vite 项目中接入性能监控,核心做法是利用 `performanceobserver` api 监听 web vitals 指标,并将数据通过 `navigator.sendbeacon` 上报至服务端。具体实现时,需创建一个监控模块,初始化各类 observer 实例以捕获 lcp、fid 等关键指标,并在页面卸载或空闲时批量发送请求,从而在不阻塞主线程的前提下完成数据采集。

如何配置 PerformanceObserver 以捕获核心 Web Vitals 指标
要捕获核心性能指标,需要分别实例化针对 LCP(最大内容绘制)、FID(首次输入延迟)和 CLS(累积布局偏移)的 PerformanceObserver 实例。LCP 通常监听 largest-contentful-paint 类型,FID 监听 first-input 类型,而 CLS 则需要监听 layout-shift 类型并过滤掉由用户交互引起的偏移。每个观察者都需要配置 buffered: true 以确保能捕获到页面加载早期发生的事件,并通过回调函数将收集到的数据存入队列。

const metrics = {
lcp: null,
fid: null,
cls: 0
};
// 监听 LCP
new PerformanceObserver((entryList) => {
for (const entry of entryList.getEntries()) {
if (entry.entryType === 'largest-contentful-paint') {
metrics.lcp = entry.startTime;
}
}
}).observe({ type: 'largest-contentful-paint', buffered: true });
// 监听 FID
new PerformanceObserver((entryList) => {
for (const entry of entryList.getEntries()) {
if (entry.entryType === 'first-input') {
metrics.fid = entry.processingStart - entry.startTime;
}
}
}).observe({ type: 'first-input', buffered: true });
// 监听 CLS
new PerformanceObserver((entryList) => {
for (const entry of entryList.getEntries()) {
if (!entry.hadRecentInput) {
metrics.cls += entry.value;
}
}
}).observe({ type: 'layout-shift', buffered: true });
上述代码展示了如何独立设置三个观察者。LCP 获取的是时间戳,FID 计算的是处理延迟,CLS 则是累加所有非用户触发的布局偏移值。这些数据会被存储在 metrics 对象中,供后续上报使用。
如何实现低开销的数据上报机制
为了避免性能监控本身影响用户体验,上报操作应使用 navigator.sendBeacon 方法。该方法允许浏览器在页面卸载或后台异步发送数据,且不会阻塞页面关闭流程。我们可以封装一个 sendMetrics 函数,将收集的指标序列化为 JSON 字符串,并附加当前页面的 URL 和用户代理信息,然后发送到指定的监控端点。此外,可以结合 requestIdleCallback 在浏览器空闲时触发上报,进一步降低对主线程的干扰。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

function sendMetrics() {
const payload = JSON.stringify({
url: location.href,
ua: navigator.userAgent,
...metrics
});
if (navigator.sendBeacon) {
navigator.sendBeacon('/api/performance', payload);
} else {
// 降级方案:使用 fetch
fetch('/api/performance', {
method: 'POST',
body: payload,
keepalive: true
});
}
}
// 在页面卸载时上报
window.addEventListener('beforeunload', sendMetrics);
// 或在空闲时上报
if ('requestIdleCallback' in window) {
requestIdleCallback(sendMetrics);
}
通过这种方式,即使页面快速关闭,数据也能可靠地发送到服务器。同时,我们提供了 fetch 作为降级方案,以兼容不支持 sendBeacon 的旧版浏览器。这种策略确保了监控数据的完整性和系统的兼容性。
当用户禁用 JavaScript 时监控数据会丢失吗
是的,如果用户禁用了 JavaScript,基于 PerformanceObserver 和 sendBeacon 的前端监控将无法工作,因为这两者都依赖 JS 环境执行。在这种情况下,前端无法主动采集和发送任何性能数据。为了应对这种情况,通常需要配合服务端日志分析(如 Nginx Access Log)来获取基础的页面加载时间和资源请求情况,但这无法提供客户端视角的详细指标如 FID 或 CLS。因此,JS 禁用场景下的监控存在天然盲区,主要依靠服务端侧的间接数据进行补充分析。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










