aegis 日志上报:
错误日志收集，实时日志监控，离线日志统计，前端性能监控 - 基于 badjs 升级的 aegis-report 给你一站式前端日志监控体验。
$ npm install aegis-report- npm
import AegisReport from 'aegis-report'
const aegis = new AegisReport({id: 1})
aegis.report('error msg') // 主动上报- browser
const AegisReport = window['aegis-report'].default
const aegis = new AegisReport({
id: 1,
uin: '380034641',
offlineLog: true,
offlineLogAuto: true
})上报 id 需要去 badjs 服务申请
| 参数名 | 默认值 | 简介 |
|---|---|---|
| id | 0 | 上报id |
| uin | 0 | user id |
| version | 0 | 上报版本号 |
| url | '//aegis.qq.com/badjs' | 上报接口 |
| ext | null | 扩展参数 用于自定义上报 |
| level | 4 | 错误级别 1-debug 2-info 4-error |
| ignore | [] | 忽略某个错误, 支持 Regexp 和 Function |
| random | 1 | 抽样 (0-1] 1-全量 |
| delay | 1000 | 延迟上报时间 |
| maxLength | 500 | 每条日志默认长度（不建议修改） |
| submit | null | 自定义上报方式 |
| repeat | 5 | 重复上报次数(对于同一个错误超过多少次不上报) |
| offlineLog | false | 是否开启离线日志 |
| offlineLogExp | 3 | 离线日志过期时间，默认3天 |
| offlineLogAuto | false | 是否自动询问服务器需要自动上报 |
| onReport | function (bid, reportLog) {} | 与上报同时触发，用于统计相关内容 |
| beforeReport | function (reportLog) {} | AOP：上报前执行，如果返回 false 则此条信息不上报 |
aegis.report(msg, true) // 上报错误事件，true 表示立即上报
aegis.info(msg) // 上报 info 事件
aegis.debug(msg) // 上报 debug 事件
aegis.addOfflineLog(msg) // 增加离线日志注意此方法为静态方法，使用 AegisReport 调用。
AegisReport.monitor(123) // 自定义统计上报接口，默认地址为 `//report.url.cn/report/report_vm`- 首先开启离线日志
const aegis = new AegisReport({
id: 1,
offlineLog: true,
offlineLogAuto: true
})- offlineLog 表示开启离线日志，将用户日志存储在 IndexDB 中
- offlineLogAuto 表示每次页面刷新的时候主动询问服务器是否上传离线日志
- 打开 badjs 离线日志页面 http://badjs2.ivweb.io/user/offlinelog.html
选择对应项目的离线日志，按照图示三步走即可
- 刷新项目页面（如果是mobile app则需要重新进入页面）
再次回到 badjs 离线日志页面，在右边栏选择对应的离线日志即可预览了，日志的过滤条件（消息类型，关键词）依然有效。
- 日志大小需要小于 10MB，根据测试，每条日志长度最大为 500，10000条日志的大小约为 600k，所以完全不用担心日志大小。超过 10MB 的日志服务器会返回 413。
关于错误处理的部分是通过重新 window.onerror 实现的，记得在 script 中添加跨域脚本 crossorigin="anonymous" 以帮助 aegis 捕获错误。
<script type="text/javascript" src="//s.url.cn/aaa.js" crossorigin="anonymous"></script>webpack 打包的项目可以使用 html-webpack-plugin-crossorigin。
通过封装 IndexDB 存储用户全部日志，包括对日志的过期处理以及上传操作。具体实现可以查看 src/Offline.js。
离线日志使用 pako 进行压缩，由于 pako 模块较大，因为默认不加载，通过按需加载的方式引用，只有上报离线日志的时候才异步加载。
默认时间为 1s，延迟上报可以理解为函数节流，将多次上报合为一次上报。
前端性能监控使用 performance.timing。// @todo
默认使用 navigator.sendBeacon 上报数据，异步上报，不会因浏览器页面的卸载而影响上报数据，对于不兼容 sendBeacon 的浏览器，使用 Image 上报的方式。
rollup 打包，支持 tree-shaking，打包后体积只有 8k，是 badjs-report 体积的 1/3。
example 使用说明
badjs 虽然实现了跨域，但是 badjs 服务器对域名限制（业务申请中填写业务 url），所以使用 example 需要使用代理机制。
MIT