前端录屏 + 定位源码,帮你快速定位线上 bug

发表于 8月以前  | 总阅读数:27035 次

前言

如何快速定位线上bug,是多数开发者都会遇到的难题

web-see[1] 前端监控方案,提供了 前端录屏+定位源码 方式,让bug无处藏身

这是前端监控的第二篇,该篇讲解如何实现错误还原功能,第一篇 从0到1搭建前端监控平台,面试必备的亮点项目(已开源)[2] 没有看过的小伙伴,建议先了解下

最终效果

在监控后台,通过报错信息列表,可以查看具体报错的源码,以及报错时的录屏回放

效果演示:

录屏记录了用户的所有操作,红色的线代表了鼠标的移动轨迹

定位源码

前端项目发布上线,代码一般都会进行压缩、混淆、甚至加密,当线上代码报错时,很难定位到具体的源码

SourceMap 完美解决了代码反解的问题,项目在打包时,除了生成最终 XXX.js 文件外,还会额外生成一个 XXX.js.map 的文件

.map 文件里包含了原始代码及其映射信息,可以利用它反解出报错信息的源码

SourceMap 文件

先了解下 SourceMap 的基本内容

例如 app.a2a3ceec.js 代码如下:

var add=function(x, y){return x+y;};
//# sourceMappingURL=app.a2a3ceec.js.map
复制代码

其中 sourceMappingURL 用来说明该文件对应的map文件

对应的 app.a2a3ceec.js.map 代码如下:

{
  version : 3, // SourceMap标准版本,最新的为3
  file: "js/app.a2a3ceec.js", // 转换后的文件名
  sourceRoot : "", // 转换前的文件所在目录,如果与转换前的文件在同一目录,该项为空
  sources: [ // 转换前的文件,该项是一个数组,表示可能存在多个文件合并
    "webpack://web-see-demo/./src/App.vue",
    "webpack://web-see-demo/./src/main.js"
  ], 
  names: [], // 转换前的所有变量名和属性名
  sourcesContent: [ // 原始文件内容
    "const add = (x,y) => {\n  return x+y;\n}"
  ],
  // 所有映射点
  mappings: "AAAA,IAAM,GAAG,GAAG,UAAC,CAAQ,EAAC,CAAQ;IAC5B,OAAO,CAAC,GAAC,CAAC,CAAC;AACb,CAAC,CAAA"
}
复制代码

其中 sources 和 sourcesContent 是关键字段,下文的还原示例中将用到

source-map-js 库

代码还原,这里主要使用 source-map-js[3] 库,下面介绍下如何使用

示例代码:

import sourceMap from 'source-map-js';

