前端监控是一个大话题，无论在知乎，还是掘转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】金，我都阅读过很多相关的文章。但是，在众【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】多文章中，我发现他们都有一些共性，但是你未经授权，禁止复制转载。未经授权，禁止复制转载。却无法简单说哪些是共性的东西，哪些是专门【本文受版权保护】著作权归作者所有，禁止商业用途转载。的东西。为此，我打算写一篇文章，来讲解我【本文受版权保护】【关注微信公众号：wwwtangshuangnet】在设计我的前端监控系统时，如何解决前端S著作权归作者所有，禁止商业用途转载。【本文受版权保护】DK的问题。

【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。

前端监控SDK的共性

和其他SDK不同，前端监控SDK基本上要【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】求开箱即用，一个<script src>就可以完成所有监控逻辑。在文档中插入sc【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。ript标签时，可以带上data-appid属性，以区分当前监控的应用，脚本内可通过未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。document.currentScri原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】pt读取，当然，如果服务端以及绑定了域名未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net，那不需要appid也无所谓。

【原创内容，转载请注明出处】【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】

我们要谈的是，作为SDK的提供方，我们要在SDK中怎么写，才能做到这种开箱【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。即用，或者对于下游开发者而言更好用。

【本文受版权保护】【版权所有】唐霜 www.tangshuang.net

前端监控的目标各有不同，包括：测速、性能【作者：唐霜】本文作者：唐霜，转载请注明出处。、错误、行为等方面。我在过去两年中，重点【未经授权禁止转载】【版权所有，侵权必究】集中在研究监控用户行为，在长时间的探索中【原创内容，转载请注明出处】【作者：唐霜】，我对SDK进行了多次重构，最终发现，无未经授权，禁止复制转载。【本文首发于唐霜的博客】论以什么方向为目标，SDK的设计都需要包【本文首发于唐霜的博客】【作者：唐霜】含如下几个方面：

【转载请注明来源】本文作者：唐霜，转载请注明出处。

• 数据收集
未经授权，禁止复制转载。【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。
• 数据存储（日志的结构，日志是存在内存中，著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。还是存在indexedDB中）
【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net
• 数据上报（上报周期：立即，延时；上报策略转载请注明出处：www.tangshuang.net原创内容，盗版必究。：什么情况下触发上报；上报压缩等）
本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。
• 生命周期
著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。
• 代码分离（快速加载主体代码，异步加载功能【本文首发于唐霜的博客】【原创内容，转载请注明出处】代码；将数据处理移到webworker中未经授权，禁止复制转载。未经授权，禁止复制转载。）
【本文受版权保护】【作者：唐霜】转载请注明出处：www.tangshuang.net

不管你是做性能监控，还是错误监控，SDK著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。都可以从这几个方面去思考，当然，不同场景原创内容，盗版必究。【原创内容，转载请注明出处】下，不一定全部都要，但是作为成年人，我们【作者：唐霜】【原创内容，转载请注明出处】往往全想要。我在写用户行为监控时，还遇到著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】一些特殊场景：

【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net

• 仅在某一个特定流程中进行录制，其他页面不著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net需要录制，因此，要求SDK具有可选的录制【原创内容，转载请注明出处】【未经授权禁止转载】策略，而不是定死的
【未经授权禁止转载】未经授权，禁止复制转载。
• 一串用于演示用户行为导致的界面变化的日志原创内容，盗版必究。【版权所有，侵权必究】，具有不可能遗漏性，一旦遗漏其中一个日志【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net，都有可能导致无法最终还原出用户操作的界【转载请注明来源】【版权所有】唐霜 www.tangshuang.net面效果，因此，对SDK收集的日志完整性有转载请注明出处：www.tangshuang.net【本文受版权保护】要求
【原创不易，请尊重版权】【未经授权禁止转载】【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】
• 由于考虑到不同业务场景下，对浏览器兼容性【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net又有考虑，所以，对SDK的可扩展性以及功本文作者：唐霜，转载请注明出处。【转载请注明来源】能可替换性有要求
本文作者：唐霜，转载请注明出处。【本文受版权保护】

