MonitorSDK_性能监控（从Web Vital性能指标、PerformanceObserver API和具体代码实现）

性能监控

在这里插入图片描述

性能指标

在实现性能监控前，先了解Web Vitals涉及的常见的性能指标

Web Vitals 是由 Google 推出的网页用户体验衡量指标体系，旨在帮助开发者量化和优化网页在实际用户终端上的性能体验。Web Vitals 强调“以用户为中心”的度量，而不是纯技术层面的加载时间。

要按 先后顺序（时间维度） 梳理 Web Vitals，可以从网页加载的生命周期出发，把每个指标放入其发生时机对应的阶段中。这样更利于理解用户体验的演变和指标采集的逻辑。

🧭 一、加载过程的五大阶段

[1] 网络响应阶段
[2] 首次渲染阶段
[3] 内容加载阶段
[4] 用户交互阶段
[5] 页面稳定阶段

📊 二、Web Vitals 指标按时间顺序梳理

阶段	指标名	含义	时机
1️⃣ 网络响应	TTFB (Time to First Byte)	首字节到达	浏览器请求后，接收到第一个响应字节
2️⃣ 首次渲染	FCP (First Contentful Paint)	首次绘制文字/图像	页面开始有内容渲染（非白屏）
3️⃣ 主内容加载	LCP (Largest Contentful Paint)	最大可视内容渲染完成	用户感知“页面加载完”
4️⃣ 用户首次交互	FID (First Input Delay)	用户首次点击的响应延迟	用户第一次交互，直到浏览器处理事件的延迟
5️⃣ 页面稳定	CLS (Cumulative Layout Shift)	布局跳动	页面是否因为图片/广告等加载而抖动

🧬 三、时间线图（逻辑顺序）

时间单位为毫秒。TTFB 最早，CLS 贯穿整个加载过程。

🔁 四、简洁记忆顺序口诀

💡「先 TTFB，见 FCP；看大图，用 LCP；首操作，测 FID；别乱跳，查 CLS」

🛠 五、指标采集时机小贴士

指标	采集方式	推荐 API
TTFB	`performance.timing.responseStart` - `navigationStart`	Navigation Timing
FCP	`PerformanceObserver` 监听 `paint`	PerformancePaintTiming
LCP	`PerformanceObserver` 监听 `largest-contentful-paint`	LCP Entry
FID	真实用户交互产生的事件延迟	Event Timing API
CLS	`PerformanceObserver` 监听 `layout-shift`	LayoutShift Entry

🧭 六、总结为时序流图（Mermaid）

在这里插入图片描述

性能指标监控——PerformanceObserver

PerformanceObserver 是 Performance API 中用于监听性能条目变化的核心工具。它可以在网页运行过程中，异步捕获新生成的性能条目，而不是一开始就调用 performance.getEntries() 拿“旧数据”。

一、`PerformanceObserver` 的作用

它允许开发者：

监听网页运行中出现的性能条目（如资源加载、绘制、打点、长任务等）
做出动态响应（如打日志、发送埋点数据）
支持指定监听的 entryTypes，如 ["resource"], ["mark", "measure"]

二、使用方式

1. 创建实例

const observer = new PerformanceObserver((list, observer) => {
  const entries = list.getEntries();
  for (const entry of entries) {
    console.log(entry.name, entry.entryType, entry.startTime, entry.duration);
  }
});

2. 启动监听

observer.observe({
  entryTypes: ['mark', 'measure', 'resource']
});

entryTypes 是监听的条目类型数组。

三、常用方法

方法	说明
`observe(options)`	开始监听性能条目
`disconnect()`	停止监听
`takeRecords()`	获取当前缓冲区的所有性能条目并清空缓冲区

四、选项说明

`observe(options)`

observer.observe({
  entryTypes: ['resource', 'paint']
});

或使用过时写法（不推荐）：

observer.observe({
  type: 'resource',
  buffered: true
});

参数说明：

entryTypes: 性能条目的类型（推荐）
type: 单一类型（不推荐）
buffered: 是否包括已存在的历史条目（true 会包含之前的记录）

五、支持的 entryType（性能条目类型）

类型	含义
`resource`	外部资源加载耗时
`mark`	用户自定义打点
`measure`	用户定义的测量点
`paint`	首次绘制（first-paint, first-contentful-paint）
`navigation`	页面导航
`longtask`	长任务（如 JS 卡顿）
`element`	关键可视元素曝光（需要配置）
`largest-contentful-paint`	最大内容绘制时间
`layout-shift`	布局偏移（CLS）

六、典型使用场景

监听资源加载情况（如 img、script）
监听 FCP、LCP、CLS、Long Tasks，用于 Web Vitals 性能分析
异步获取自定义打点结果
在 SPA 页面做性能埋点

七、注意事项

PerformanceObserver 是异步的：不会立即收到记录。
使用 buffered: true 可获取已经发生的记录（旧数据），用于首次加载打点。
页面进入后台或关闭时，需要调用 takeRecords() 收集剩余数据。
一些条目需要在支持的浏览器中开启对应实验性特性（如 longtask）。