/**
* findCodeBySourceMap用于获取map文件对应的源代码
* @param { string } fileName .map文件名称
* @param { number } line 发生错误的行号
* @param { number } column 发生错误的列号
* @param { function } 回调函数,返回对应的源码
*/
const findCodeBySourceMap = async ({ fileName, line, column }, callback) => {
  // loadSourceMap 用于获取服务器上 .map 的文件内容
  let sourceData = await loadSourceMap(fileName);
  let { sourcesContent, sources } = sourceData;
  // SourceMapConsumer实例表示一个已解析的源映射
  // 可以通过在生成的源中给它一个文件位置来查询有关原始文件位置的信息
  let consumer = await new sourceMap.SourceMapConsumer(sourceData);
  // 输入错误的发生行和列,可以得到源码对应原始文件、行和列信息
  let result = consumer.originalPositionFor({
    line: Number(line),
    column: Number(column)
  });
  // 从sourcesContent得到具体的源码信息
  let code = sourcesContent[sources.indexOf(result.source)];
  ……
  callback(code)
复制代码

本小节的代码仓库[4]

source-map 的还原流程:

1、从服务器获取指定.map 的文件内容

2、new 一个 SourceMapConsumer 的实例,表示一个已解析的源映射,给它一个文件位置来查询有关原始文件位置的信息

3、输入报错发生的行和列,可以得到源码对应原始文件名、行和列信息

4、从源文件的 sourcesContent 字段中,获取对应的源码信息

接下来的重点就变为:如何获取报错发生的原始文件名、行和列信息

error-stack-parser 库

通过第一篇文章的介绍,我们知道可以通过多种方式来捕获报错

比如 error事件、unhandledrejection事件、vue 中通过Vue.config.errorHander、react中通过componentDidCatch

为了消除各浏览器的差异,使用 error-stack-parser[5] 库来提取给定错误的原始文件名、行和列信息

示例代码:

import ErrorStackParser from 'error-stack-parser';

ErrorStackParser.parse(new Error('BOOM'));

// 返回值 StackFrame 堆栈列表
[
    StackFrame({functionName: 'foo', args: [], fileName: 'path/to/file.js', lineNumber: 35, columnNumber: 79, isNative: false, isEval: false}),
    StackFrame({functionName: 'Bar', fileName: 'https://cdn.somewherefast.com/utils.min.js', lineNumber: 1, columnNumber: 832, isNative: false, isEval: false, isConstructor: true}),
    StackFrame(... and so on ...)
]
复制代码

这里简单说明下 JS 堆栈列表

堆栈示例:

function c() {
  try {
    var bar = baz;
    throw new Error()
  } catch (e) {
    console.log(e.stack);
  }
}
function b() {
  c();
}
function a() {
  b();
}
a();
复制代码

上述代码中会在执行到 c 函数的时候报错,调用栈为 a -> b -> c,如下图所示:

stack.png

一般我们只需要定位到 c 函数的堆栈信息,所以使用 error-stack-parser 库的时候,只取 StackFrame 数组中的第一个元素

最终代码:

import ErrorStackParser from 'error-stack-parser';

// 取StackFrame数组中的第一个元素
let stackFrame = ErrorStackParser.parse(error)[0];
// 获取对应的原始文件名、行和列信息,并上报
let { fileName, columnNumber, lineNumber } = stackFrame;
复制代码

示例演示

下载 web-see-demo[6] 安装并运行

1)点击 js错误 按钮,会执行 HomeView.vue 文件中的 codeErr 方法

codeErr的源码为:

codeErr.png

2)Vue.config.errorHander中捕获到报错信息为:

length.png

3)使用 ErrorStackParser.parse 解析后的stackFrame为:

stackFrame.png

4)经过 consumer.originalPositionFor 还原后的 result 结果为:

result.png

5)最终拿到的源码:

code.png

流程总结

sourcemap.png

如上图所示,定位源码流程总结:

1、项目中引入监控 SDK,打包后将js文件发布到服务器上

2、将 .map 文件放到指定的地址,统一存储

3、当线上代码报错时,利用 error-stack-parser 获取具体原始文件名、行和列信息,并上报

4、利用 source-map 从 .map 文件中得到对应的源码并展示

前端录屏

web-see 监控通过 rrweb[7] 提供了前端录屏的功能

rrweb 使用

先介绍下在vue中如何使用

录制示例:

import { record } from 'rrweb';
// events存储录屏信息
let events = [];
// record 用于记录 `DOM` 中的所有变更
rrweb.record({
  emit(event, isCheckout) {
    // isCheckout 是一个标识,告诉你重新制作了快照
    if (isCheckout) {
      events.push([]);
    }
    events.push(event);
  },
  recordCanvas: true, // 记录 canvas 内容
  checkoutEveryNms: 10 * 1000, // 每10s重新制作快照
  checkoutEveryNth: 200, // 每 200 个 event 重新制作快照
});
复制代码

播放示例:

<template>
  <div ref='player'>
  </div>
