聚合规则
新错误事件按以下顺序归入 Issue:- 与已有 Issue 的指纹相同,归入该 Issue。
- 指纹不同但错误相似,归入最相似的 Issue。相似度只在同一出错位置的 Issue 之间比较。
- 没有相似的 Issue,创建新 Issue。
RenderProcessGone、ChildProcessGone)、Flutter、React Native 应用中的 NDK 崩溃,以及取到了位置的 iOS App Hang、HarmonyOS 冻结 / 卡顿与 Android ANR 只按指纹聚合,不做相似度归并。这类事件的错误消息几乎相同,按相似度归并会把不同位置的崩溃合为一个 Issue。
默认指纹
当错误事件没有携带指纹时,Flashduty 用以下属性计算指纹。Web 应用接入 SDK 的方法见 Web SDK 接入。出错位置
同一句错误消息可能从互不相关的地方抛出。只按消息聚合,应用里每一处Cannot read properties of undefined (reading 'id') 都会落进同一个 Issue。因此 Flashduty 还把出错位置计入指纹。
位置只保留重新构建后仍然不变的部分:不带行号与列号,不带构建哈希,也不带压缩或混淆后的短名。
没有符号的应用帧按镜像内偏移区分,这个偏移只在单次构建内稳定,因此同一个 iOS 崩溃在每次发版后都可能变成一个新建的 Issue。
iOS 上已处理的错误不取出错位置:这类消息本身通常说明了原因,不取位置才能让已有 Issue 继续接收它们。Android NDK 原生崩溃也不取,它已按堆栈中最顶层的应用原生帧聚合。取不出稳定位置的错误(例如只有混淆帧的 Android 异常)仍只按类型和消息聚合,也只与同样没有出错位置的 Issue 做相似度归并。
Android ANR 的消息固定是
Application Not Responding,HarmonyOS 冻结 / 卡顿的消息也是常量,所以它们只靠出错位置区分:定位到位置的 ANR 与冻结 / 卡顿按位置各成 Issue,不做相似度归并。
自定义指纹
若默认聚合无法满足需求,您可以通过提供自定义指纹(fingerprint)完全控制错误的聚合行为。- 手动添加指纹
- 使用 beforeSend 回调
在手动报告错误时,通过
addError 添加自定义指纹:- 自定义 fingerprint 必须为字符串类型
- 相同服务中具有相同 fingerprint 的错误将被归入同一 Issue
- 不同服务的错误即使 fingerprint 相同也会被归入不同 Issue
- 可用
beforeSend回调过滤无关错误,见下文“第三方脚本错误过滤”
Web 特定注意事项
SourceMap 集成
SourceMap 集成
上传
sourcemap 文件以解码压缩后的堆栈跟踪,确保聚合后的错误堆栈可映射到原始源代码。第三方脚本错误过滤
第三方脚本错误过滤
SDK 不会自动过滤浏览器扩展或第三方脚本产生的错误。如需排除,请在
beforeSend 中配置:查看聚合结果
在 Flashduty 平台,导航至「异常追踪」,查看聚合后的 Issue 列表。点击应用卡片上的 Issue 数字,可直达该应用最近 24 小时、状态为「全部」的 Issue 列表,条数与卡片一致。 每个 Issue 包含:下一步
Issue 状态
了解 Issue 状态流转机制