因此，实际上，我们作为SDK的作者，要考著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net虑两种场景：SDK直接被网站引用（开箱即【未经授权禁止转载】【未经授权禁止转载】用），或者被开发者引用（二次开发）。多次转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net重构中，我逐渐摸索出一套共性的东西，并将【本文受版权保护】【版权所有】唐霜 www.tangshuang.net它以框架的形式在腾讯内部发布。

著作权归作者所有，禁止商业用途转载。【作者：唐霜】

通用的前端监控SDK框架

作为框架，它的主要面向用户是开发者，它并【作者：唐霜】转载请注明出处：www.tangshuang.net不提供直接的功能，而是提供创建功能的底层本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。接口，让开发者通过接口完成功能开发。我刚本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】开始撰写用户行为还原SDK时，将所有的功著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net能耦合在一起，仅仅是为了完成用户行为信息原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net收集和上报的功能。但是，随着我想要收集的【本文受版权保护】本文版权归作者所有，未经授权不得转载。信息的扩展，我发现之前的设计并不好，因为转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net每加一个方面的信息，就要再次耦合其中。于【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。是我开始了漫长的重构。

本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。

目标很明确，每加一个方面的信息收集能力，原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。不需要修改原有代码，而是提供新的代码，在本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net把新代码模块导出的接口插入到已有代码的某【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。处。于是，一个基于插件系统的架构浮现在我【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】脑海中。比如我现在想要收集用户进入我的网未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】站到离开我的网站之间的时间这样一个信息，【未经授权禁止转载】【作者：唐霜】我不需要修改SDK原有的代码，而是写一个本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】插件，按照SDK的规范，提供不同生命周期未经授权，禁止复制转载。【转载请注明来源】节点上的钩子函数，就可以了。

【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】 未经授权，禁止复制转载。【转载请注明来源】【本文首发于唐霜的博客】

生命周期

既然提到了生命周期，那就来聊一聊生命周期本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。吧。

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net

我向开发者提供了一个类，姑且叫 TheLogger 吧。开发者需要实例化这个类，实例化时，【原创不易，请尊重版权】【版权所有，侵权必究】传入各种参数，参数中就包含了插件，这个后【本文受版权保护】【转载请注明来源】面聊。实例在内存中运行，它会经历给个节点转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net，完成日志的收集和上报。

转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net