</template>
<script>
import rrwebPlayer from 'rrweb-player';
import 'rrweb-player/dist/style.css';
export default {
   mounted() {
     // 将记录的变更按照对应的时间一一重放
     new rrwebPlayer(
        {
          target: this.$refs.player, // 回放所需要的HTML元素
          data: { events }
        },
        {
          UNSAFE_replayCanvas: true // 回放 canvas 内容
        }
     )
   }
}
</script>
复制代码

rrweb 原理浅析

rrweb 主要由 rrwebrrweb-playerrrweb-snapshot 三个库组成:

1)rrweb:提供了 record 和 replay 两个方法;record 方法用来记录页面上 DOM 的变化,replay 方法支持根据时间戳去还原 DOM 的变化

2)rrweb-player:基于 svelte 模板实现,为 rrweb 提供了回放的 GUI 工具,支持暂停、倍速播放、拖拽时间轴等功能。内部调用了 rrweb 的提供的 replay 等方法

3)rrweb-snapshot:包括 snapshot 和 rebuilding 两大特性,snapshot 用来序列化 DOM 为增量快照,rebuilding 负责将增量快照还原为 DOM

rrweb 整体流程:

1)rrweb 在录制时会首先进行首屏 DOM 快照,遍历整个页面的 DOM 树,转换为 JSON 结构数据,使用增量快照的处理方式,通过 mutationObserver 获取 DOM 增量变化,同步转换为 JSON 数据进行存储

2)整个录制的过程会生成 unique id,来确定增量数据所对应的 DOM 节点,通过 timestamp 保证回放顺序。

3) 回放时,会创建一个 iframe 作为承载事件回放的容器,针对首屏 DOM 快照进行重建,在遍历 JSON 的同时,根据序列化后的节点数据构建出实际的 DOM 节点

4)rrweb 可以监听的用户行为包括:鼠标移动,鼠标交互,页面滚动,视窗变化、用户输入等,通过添加相应的监听事件来实现

压缩数据

如果一直录屏,数据量是巨大的

实测下来,录制10s的时长,数据大小约为 8M 左右(页面的不同复杂度、用户不同操作的频率都会造成大小不一样)

数据如果不经过压缩,直接传给后端,面对大量的用户,需要非常高的带宽做支持。还好,rrweb官方提供了数据压缩函数[8]

基于 packFn 的单数据压缩,在录制时可以作为 packFn 传入

rrweb.record({
  emit(event) {},
  packFn: rrweb.pack,
});
复制代码

回放时,需要传入 rrweb.unpack 作为 unpackFn 传入

const replayer = new rrweb.Replayer(events, {
  unpackFn: rrweb.unpack,
});
复制代码

但是官方提供的压缩方式,是对每个 event 数据单独进行压缩,压缩比不高。实测下来,压缩比在70%左右,比如原来 8M 的数据,压缩后为 2.4M 左右

官方更加推荐将多个 event 批量一次性压缩,这样压缩效果更好

web-see 内部使用 pako.js[9]、js-base64[10] 相结合的压缩方式,实测下来,压缩比为 85% 以上,原来 8M 的数据,压缩后为 1.2M 左右

压缩代码示例:

import pako from 'pako';
import { Base64 } from 'js-base64';

// 压缩
export function zip(data) {
  if (!data) return data;
  // 判断数据是否需要转为JSON
  const dataJson = typeof data !== 'string' && typeof data !== 'number' ? JSON.stringify(data) : data;
  // 使用Base64.encode处理字符编码,兼容中文
  const str = Base64.encode(dataJson);
  let binaryString = pako.gzip(str);
  let arr = Array.from(binaryString);
  let s = '';
  arr.forEach((item) => {
    s += String.fromCharCode(item);
  });
  return Base64.btoa(s);
}
复制代码

解压代码示例:

import { Base64 } from 'js-base64';
import pako from 'pako';

