is_crash 标记的 error 事件进入同一条管道。
默认上下文
SDK 初始化后,会为每条事件附加通用上下文。clientToken 只用于上报鉴权,不会写入 RUM 事件。会话规则
SDK 按会话进行采样和生命周期管理。View 事件
View 表示用户正在查看的页面或业务视图。您可以通过自动路由追踪或手动 API 生成 view。Action 事件
Action 表示用户操作。即时操作通过addAction() 记录,带耗时的操作通过 startAction() 和 stopAction() 记录。
Action 事件包含
action.id、action.type、action.target.name 和 action.loading_time。通过 FlashcatRum.trackTap() 自动记录的操作类型为 tap。
Resource 事件
Resource 表示网络请求。SDK 会在以下场景生成 resource:- 使用
rcpsession 并添加FlashcatTrace.interceptor() - 使用
FlashcatHttp.request()包装@kit.NetworkKit请求 - 使用
@flashcatcloud/axios的trackAxios()接入 axios 实例 - 用
FlashcatTrace.startTracedResource()接入其他网络栈
setTrackNetworkRequests(true)。此外还可以通过
GlobalRumMonitor.get().startResource() 和 stopResource() 手动记录,该方式不受此开关影响。
自动网络采集的资源类型映射:
如果请求失败,SDK 会生成
source: "network" 的 error 事件,并在 error.resource 中附带请求方法、状态码和 URL。
Error 事件
Error 表示手动上报错误、未捕获 ArkTS 异常、未处理的 Promise rejection、网络错误、崩溃或卡死。
RUM 会自动监听
errorManager.on('error') 和 errorManager.on('unhandledRejection')。未处理的 Promise rejection 会作为普通非崩溃 error 上报,不会触发退出或恢复策略。
Error 事件包含:
崩溃和卡死
Crash 模块通过实时和事后两条路径采集故障:- 主线程上未捕获的 ArkTS 异常会进入实时 JS 崩溃策略路径。
REPORT_THEN_EXIT和REPORT_AND_RECOVER会在进程退出或重启前同步持久化 SDK 待处理崩溃记录;REPORT_AND_CONTINUE会把崩溃实时上报到当前会话,进程继续运行,不写入待处理记录 - 下次启动时,Crash 模块会把 SDK 自身的待处理记录回放到 RUM,标记为已消费后删除持久化文件
- HarmonyOS
hiAppEvent会在后续启动时回放APP_CRASH和APP_FREEZE,用于采集 ArkTS、Native C/C++ 崩溃和卡死
error.source_type: promise 的普通非崩溃 RUM error。它不会使进程退出,也不会进入崩溃策略路径。
崩溃归因
崩溃和卡死会归因到故障真正发生的那个会话和视图,而不是回放它的那次启动。两类故障的归因依据不同:- SDK 能在进程内观察到的故障(主线程上未捕获的 ArkTS 异常)在退出前会把当时的 RUM 会话和视图一并写入待处理记录,下次启动按该记录回放
- SDK 无法在进程内观察到的故障(Native 信号崩溃、卡死)会直接杀死进程,来不及记录任何数据。SDK 会把每次写出的 view 事件快照到本地,下次启动时读取(读取后立即删除)并据此还原崩溃所属的会话和视图
is_crash error,并把该视图的 crash 和 error 计数各加 1。两项都写入成功才算完成,否则下次启动重试,避免原会话显示为无崩溃。
以下情况会回退为记入当前会话并使用当前时间,真实故障时间保留在 crash.crashed_at_ms 属性中:
- 视图已开始超过 4 小时(会话最长 4 小时,此时原会话已关闭)
- 故障发生距今已超过 23 小时(超过 24 小时的事件会被丢弃,因此崩溃必须在一天内上报才会归入原会话)
- 崩溃发生在第一个会话建立之前,或本地没有可用的 view 快照
- ArkTS / JS 错误栈会按 V8 风格帧解析
- Native C/C++ 栈会按
#NN pc <address> <lib.so>形式解析 - 如果上传了
sourceMaps.map、nameCache.json和未 strip 的.so,服务端会还原源文件、函数名、行列号和 Native 符号
上报行为
SDK 以 NDJSON 形式批量上报事件。当前不采集的内容
当前 HarmonyOS SDK 不自动采集以下数据:- Session Replay
- Web Vitals 或浏览器页面性能指标
- HarmonyOS 页面渲染性能指标
- 自动 frustration 事件