init (实例化阶段) -> servup (启动服务阶段) -> start (开始收集) -> write (写入日志) -> stop (停止收集) -> destroy (实例销毁)
                                               ^                                    /
                                                `-------------(重新启动)------------

SDK在这些生命周期节点上提供钩子，插件原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net们则在这些钩子上挂载一些函数，当框架运行著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。到这些生命周期节点上时，就会触发插件的函著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。数，以实现插件的功能。

【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。

以如何收集用户的点击事件为例子。当实例化【版权所有，侵权必究】原创内容，盗版必究。时，会去调用插件的options和ini【本文受版权保护】【作者：唐霜】t方法，用以获取插件的配置和在SDK实例【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。化时做一些工作。 实例化过程中，SDK会本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。启动服务，这个过程对于插件而言，都是启用著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。过程，插件如果有自己的服务，可以在这个阶【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】段启动起来。启动之后，SDK服务就像一个本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】运转中的轮子，当轮子开始转时，把插件挂上【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。去，于是轮子就有了插件提供的能力。接下来本文作者：唐霜，转载请注明出处。【转载请注明来源】，在插件中，我们要收集用户的点击信息。如原创内容，盗版必究。【本文受版权保护】何收集呢？当然是addEventList【版权所有】唐霜 www.tangshuang.net【作者：唐霜】ener啦。让插件暴露一个start方法【未经授权禁止转载】本文作者：唐霜，转载请注明出处。，这个方法会在SDK运转到start这个【关注微信公众号：wwwtangshuangnet】【本文受版权保护】生命周期节点时被调用。在start钩子中【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】，插件可以通过addEventListe转载请注明出处：www.tangshuang.net原创内容，盗版必究。ner对用户的点击事件进行监听，回调函数转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】中可以使用this.write方法把收集本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。到的信息，写入到SDK服务中。在stop【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net钩子函数中解除监听。这样，插件自己的任务【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】就完成了。在写入日志时，也可以提供wri本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。te钩子方法，对写入的日志进行改写。

【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。

关键不在于使用哪些名称的方法，关键在于，我采用了一套插件系统，开发者通【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】过自己撰写一个插件，就可以在SDK原来的【本文受版权保护】【转载请注明来源】基础上，收集更多信息，为SDK提供更丰富本文作者：唐霜，转载请注明出处。【作者：唐霜】的功能。几乎所有的功能，都可以基于插件去完成，C未经授权，禁止复制转载。原创内容，盗版必究。ore是一个基于生命周期的调度器而已，不【本文首发于唐霜的博客】【转载请注明来源】断调用插件的各个方法实现功能。

【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

生命周期的设计，几乎是所有系统设计的共性未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。，我们现在回来看生命周期，会发现，生命周【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】期是一个系统，一个存在运行时系统的核心，【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net不同的业务场景下，我们提炼出来的生命周期【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。节点是不一样的，流转图也是不同的。在前端【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。监控这个领域，SDK的生命周期却都大致相【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net同，因为业务场景基本一致。它围绕监控日志【作者：唐霜】【转载请注明来源】的收集、存储、上报进行展开，所以，基本就【关注微信公众号：wwwtangshuangnet】【转载请注明来源】是这些流程。一旦这个基本的生命周期流程确【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net定之后，插件的生命周期也就确定了。

【未经授权禁止转载】【原创不易，请尊重版权】

服务

这里的服务（Service）是“真服务”【版权所有】唐霜 www.tangshuang.net【作者：唐霜】，它通过一个常驻的运转流程，不断的监听事【作者：唐霜】【作者：唐霜】件，当事件发生时提供一个响应。在TheL著作权归作者所有，禁止商业用途转载。【转载请注明来源】ogger中，我提供了一套内置的服务，这【版权所有，侵权必究】【版权所有，侵权必究】套服务基于indexedDB+webwo转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。rker，在后台不间断运行。但这套内置的著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。服务是解耦的，它并不属于框架的一部分，框本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。架并不提供具体的服务，只是提供了服务的抽【版权所有】唐霜 www.tangshuang.net【转载请注明来源】象接口。开发者拿到SDK框架之后，默认是著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。不包含服务代码的，开发者可以用一个ext【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】ends关键字，重写serve, sen本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】d方法，把服务挂载进去（通过插件也可以实【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。现）。

【原创不易，请尊重版权】【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net

这种设计的好处在于，如果你并不喜欢我的内【原创内容，转载请注明出处】【转载请注明来源】置服务，你可以不用它，而代码并不在框架中原创内容，盗版必究。未经授权，禁止复制转载。，因此，你最终打包的代码并不包含这部分内【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】容。我在为公司内的一个监控平台Aegis【未经授权禁止转载】【原创不易，请尊重版权】提供用户行为监控的能力时，由于Aegis转载请注明出处：www.tangshuang.net【作者：唐霜】平台有自己的日志存储和上报体系，因此，我【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。不需要把我自己的Service部分再塞到未经授权，禁止复制转载。【版权所有，侵权必究】我提供的SDK中，而是只挑选了要使用到的【版权所有，侵权必究】转载请注明出处：www.tangshuang.net插件，打包之后，再到Aegis中提供一个【未经授权禁止转载】转载请注明出处：www.tangshuang.net基于该打包后的SDK的Aegis插件，这转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。样，对于下游用户而言，他们使用了一个Ae【本文受版权保护】【本文首发于唐霜的博客】gis插件，而这个Aegis插件拥有了T【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。heLogger的功能。

未经授权，禁止复制转载。【版权所有，侵权必究】【本文首发于唐霜的博客】

一个运行中的服务，本质上就是一个资源消费【本文首发于唐霜的博客】【原创不易，请尊重版权】系统。你需要用资源喂它，让它按照它被设计【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。的方式产出效果。在前端监控SDK里面，这本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。个服务就是你把日志喂给它，然后让它按照一【版权所有，侵权必究】【本文受版权保护】定的逻辑上报到后台。所以，我设计时，要求【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。开发者从serve和send两个方法实现【未经授权禁止转载】【原创不易，请尊重版权】服务。serve方法用于实例化服务，也就【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】是说在SDK中，你将以什么样的服务处理日原创内容，盗版必究。【本文首发于唐霜的博客】志的存储和上报。send方法则是喂日志/本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。消息。send方法接收一个消息，当typ【未经授权禁止转载】【转载请注明来源】e为不同值时，表示要求服务干一件对应的事【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net情，例如type=write表示要服务把【未经授权禁止转载】【本文受版权保护】我丢过去的日志写入到本地存储中，当typ原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。e=report时表示要服务把我之前丢进【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】去的日志上报到服务器上面。当然，不同的开本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。发者在实现send方法时，具体实现不同，本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net极端情况下，我们提供一个同步的服务，当 send({ type: 'write', data }) 发生时，直接将该日志发送到服务端，不需【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。要在本地进行存储，这种情况下，serve【未经授权禁止转载】【原创内容，转载请注明出处】方法不需要写任何内容，在send中直接调【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net用上传接口。

【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。

插件

插件是完成日志收集的主要场所。插件暴露的本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。接口有两种类型，一种是为SDK框架所调用【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】的生命周期函数，另一种是为增强SDK功能【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】的功能函数。

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net【作者：唐霜】【未经授权禁止转载】

因为插件的生命周期函数会被SDK的生命周【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】期钩子勾着走，所以单纯看插件代码，插件自【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net身仿佛也有了生命周期。比如，你可以说插件本文作者：唐霜，转载请注明出处。【本文受版权保护】在实例化、启动、停止时都在做什么。在设计【作者：唐霜】【本文首发于唐霜的博客】时，我着重强调start/stop两个过【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。程。start过程是插件真正的收集开始自本文作者：唐霜，转载请注明出处。原创内容，盗版必究。动化开展过程，stop则是停止这个自动化【版权所有，侵权必究】【原创内容，转载请注明出处】过程。比如对用户鼠标轨迹的收集，在sta【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。rt中通过addEventListene转载请注明出处：www.tangshuang.net【转载请注明来源】r启动监听，自动收集，而在stop中re【本文受版权保护】【本文首发于唐霜的博客】moveEventListener停止这【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】个自动收集过程。

本文版权归作者所有，未经授权不得转载。【作者：唐霜】【未经授权禁止转载】本文作者：唐霜，转载请注明出处。

但，插件的运作方式并非只有自动一种。某些【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。情况下，我们可能不依靠自动收集，而是手动著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。收集，通过在业务代码中调用SDK实例的一本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。个方法记录一条日志。比如，你只想记录某一【本文受版权保护】【转载请注明来源】个button被点击的次数，你直接将插件转载请注明出处：www.tangshuang.net【本文受版权保护】的一个功能函数绑定到该button的cl【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。ick事件上，这样就完成对单一对象的事件【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。收集。这时，插件需要做的，是提供一个功能本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】函数（接口），方便你在业务代码中调用。当【版权所有，侵权必究】【未经授权禁止转载】然，功能函数千变万化，提供什么功能，完全【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。看开发者自己。关键的核心，不在于函数本身，而在于插件是【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】增强SDK系统的一种方式。因为插件系统的设计，配合生命周期，你可以【作者：唐霜】【版权所有，侵权必究】在SDK的框架上，开发出任意的客户端信息【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。收集的逻辑。

【原创不易，请尊重版权】【本文受版权保护】【转载请注明来源】

前端监控SDK的设计技巧

现在，你有了SDK框架，接下来，你应该利【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】用该框架，撰写一个属于自己的SDK了。当著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】然，作为一个前端监控SDK，它必须配合后著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。端的一些规则，不过，由于一般的日志存储系【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】统都是NoSQL的，所以，只要一条符合设【原创内容，转载请注明出处】【原创内容，转载请注明出处】计的日志，都可以被存到后端数据库中。我们【作者：唐霜】【原创不易，请尊重版权】这里要探讨的是，在你的SDK中，可能会涉【原创内容，转载请注明出处】【转载请注明来源】及一些技巧，以解决某些实际的问题。

原创内容，盗版必究。【作者：唐霜】【本文首发于唐霜的博客】【作者：唐霜】

延时批量上报

有些监控系统是实时上报的，有的甚至为了确【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。保收集到的信息的完整性，采用<img/>的形式上报用户点击。但是，这种上报在确保未经授权，禁止复制转载。未经授权，禁止复制转载。实时性和完整性的同时，给后端带来了巨大压著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。力，如果一个网站具有极大的PV，那么日志【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。上报接口将面临巨大的流量压力，弄的不好是【本文首发于唐霜的博客】【原创不易，请尊重版权】自己给自己创造DDos。而解决的办法之一未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。，就是延时批量上报。比如收集到10条后，原创内容，盗版必究。【本文受版权保护】再一起上报。但是假如一直收集不到10条呢【未经授权禁止转载】【未经授权禁止转载】？你可以说10条都不到，没有价值。不过，【版权所有，侵权必究】【原创不易，请尊重版权】我们可以通过一个throttle的设计，著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】让它在一定时间周期内上报。

【原创内容，转载请注明出处】【版权所有，侵权必究】未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

还有一种，我们并不采取主动策略自动上报日【本文受版权保护】未经授权，禁止复制转载。志，而是要等到服务端来索要日志，我们内部【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。黑话叫“日志捞取”。可以通过websoc本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。ket或用户访问某些接口的时候，下发一个【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】指令，SDK得到这个指令之后再上报。这就本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。要求，日志数据事先要放在客户端（浏览器）未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net。这就涉及到一个前端数据存储的问题。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。

前端数据存储

如前文所说，如果我们将日志放在内存里面，【原创不易，请尊重版权】【作者：唐霜】那么用户刷新页面，或页面崩溃，这部分数据原创内容，盗版必究。【原创内容，转载请注明出处】就丢失了。当然，如果不需要延时上报，立即本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。上报的情况下，前端并不需要存储日志，但是本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】，我们设计的是延时批量上报，这样可以给我原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。们带来一些特性，比如按需捞取。既然如此，【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】我们就需要挑选一个前端数据存储的方案。我【本文首发于唐霜的博客】原创内容，盗版必究。推荐的存储方案是indexedDB，和l【未经授权禁止转载】【版权所有，侵权必究】ocalStorage相比而言，它不仅具未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。有较大的容量（500M），更重要的一个原本文作者：唐霜，转载请注明出处。原创内容，盗版必究。因在于localStorage无法在we【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.netbworker中被读取，而在我的设计中，著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。有一种方案时在webworker中处理日【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。志和上报日志。

【作者：唐霜】【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net

但是，indexedDB也有不少坑，包括【本文受版权保护】著作权归作者所有，禁止商业用途转载。webworker的坑也不少。index本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。edDB的原生操作比较复杂，你可以使用我原创内容，盗版必究。未经授权，禁止复制转载。写的库indb实现indexedDB的操作。我在设计时【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net，使用了三个store，一个是confi转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.netg，用于在主线程和worker线程之间共本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。享配置，一个是archive，用于存储所本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。有日志，一个是moment，用于存储需要著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】立即上报的日志的索引信息（索引字段）。由本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】于indexedDB是严格的NoSQL数本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。据库，所以非常适合存储日志。archiv【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。e这个store将会保存所有被收集到的日未经授权，禁止复制转载。【原创内容，转载请注明出处】志，存储的时候，并不需要按照某个顺序存，原创内容，盗版必究。【本文受版权保护】而且为了更快存入，存储过程不需要复杂逻辑未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。。

转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。

上报策略

我在设计时，采用了三种不同的上报周期：

未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】【作者：唐霜】

• 批量上报，任何日志，都写到archive【版权所有，侵权必究】未经授权，禁止复制转载。 store中，不需要任何顺序，因为正常【作者：唐霜】【作者：唐霜】用户操作的顺序并不代表日志入库顺序，因为未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】操作会有异步的情况，archive st本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。ore中存储着全部被收集的没有被上传的日【本文首发于唐霜的博客】【转载请注明来源】志
本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】【原创内容，转载请注明出处】
• 立即上报，当发生错误或异常时，往mome【未经授权禁止转载】未经授权，禁止复制转载。nt store里面写入对应的日志索引，未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。立即上报的周期比较短，所以，当周期到来时著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】，直接将moment store中的全部【作者：唐霜】原创内容，盗版必究。索引取出，然后到archive stor本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.nete中取出索引对应的全部日志，一次性上报
【本文受版权保护】转载请注明出处：www.tangshuang.net
• 回溯上报，在某些情况下，archive 【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netstore中的日志过了很久的时间都没有被【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】上报，这种情况造成的原因多种多样，不好确本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】定，但是，这些日志可能又是有用的，因此，【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。在一个比较长的周期里面（小于7天，因为i【作者：唐霜】【原创不易，请尊重版权】ndexedDB的新策略是会删除7天之后著作权归作者所有，禁止商业用途转载。【本文受版权保护】的数据），要从尾往前遍历，把早期存入的但【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net没有上报的日志再次上报
【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

在日志设计时，通过日志中的level字段【版权所有，侵权必究】未经授权，禁止复制转载。来判别该日志属于什么级别。我自己在处理时转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。，error的是立即上报，其他的是批量上原创内容，盗版必究。【转载请注明来源】报。实际上，我们还可以设计一种有选择性的【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net上报，比如有些日志上报了没啥意义，可以不著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。用上报，让浏览器自己处理过期日志，但是，【原创内容，转载请注明出处】未经授权，禁止复制转载。如果我们通过服务端发送捞取指令时，又马上【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】把这些日志组织起来进行上报。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

上报压缩

为了减小流量，我们需要对要上报的日志进行转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net压缩。我自己使用了一个叫pako的库来进【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】行gzip压缩，但是压缩会有一个问题，由【版权所有，侵权必究】【版权所有，侵权必究】于压缩算法本身要占据一定容量，所以，如果【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。不采取批量上报的逻辑，那么不需要任何压缩【本文首发于唐霜的博客】原创内容，盗版必究。，只有当批量上报，且上报数量达到一定数量本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。时才进行压缩，否则压缩一条日志，反而让日【原创不易，请尊重版权】原创内容，盗版必究。志容量变大，还要增加服务端解压压力。

【本文受版权保护】【转载请注明来源】本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

任务/线程

对于一个前端监控的SDK而言，它有可能和【未经授权禁止转载】本文作者：唐霜，转载请注明出处。页面中的其他脚本一起强资源，导致页面卡顿未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。。因此，我们要想办法，降低SDK对界面的本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】影响。我提供了两套方案：

【版权所有】唐霜 www.tangshuang.net【作者：唐霜】

1. 启用一个webworker，将所有日志的【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。处理、存储、上报等等，全部放在worke【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】r线程中，主线程仅仅完成数据收集部分，这未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。样，可以降低日志处理上报时，读写数据库等【版权所有，侵权必究】未经授权，禁止复制转载。操作带来的卡顿
【未经授权禁止转载】本文作者：唐霜，转载请注明出处。
2. 直接在主线程完成日志处理和上报，但是创建本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net一个idle任务，只有当页面存在空闲时，【转载请注明来源】【转载请注明来源】才执行日志处理和上报，当用户在界面进行操未经授权，禁止复制转载。【作者：唐霜】作，并且需要更新界面时，任务会被暂时搁置【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】，等到有闲暇时间时再进行
原创内容，盗版必究。【本文受版权保护】

但是，由于js是单线程运行，所以，即使任【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。务是异步执行的，仍然还是会占用资源。作为【本文受版权保护】转载请注明出处：www.tangshuang.net监控SDK，要尽可能不对运行程序产生任何【未经授权禁止转载】未经授权，禁止复制转载。影响。

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。【作者：唐霜】【未经授权禁止转载】

异步加载插件

在为Aegis撰写插件时，我们发现SDK【未经授权禁止转载】【转载请注明来源】包的体积对收集到一些特定信息很关键，例如未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。应用启动时的数据。如果SDK包很大，半天【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】加载不完，等脚本加载完，早都已经过了收集著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】的窗口了。所以，在这种场景下，我们要让S著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】DK尽可能小（10K以内）。但是，很明显本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】，有些功能，这么小体积是不够的。因此，我【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】们设计了一套异步加载的插件体系。对于这些著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】插件而言，它们分为两部分，一部分是直接挂【本文首发于唐霜的博客】【本文首发于唐霜的博客】在SDK内部，也就是10K以内的代码里面本文版权归作者所有，未经授权不得转载。【转载请注明来源】，收集一些启动时的数据，而收集到的数据暂著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。时放在内存中，等异步代码加载完运行之后，原创内容，盗版必究。【版权所有，侵权必究】再取出来做下一步处理。

【本文受版权保护】【本文受版权保护】

打点/无埋点

SDK的灵活性也很重要，在最前面我提到，【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。假如开发者只想监听用户在某3个页面之间的【作者：唐霜】本文版权归作者所有，未经授权不得转载。操作信息，而不是全部页面的操作信息，该怎【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。么处理呢？所以，在设计上，我们要提供不同本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net的打点、上报的方式。我在设计时，提供了“原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】无埋点、片段、单点”x“自动上报、手动上著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。报”的不同组合方式。针对上述问题，这里简原创内容，盗版必究。原创内容，盗版必究。单讲一下怎么实现片段埋点。在前文Serv著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】ice那一节我已经指出，对于用户行为的监未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。听本质上是一个服务，既然是一个服务，那么【未经授权禁止转载】【原创不易，请尊重版权】就可以让这个服务开始或停止。因此，在上述【转载请注明来源】【转载请注明来源】这个具体问题上，当用户进入指定页面A时，【本文受版权保护】【本文首发于唐霜的博客】启动服务，服务启动之后，用户的所有操作就【本文受版权保护】【关注微信公众号：wwwtangshuangnet】会被记录到日志中，用户经过B页然后离开C转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。页时，停止服务，那么用户的这段操作就结束【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。了，这一连串相关的日志，会被一个相同的t【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。raceId串联起来。同样的道理，上报本【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。身也是一个服务，如果我们再实例化时，让服【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net务自动运行，上报自动完成，我们也可以选择【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net关闭这个能力，通过手动调用report方【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】法来触发上报逻辑。

【作者：唐霜】【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】【版权所有，侵权必究】

隐私策略

监控行为可能涉及到一些隐私策略问题。不同转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】的产品，其隐私策略也是不同的。对于开放性【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】大众产品，针对单用户的行为进行分析，很可【未经授权禁止转载】【作者：唐霜】能能得出针对该用户的一些预测行为，这对商【本文受版权保护】转载请注明出处：www.tangshuang.net业公司的吸引力非常大。但是我们要知道，互未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。联网不是法外之地，我们在实现能力的时候，原创内容，盗版必究。【版权所有，侵权必究】应该尊重和保护用户隐私。针对隐私问题，S【版权所有，侵权必究】【作者：唐霜】DK框架应该提供可扩展的能力，遵循“开放【本文受版权保护】著作权归作者所有，禁止商业用途转载。封闭原则”，让开发者可以自己根据产品需要本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】，有可以与用户交互的过程，而非一股脑全部【作者：唐霜】【版权所有，侵权必究】封装死，不管三七二十一收集和提交日志。针转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】对这个方面，我在设计时，做了如下约束：

【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net

• 任何与密码相关的数据不会被记录，包括用户转载请注明出处：www.tangshuang.net【转载请注明来源】鼠标在该元素上的操作
【未经授权禁止转载】未经授权，禁止复制转载。原创内容，盗版必究。
• 提供特定的html标记，这些标记元素产生【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】的信息不会被收集
未经授权，禁止复制转载。【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】
• 提供特定的方法，让开发者可以在方法中过滤【未经授权禁止转载】原创内容，盗版必究。日志，或者做脱敏处理
【转载请注明来源】【版权所有，侵权必究】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。
• 在运转流程上，SDK不是一股脑只完成自己本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】的任务，开发者可以控制SDK的运作，比如【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net只有在征得用户同意后才上传日志
【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

总之，隐私策略是产品策略中的重要一环，也【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。是目前我们国家重点关注的一个方面，任何与转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。监控相关的设计都应该慎重考虑。

本文作者：唐霜，转载请注明出处。【作者：唐霜】

结语

本文详细阐述了我在前端监控SDK框架的设【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】计上的一些经历，虽然没有具体的实现代码，原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】但是文章中所提出的这些理念，都可以帮助开转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。发者实现一款自己的SDK框架，在工作中发原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。挥作用。

著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】