八、Mermaid 类图详解 `PerformanceObserver`

在这里插入图片描述

九、具体实现

在这里插入图片描述

import { lazyReportBatch } from '../report';
const originalFetch = window.fetch;
function overwriteFetch() {
    window.fetch = function  newFetch(url, config) {
        const startTime = Date.now();
        const reportData = {
            type: 'performance',
            subType: 'fetch',
            url,
            startTime,
            method: config.method,
        }
        return originalFetch(url, config).then((res) => {
            const endTime = Date.now();
            reportData.endTime = endTime;
            reportData.duration = endTime - startTime;
            const data = res.clone();
            reportData.status = data.status;
            reportData.success = data.ok;
            // todo 上报数据
            lazyReportBatch(reportData);
            return res;
        }).catch((err) => {
            const endTime = Date.now();
            reportData.endTime = endTime;
            reportData.duration = endTime - startTime;
            reportData.status = 0;
            reportData.success = false;
            // todo 上报数据
            lazyReportBatch(reportData);
        });
    }
}
export default function fetch() {
    overwriteFetch();
}

／／监控ＦＰ
import { lazyReportBatch } from '../report';
export default function observerPaint() {
    const entryHandler = (list) => {
        for (const entry of list.getEntries()) {
            if (entry.name === 'first-paint') {
                observer.disconnect();
                const json = entry.toJSON();
                console.log(json);
                const reportData = {
                    ...json,
                    type: 'performance',
                    subType: entry.name,
                    pageUrl: window.location.href,
                }
                // 发送数据 todo;
                lazyReportBatch(reportData);
            }
        }
    
    }
    // 统计和计算fp的时间
    const observer = new PerformanceObserver(entryHandler);
    // buffered: true 确保观察到所有paint事件
    observer.observe({type: 'paint', buffered: true});
    
    
}
／／监控ＦＣＰ
import { lazyReportBatch } from '../report';
export default function observerFCP() {
    const entryHandler = (list) => {
        for (const entry of list.getEntries()) {
            if (entry.name === 'first-contentful-paint') {
                observer.disconnect();
                const json = entry.toJSON();
                console.log(json);
                const reportData = {
                    ...json,
                    type: 'performance',
                    subType: entry.name,
                    pageUrl: window.location.href,
                }
                // 发送数据 todo;
                lazyReportBatch(reportData);
            }
        }

    }
    // 统计和计算fcp的时间
    const observer = new PerformanceObserver(entryHandler);
    // buffered: true 确保观察到所有paint事件
    observer.observe({type: 'paint', buffered: true});
}
／／监控ＬＣＰ
import { lazyReportBatch } from '../report';
export default function observerLCP() {
    if (
        typeof PerformanceObserver === 'undefined' ||
        !PerformanceObserver.supportedEntryTypes.includes('largest-contentful-paint')
      ) {
        console.warn('LCP not supported in this browser.');
        return;
      }
    const entryHandler = (list,observer) => {
        if (observer) {
            observer.disconnect();
        } 
        for (const entry of list.getEntries()) {
            const json = entry.toJSON();
            //console.log(json);
            const reportData = {
                ...json,
                type: 'performance',
                subType: entry.name,
                pageUrl: window.location.href,
            }
            console.log(reportData);
            // 发送数据 todo;
            //lazyReportBatch(reportData);
        }

    }
    // 统计和计算lcp的时间
    const observer = new PerformanceObserver(entryHandler);
    // buffered: true 确保观察到所有paint事件
    observer.observe({type: 'largest-contentful-paint', buffered: true});
}

import { lazyReportBatch } from '../report';
export default function observerLoad () {
    window.addEventListener('pageShow', function (event) {
        requestAnimationFrame(() =>{
            ['load'].forEach((type) => {
                const reportData = {
                    type: 'performance',
                    subType: type,
                    pageUrl: window.location.href,
                    startTime: performance.now()- event.timeStamp
                }
                // 发送数据
                lazyReportBatch(reportData);
            });

        }, true);
    });
}



import { lazyReportBatch } from '../report';
export const originalProto = XMLHttpRequest.prototype;
export const originalSend = originalProto.send;
export const originalOpen = originalProto.open;

function overwriteOpenAndSend() {
    originalProto.open = function newOpen(...args) {
        this.url = args[1];
        this.method = args[0];
        originalOpen.apply(this, args);

    }
    originalProto.send = function newSend(...args) {
        this.startTime = Date.now();
        const onLoaded = () => {
            this.endTime = Date.now();
            this.duration = this.endTime - this.startTime;
            const { url, method , startTime, endTime, duration, status} = this;
            const reportData = {
                status,
                duration,
                startTime,
                endTime,
                url,
                method: method.toUpperCase(),
                type: 'performance',
                success: status >= 200 && status < 300,
                subType: 'xhr'
            }
            // todo 发送数据
            lazyReportBatch(reportData);
            this.removeEventListener('loadend', onLoaded, true);
        }
        this.addEventListener('loadend', onLoaded, true);
        originalSend.apply(this, args);

    }

}
export default function xhr() {
    overwriteOpenAndSend();
}