Nemetrics v1.2.5)

一个小型的web性能监控库，它采集性能指标，如导航时间、资源时间、第一个有内容的油漆(FP/FCP)、最大的有内容油漆(LCP)、第一次输入延迟(FID)返回到您喜爱的分析工具。

Nemetrics 利用最新的 W3C Performance 提案 (比如 PerformanceObserver), 用于测量第一个dom生成的时间(FP/FCP)、LCP,用户最早可操作时间（fid|tti）和组件的生命周期性能。向监控后台报告实际用户测量值。

首次绘制 (FP)

首次内容绘制 (FCP)

首次输入延迟 (FID)

最大的绘制元素(LCP)

主角元素(Hero element)

框架、组件生命周期监控

Navigation Timing

Resource Timing

NetworkInformation


你可以收集这些指标，并在根据ip采集世界各地深入了解你的客户如何看待你的应用程序的web性能。使用您喜欢的分析工具来可视化国家之间的数据，

下图是某个应用 印度/fetchTime/ 的数据图


这是一些数据分析的生成图
![](
https://res.unclewarren.cn/WechatIMG102.png)

如何使用

npm (https://www.npmjs.com/package/nemetric):

npm install nemetric --save-dev

``javascript
import Nemetric from 'nemetric';
`

UMD
`javascript
import Nemetric from 'node_modules/nemetric/dist/nemetric.umd.min.js';
`

$3

![](https://camo.githubusercontent.com/ef97037de2daed3f359061ce34ed0d3ca61e1dfc/68747470733a2f2f7265732e756e636c6577617272656e2e636e2f74696d657374616d702d6469616772616d2e737667)




• DNS lookup: 当用户请求URL时，将查询域名系统(DNS)，以将域转换为IP地址。


• Header size: HTTP 头部大小


• Fetch time:缓存查找和响应时间


• Worker time: Service worker 时间加上响应时间


• Total time:网络请求的请求和响应时间


• Download time: 响应时间


• Time to First Byte:客户端发送HTTP GET请求以接收来自服务器的请求资源的第一个字节所花费的时间。
  它是最大的web页面加载时间组件，占整个web页面延迟的40%到60%。


• page Load Time:页面加载所需的总时长

`javascript
// fetchStart marks when the browser starts to fetch a resource
// responseEnd is when the last byte of the response arrives
fetchTime: parseFloat((navigation.responseEnd - navigation.fetchStart).toFixed(2)),
// Service worker time plus response time
workerTime: parseFloat(
(navigation.workerStart > 0 ? navigation.responseEnd - navigation.workerStart : 0).toFixed(2),
),
// Request plus response time (network only)
totalTime: parseFloat((navigation.responseEnd - navigation.requestStart).toFixed(2)),
// Response time only (download)
downloadTime: parseFloat((navigation.responseEnd - navigation.responseStart).toFixed(2)),
// Time to First Byte (TTFB)
timeToFirstByte: parseFloat(
(navigation.responseStart - navigation.requestStart).toFixed(2),
),
// HTTP header size
headerSize: parseFloat((navigation.transferSize - navigation.encodedBodySize|| 0).toFixed(2)),
// Measuring DNS lookup time
dnsLookupTime: parseFloat(
(navigation.domainLookupEnd - navigation.domainLookupStart).toFixed(2),
),
//page load time
pageLoadTime:parseFloat(
(navigation.loadEventEnd - navigation.startTime).toFixed(2),
)
`

`javascript
interface IAnalyticsTrackerOptions {
data?: any;
metricName: string;
duration?: number;
browser?: BrowserInfo | any;
}
const nemetric = new Nemetric({
navigationTiming: true,
analyticsTracker: (data: IAnalyticsTrackerOptions) => {
//上报到后台
request.get('/metric/measure', data)
}
});
// Nemetric: NavigationTiming {{'{'}} ... timeToFirstByte: 192.65 {{'}'}}

`

$3

Resource Timing收集与文档相关的资源的性能指标。比如css、script、图像等等。
Nemetric帮助公开所有的PerformanceResourceTiming条目和分组数据。

`javascript
const nemetric = new Nemetric({
resourceTiming: true,
dataConsumption: true,
analyticsTracker: (data: IAnalyticsTrackerOptions) => {
//上报到后台
request.get('/metric/measure', data)
}
});
// Nemetric: dataConsumption { "css": 185.95, "fetch": 0, "img": 377.93, ... , "script": 8344.95 }
`

$3

NetworkInformation 提供有关设备正在使用的连接与网络进行通信的信息，并提供了在连接类型更改时通知脚本的事件。NetworkInformation 接口不能被是实例化， 而是通过 Navigator 的 connection 属性进行访问。

`javascript
const nemetric = new Nemetric({
networkInformation: true,
analyticsTracker: (data: IAnalyticsTrackerOptions) => {
//上报到后台
request.get('/metric/measure', data)
}
});
// Nemetric: NetworkInformation {downlink: 10, effectiveType: "4g", rtt: 100, saveData: false}
`

$3

FP 标记浏览器渲染任何在视觉上不同于导航前屏幕内容之内容的时间点

`javascript
const nemetric = new Nemetric({
firstPaint: true
});
// Nemetric: First Paint 1482.00 ms
`

$3

FCP 标记的是浏览器渲染来自 DOM 第一位内容的时间点，该内容可能是文本、图像、SVG 甚至 元素。

`javascript
const nemetric = new Nemetric({
firstContentfulPaint: true
});
// Nemetric: First Contentful Paint 2029.00 ms
`

$3

FID 测量用户首次与站点交互时（即，当他们单击链接，点击按钮或使用自定义的，由JavaScript驱动的控件）到浏览器实际能够回应这种互动的延时。
`javascript
const nemetric = new Nemetric({
firstInputDelay: true
});
// Nemetric: First Input Delay 3.20 ms
`


$3

LCP 标记的是浏览器渲染的最大的那个元素，可能是

1. 元素
2.
3.

`javascript
const nemetric = new Nemetric({
largestContentfulPaint: true
});
// Nemetric: Largest Contentful Paint 2029.00 ms
`

$3

性能标记 (自定义时间测量API) 用于在浏览器的性能条目中创建自定义性能标记。

`javascript
nemetric.start('doStuff');
doStuff(300);
nemetric.end('doStuff');
// Nemetric: doStuff 0.14 ms
`

$3

当浏览器将像素渲染到屏幕时，此指标会在创建新组件后立即标记该点。

`javascript
nemetric.start('togglePopover');
$(element).popover('toggle');
nemetric.endPaint('togglePopover');
// Nemetric: togglePopover 10.54 ms
`

$3

保存一段时间并且按照想要的方式打印出来

`javascript
const nemetric = new Nemetric({
logPrefix: 'warren.js:'
});
nemetric.start('doStuff');
doStuff(500);
const duration = this.nemetric.end('doStuff');
nemetric.log('Custom logging', duration);
//warren.js: Custom logging 0.14 ms
`




$3


结合React 框架，我们可以开始配置Nemetric来收集初始化性能指标（比如 FCP,FID）。

将nemetric.start() 和 nemetric.endPaint() API用于组件的生命周期，已测量绘制组件所需要的时间。

`javascript
import request from 'request';
import Nemetric from 'nemetric';
/**
* 公开nemetric的装饰器接头
* 自动绑定nemetric到对象里面,只需要
* 1.在被绑定类里面声明静态变量 nemetric
* 2.直接类命.nemetric就可以调用
*
* @param project 项目名字
* @param needReport 是否需要上报
*/
export const plugInNemetric = (project: string, needReport = true) => {
return (target: Object) => {
if (!Reflect.has(target, 'nemetric')) {
const nemetric = new Nemetric({
firstInputDelay: true,
firstContentfulPaint: true,
largestContentfulPaint: true,
navigationTiming: true,
dataConsumption: true,
networkInformation: true,
analyticsTracker: (data: IAnalyticsTrackerOptions) => {
//上报到后台
if (needReport) {
request.post('/metric/measure', { ...data, project} }).catch(err => {
console.log('nemetric report failed')
});
}
}
})
Reflect.set(target, 'nemetric', nemetric);
}
}
}


import React from 'react';

@plugInNemetric('App',true)
export default class App extends React.Component {

constructor() {
// 开始测量要绘制的组件时间
App.nemetric.start('AppAfterPaint');
}

loadData = async () => {
await request.get('whatever1');
await request.get('whatever2');
if(err){
App.nemetric.clear('AppAfterPaint');
}
// 结束测量部件绘制时间
App.nemetric.endPaint('AppAfterPaint');
}

render() {
const data = this.loadData();
return (



);
}
}
`

自定义 & 工具集

$3

在构造函数中提供给Nemetric默认选项。

`javascript
const config: INemetricConfig = {
// Metrics
firstContentfulPaint: false,
firstPaint: false,
firstInputDelay: false,
largestContentfulPaint: false,
navigationTiming: false,
networkInformation: false,
dataConsumption: false,
// Logging
logPrefix: 'Nemetric:',
logging: true,
maxMeasureTime: 15000,
warning: false,
//默认是app端内应用
inApp: true,
sampleRate: 1
};
`

#### 工具集

Nemetric 公开了一些方法和属性，这些方法和属性可能对扩展这个库的人有用。

`javascript
const nemetric = new Nemetric({
firstContentfulPaint: true,
firstInputDelay: true,
});

// Values
nemetric.firstPaintDuration;
nemetric.firstContentfulPaintDuration;
nemetric.firstInputDelayDuration;

// Aync Values
const durationFCP = await nemetric.observeFirstContentfulPaint;
const durationFID = await nemetric.observeFirstInputDelay;

// 将自定义用户时间标识发送到Google Analytics
nemetric.sendTiming(metricName, durationFCP);
``

文章

* Nemetric 实现原理
* 如何采集和分析网页用户的性能指标
* Assessing Loading Performance in Real Life with Navigation and Resource Timing
* navigation-timing
* Idle Until Urgent
* First Input Delay
* Largest Contentful Paint