跳转至

数据采集自定义规则

本文说明 Cocos Creator 自动采集 View、Action、Resource 和 Console Log 时的默认规则,以及需要自定义名称或过滤范围时的处理方式。RUM 手动埋点统一在 RUM 配置中说明,自定义日志写入统一在 Log 配置中说明。

View

开启 autoTrack.scenes 后,SDK 使用 Cocos 场景名作为 View 名称。场景切换时会结束前一个 View,再为新场景启动 View。

当前 Cocos Creator SDK 不提供自动 View 名称转换或过滤回调。如果需要自定义 View 名称或跳过部分场景,应关闭 autoTrack.scenes,并通过 guanceSdk.rum.startView()stopView()手动管理 View。

Action

开启 autoTrack.actions 后,全局 TOUCH_END 事件会生成 Action:

  • 优先使用事件目标节点名作为 Action 名称;
  • 目标节点没有名称时使用 CocosTouch
  • Action 类型为 click
  • 附加属性包含触摸位置 xy

当前 Cocos Creator SDK 不提供自动 Action 名称转换或过滤回调。如果需要自定义名称、属性或采集范围,应关闭 autoTrack.actions,并通过 guanceSdk.rum.addAction()startAction()手动上报。

Resource

开启 autoTrack.network 后,SDK 自动采集当前 JavaScript 运行时中的 fetchXMLHttpRequest,并记录 URL、HTTP 方法、请求头、响应头、状态码和请求耗时。

当前 Cocos Creator SDK 不提供 URL 过滤或 Resource 内容处理回调。如果需要排除请求、补充自定义属性或使用自定义网络栈,应关闭 autoTrack.network,并通过 guanceSdk.rum.startResource()stopResource()addResource()手动采集。需要注入 Trace Header 时,使用 guanceSdk.trace.getHeaders()

自动与手动二选一

对同一个 View、Action 或 Resource,只使用自动采集或手动采集中的一种方式,避免产生重复数据。

Console Log

开启 autoTrack.console 后,SDK 会包装 console.log/info/warn/error 并写入 Log。当前不提供 Console 内容过滤或转换回调;需要筛选日志内容时,应关闭 autoTrack.console,并通过 guanceSdk.logger.log()写入经过业务筛选的自定义日志。

文档评价

文档内容是否对您有帮助?