// 解压
export function unzip(b64Data) {
  let strData = Base64.atob(b64Data);
  let charData = strData.split('').map(function (x) {
    return x.charCodeAt(0);
  });
  let binData = new Uint8Array(charData);
  let data = pako.ungzip(binData);
  // ↓切片处理数据,防止内存溢出报错↓
  let str = '';
  const chunk = 8 * 1024;
  let i;
  for (i = 0; i < data.length / chunk; i++) {
    str += String.fromCharCode.apply(null, data.slice(i * chunk, (i + 1) * chunk));
  }
  str += String.fromCharCode.apply(null, data.slice(i * chunk));
  // ↑切片处理数据,防止内存溢出报错↑
  const unzipStr = Base64.decode(str);
  let result = '';
  // 对象或数组进行JSON转换
  try {
    result = JSON.parse(unzipStr);
  } catch (error) {
    if (/Unexpected token o in JSON at position 0/.test(error)) {
      // 如果没有转换成功,代表值为基本数据,直接赋值
      result = unzipStr;
    }
  }
  return result;
}
复制代码

何时上报录屏数据

一般关注的是,页面报错的时候用户做了哪些操作,所以目前只把报错前10s的录屏上报到服务端

如何只上报报错时的录屏信息呢 ?

1)window上设置 hasError、recordScreenId 变量,hasError用来判断某段时间代码是否报错;recordScreenId 用来记录此次录屏的id

2)当页面发出报错需要上报时,判断是否开启了录屏,如果开启了,将 hasError 设为 true,同时将 window 上的 recordScreenId,存储到此次上报信息的 data 中

3)rrweb 设置10s重新制作快照的频率,每次重置录屏时,判断 hasError 是否为 true(即这段时间内是否发生报错),有的话将这次的录屏信息上报,并重置录屏信息和 recordScreenId,作为下次录屏使用

4)后台报错列表,从本次报错报的data中取出 recordScreenId 来播放录屏

录屏的代码示例:

