fast-tracker-browser/README.md

用户行为、应用性能、应用异常一体化采集

# 天眼FAST探针（Browser）

[接入指引](https://open.mingyuanyun.com/knowledge/fast/197c123e-560f-ee11-b4d3-9b0e7cef06ab)

## 版本日志（CDN持续保持最新，以下仅针对npm版本）

### 1.0.1-r27

1. 修复app_version被空值覆盖的问题

### 1.0.1-r26

1. 支持通过全局变量修改初始化配置项（指定配置项包含：endpoint、include_search、collect_event_types、report_api_params、trace_config）
1. 被迫改了个需要setBasicInfo兼容的字段，哈哈哈
1. 支持服务端通过响应头（x-fast-trace-id）提供分布式链路的跟踪ID

### 1.0.1-r25

1. 将会话ID刷新间隔修改为30分钟（原16分钟）以避免出现到达页面停留最大时长30分钟时自动上报的页面停留日志处于与页面访问日志不同会话的问题

### 1.0.1-r24

1. 修复对特殊url路径的page_search采集

### 1.0.1-r23

1. 增加约定的全局变量\_\_fastTrackerAppName\_\_，表示应用名称，如果设置将在日志中替代配置传入的app，作为app字段上报
2. 增加约定的全局变量\_\_fastTrackerGlobalModule\_\_，表示全局业务功能模块，优先于setBasicInfo设置的globalModule生效;

### 1.0.1-r22

1. 新增用户名称、用户角色、用户岗位、用户所属组织日志字段
2. 新增用户名称、用户角色、用户岗位、用户所属组织的自动读取配置项
3. 探针API——registUser扩展用户名称、用户角色、用户岗位、用户所属组织4个字段

### 1.0.1-r21

1. 将可采集到的navigationEntry中的各时间戳恢复到首屏的page_load日志的tags字段内

### 1.0.1-r20

1. 添加鹰眼的采集API地址至内置屏蔽清单
2. 每次XHR上报API日之后即清除实例中的traceId，避免重复日志产生

### 1.0.1-r19

1. 修复关闭页面、超大日志上报可能会出现重复日志问题
2. page_load事件支持postMessage向外部窗口提供数据订阅
3. 页面加载事件采集重构：将原有的fmp、page_load事件名统一为page_load  详细说明请[查看文档](https://open.mingyuanyun.com/knowledge/fast/homepage)
4. 修复探针初始化在DOMContentLoaded之后时首次有效渲染触发的页面加载无法采集的问题
5. 优化fmp算法
6. 补充页面参数和API参数采集时需要屏蔽的敏感信息参数名称
7. 修复产生日志时，没有每次都获取当前document.title的问题

### 1.0.1-r18

1. 修复FMP对于持续有动画的页面无法触发结算导致内存溢出的问题

### 1.0.1-r17

1. API:setBasicInfo更新，支持globalModule参数，对于所产生的所有日志，日志自由module > globalModule
1. API:reportError更新，新增module参数
1. 修复对于MFastLog插件的API:setExtraLogs在调用时因参数存在null值导致的异常

### 1.0.1-r16

1. 支持window.__fastTrackerLogEnv__变量来设置日志归属环境
1. 关闭探针自身的性能日志采集

### 1.0.1-r15

1. 修复应用热更新版本没有写入到日志字段中的问题
1. 将encodeBase64方法中在字符越界时的Throw Type Error改为输出警告，并返回原字符串，避免探针阻碍应用运行
1. reportError上报不再受collect_event_types配置项控制
1. 移除fmp事件中可能冗余的__fastCurrPage__字段
1. 调整API采集机制，避免可能丢失的API日志（例如删除过ResourceEntry数据时）
1. 确定初始上报env的机制调整为：初始化传参env > window.\_\_fastTrackerEnv\_\_ > "prod"
1. 适配MFastLog-v1.0.7支持识别鸿蒙操作系统
1. 修改webpack配置中output.globalObject为this

### 1.0.1-r14

1. 修复页面事件触发时机晚于一些页面组件Didmount类声明周期触发的问题
1. 修复触发页面跳转的点击事件晚于页面事件触发的问题
1. 调整时间戳的生成方法

### 1.0.1-r13

1. 修复api日志中的冗余了tags.regxApiUrl字段的问题

### 1.0.1-r12

1. 把页面标题加入内部维护的页面参数中，使上报对应的page_title字段与其他（domain、page等）保持一致的更新机制

### 1.0.1-r11

1. 补充遗漏的navigator.connection.type为cellular的判断
1. 补充有网模式下进行的MFastLog.startUploadLog调用，以保障断网场景下产生的文件被上传

### 1.0.1-r9

1. 增加enable配置项，用于控制是否启用日志上报（某些私有化部署不允许上报日志）
1. 增加API:setEnable，用于设置enable配置项
1. 支持api_url_regx，用于截取API地址

### 1.0.1-r8

1. 外部订阅数据补充env字段
1. 修复是否调用MFastLog写入日志的网络状态属性读取错误

### 1.0.1-r7

1. 移除domain字段中的协议部分
1. 限制每2分钟调用一次MFastLog.startUploadLog，避免插件调用过频
1. 限制仅wifi及4g以下的网络使用MFastLog写入和上报日志

### 1.0.1-r5

1. 重写page事件的逻辑，避免日志上报在错误的当前页


### 1.0.1-r4

1. 修复在没有replay.logstore时replay.endpoint被丢弃的问题
1. 新增trace_config.tid_type配置项，用于设置trace_id的模式，支持fast（默认）和skywalking两种模式

### 1.0.1

1. 修复传递给MFastLog插件的endpoint缺少env参数的问题
1. 修复回放日志上报endpoint缺少env参数的问题
1. 修复fetch方法传递通过Headers构造的请求头参数时在添加trace-id请求头后原请求头丢失的问题

### 1.0.0

1. 适配天眼3.0新的日志结构
1. 对接天眼3.0日志服务
1. 适配新的Cordova插件MFastLog
1. 修复在页面LOAD事件触发前使用Image上报导致页面LOAD事件被推迟的问题