handleScreen() {
 try {
  // 存储录屏信息
  let events = [];
  record({
    emit(event, isCheckout) {
      if (isCheckout) {
        // 此段时间内发生错误,上报录屏信息
        if (_support.hasError) {
          let recordScreenId = _support.recordScreenId;
          // 重置recordScreenId,作为下次使用
          _support.recordScreenId = generateUUID();
          transportData.send({
            type: EVENTTYPES.RECORDSCREEN,
            recordScreenId,
            time: getTimestamp(),
            status: STATUS_CODE.OK,
            events: zip(events)
          });
          events = [];
          _support.hasError = false;
        } else {
          // 不上报,清空录屏
          events = [];
          _support.recordScreenId = generateUUID();
        }
      }
      events.push(event);
    },
    recordCanvas: true,
    // 默认每10s重新制作快照
    checkoutEveryNms: 1000 * options.recordScreentime
  });
复制代码

遗留问题,在线求解

按照官方的 canvas 配置,验证下来,rrweb 还是不支持 canvas 的录制,比如使用 echarts 画图,图形区域的录屏显示是空白的

官方配置[11] 如下:

Canvas.png

测试demo[12] 如下:

echart.png

录屏回放,图形这块区域是空白的:

canvas.gif

这块有研究的小伙们麻烦指导下,问题出在哪里,感谢

总结

前端录屏+定位源码,是目前比较流行的错误还原方式,对于快速定位线上bug大有裨益

这两篇文章只是关于前端监控的入门级介绍,其中可以深挖的点还有很多,欢迎小伙们多多讨论与交流

最后推荐一篇阿里前端监控负责人的专题演讲:《大前端时代前端监控的最佳实践》[13],了解下前端监控的天花板有多高

天冷了,别忘了穿秋裤撒

https://mp.weixin.qq.com/s/h6gZWBgZJPvCPuifzgzTLQ

 相关推荐

丽珠集团回应“涉及违规支出公关费用” :内部正在调查,费用占比是行业正常水平

8月7日消息,针对股价大跌和网传“涉及违规支出公关费用”的相关消息,丽珠集团公司认为今日的大跌属于近期医药行业反腐风暴逐渐加强,投资者情绪变化所致。

发布于:1月以前  |  262次阅读  |  详细内容 »

美国芯片巨头英特尔与中方合作!将在深圳新建芯片创新中心

据香港《南华早报》7月31日报道,英特尔与深圳合作,建立新的芯片创新中心以加深关系。

发布于:1月以前  |  233次阅读  |  详细内容 »

工信部要求开展 App 备案,微信小程序完成备案后才可上架

近日,工业和信息化部印发了《工业和信息化部关于开展移动互联网应用程序备案工作的通知》。

发布于:1月以前  |  213次阅读  |  详细内容 »

微信要做“小绿书”?知情人士:小范围内测,优化视频号图文发布及呈现

据网友爆料,微信正在灰度测试“小绿书”。从知情人士处了解到,这是一次非常小范围的内测,不是新功能,初衷就是为了更方便视频号创作者发布图文短内容,以及提高用户获得信息的效率。据知情人士介绍,视频号本身就可以发图片,这次内测只是把发布图片单独设计了一个按钮,在“看一看”那里可以集中查看而已。

发布于:1月以前  |  212次阅读  |  详细内容 »

X、马斯克寻求驳回有关前推特员工遣散费的诉讼

8月2日消息,社交媒体公司 X Corp周一向特拉华州威尔明顿联邦法院提交的一份文件中称,今年5月起诉该公司的六名前员工并非推特与马斯克旗下控股公司于2022年达成的合并协议的当事方,因此他们不能以涉嫌违反该协议为由起诉他们。

发布于:1月以前  |  210次阅读  |  详细内容 »

家乐福被裁员工曝未拿到补偿金,此前通知补偿金打6折一次性发和全款分12期之间二选一

据报道,近期,不少前家乐福员工爆料称,此前陆续接到裁员通知,给出的方案基本都是N的补偿费,但不少人却迟迟未拿到款项。据悉,被裁员工的工龄有长短,陆续都是在数月内被裁,补偿金在打6折一次性拿和全款分12期之间二选一。

发布于:1月以前  |  205次阅读  |  详细内容 »

OpenAI已注册GPT5商标

8月1日消息,OpenAI 今年 3 月推出了 GPT-4,成为“AI 模型”的代名词,甚至一度引发了业界恐慌,此前报道,以马斯克为首的科技圈人物要求“OpenAI 暂时停止研究 GPT-5 研发”。

发布于:1月以前  |  202次阅读  |  详细内容 »

特斯拉收购德国无线充电技术公司,未来或将投放相关产品

6月份关于特斯拉的一则收购传闻近日得到证实。当地时间7月31日,特斯拉确认已完成对德国无线充电技术公司Wiferion的计划收购,同时该公司更名为Tesla Engineering Germany GmbH。

发布于:1月以前  |  196次阅读  |  详细内容 »

全球勒索软件攻击创历史新高,美国是全球勒索软件攻击首要目标

Malwarebytes 的报告显示,全球勒索软件攻击呈现上升趋势。

发布于:1月以前  |  194次阅读  |  详细内容 »

美交管局对特斯拉部分车型展开调查,特斯拉部分车型被曝转向失灵

据报道,美国国家公路交通安全管理局8月1日表示,已对28万辆特斯拉Model 3和Model Y电动汽车展开调查,原因是这些车辆被曝存在转向失灵的情况。

发布于:1月以前  |  193次阅读  |  详细内容 »

时隔两年再战社交,腾讯内测「M8」APP

腾讯内部正在研发一款名为“M8”的社交APP,由QQ团队打造,定位是基于地图的虚拟社交产品,主攻年轻人社交赛道。据消息人士透露,产品或于8月份对外开启测试。

发布于:1月以前  |  189次阅读  |  详细内容 »

听歌时被银行AI骚扰电话打断,他起诉“索赔”110万元!

“在此事发生的过程中,本人正通过歌曲进行能力的激发,歌曲被打断,非但原有的效果并未达到,更让我承受了巨大的心理压力。”近日,一份题为“精神损害赔偿起诉状”的文字在社交平台上引发关注。市民辛先生在起诉状中表示,除了请法院判处被告向原告赔偿精神损失费10万元以外,还要求附带赔偿大卫·鲍伊演出名誉损失费100...

发布于:1月以前  |  187次阅读  |  详细内容 »

外媒:印度要求特斯拉效仿苹果,让其中国供应商与印企合资后再落地

据外媒8月1日报道,三位印度政府消息人士称,在特斯拉研究在印建厂之际,印度官员要求特斯拉效仿苹果公司,寻找印度当地公司与中国供应商合作。

发布于:1月以前  |  186次阅读  |  详细内容 »

世界首例自动驾驶致命车祸司机认罪:判处三年缓刑

8月1日消息,据报道,世界首起涉及自动驾驶汽车的致命碰撞事故日前进行了最终宣判,Uber自动驾驶汽车的安全员认罪并被判处三年缓刑。

发布于:1月以前  |  182次阅读  |  详细内容 »

全新声学攻击AI模型:从键盘敲击声窃取数据,准确率高达95%

近日,来自英国大学的一个研究团队训练了一种深度学习模型,该模型可以从使用麦克风记录的键盘敲击声音中,窃取数据,准确率高达95%。据称,此类攻击会严重影响目标的数据安全,它可能会将人们的密码、讨论、消息或其他敏感信息泄露给恶意第三方。

发布于:1月以前  |  180次阅读  |  详细内容 »

推特在苹果商店更名为X,X公司获得苹果首家单字符批准

7月31日,Twitter 应用在苹果 App Store 已经更名为 X,这意味着该公司可能获得了苹果的特批,因为此前 App Store 明确规定应用名称至少需要两个字母。

发布于:1月以前  |  180次阅读  |  详细内容 »

已拿下两家订单,零跑造车八年后开始技术输出

在7月31日举办的零跑汽车全新电子电气架构发布会上,零跑科技创始人、董事长、CEO 朱江明向现场媒体表示:" 零跑不仅要做一家汽车公司,还要做一家技术输出的公司。

发布于:1月以前  |  178次阅读  |  详细内容 »

小鹏汽车宣布严打占桩:超时占位每分钟收费1元

8日消息,小鹏汽车在其官方 App 上发布公告,指出公司将严打充电桩 “ 霸位 ” 行为。公告表示,近期发现一些车辆在充电站占桩不充电,或插枪不充电,浪费了宝贵的充电桩资源。为了解决这个问题,小鹏汽车已经加强了场站管理,全方位布局监控,检测场站情况,并增加了巡检次数。

发布于:1月以前  |  174次阅读  |  详细内容 »

蚂蚁集团以 6.28 亿美元出售印度“支付宝” Paytm 10.3% 股份,不再是其最大股东

8月7日消息,据外媒报道,蚂蚁集团旗下的一家子公司将出售印度最大的支付平台 Paytm10.3% 的股份,而 Paytm 的创始人兼 CEO Vijay Shekhar Sharma 将增持该股份,以简化该公司的所有权结构。消息公布后,Paytm 股价一度上涨 11.4%,今年以来该公司股价已经上涨了超过 50%。

发布于:1月以前  |  171次阅读  |  详细内容 »

周鸿祎:希望超级人工智能出来之后,先解决常温超导等问题而不是娱乐

8月8日消息,近日,周鸿祎在社交平台发文谈温室超导问题。他表示,最近室温超导比较火,室温超导技术的实现将对能源、电子、医疗、交通、AI等领域产生深远的影响。

发布于:1月以前  |  170次阅读  |  详细内容 »
 相关文章
 目录