
详细的聚合规则请参阅 异常聚合。
Issue 信息概览

Issue 列表支持按优先级排序,筛选条件默认包含「优先级」;每条 Issue 错误消息左侧的竖条颜色反映其优先级(
Critical 为红色、Warning 为橙色、Info 为浅橙色,无优先级数据时为灰色)。优先级由告警分级规则或系统评分判定,不可手工修改;进入 Issue 详情页同样可在头部看到该优先级。Issue 状态
Issue 有待处理、处理中、已解决和已忽略 4 种状态;其中已解决按复现后的处理方式分为「再次出现时重新打开」与「新版本出现时重新打开」两种,作为已解决的子菜单项在状态下拉中切换。流转规则见 Issue 状态。筛选与排序
- 时间范围
- 排序方式
- 筛选器
浏览器右上角显示时间轴,允许您显示在选定时间段内发生错误的 Issue。您可以:
- 从下拉菜单中选择预设范围
- 直接修改时间
- 输入自然语言进行筛选
导出 Issue
Issue 列表右上角提供 CSV 导出按钮,导出内容与当前列表的筛选、排序条件保持一致。 点击 CSV 按钮后,可在弹层中选择导出内容:错误样例只在错误数据保留期内存在,更早的 Issue 导出后样例列会为空。
错误原因分类
Flashduty 在创建 Issue 时为其标注可能的错误原因分类,用于缩小排查范围。分类方式
系统先按错误类型和消息判断分类,例如 HTTP 状态码为 4xx 或 5xx 的请求归为 API 请求失败,TypeError 访问空值归为非法对象访问。无法判断时,AI 会结合错误消息、堆栈和平台,给出分类和不超过 100 字的原因说明,在 Issue 卡片上以悬停提示显示。问题复现
已解决的 Issue 再次出现时会重新打开,并标记为问题复现:解决方式为「再次出现时重新打开」时任何再次出现都会重开(同一版本也算),为「新版本出现时重新打开」时只有新版本再次出现才重开。详见 Issue 状态。Issue 详情
Issue 列表支持两种查看模式:侧栏模式和全屏模式。默认以侧栏方式打开详情面板,您也可以点击展开按钮切换到全屏模式,获得更宽敞的查看空间和更完整的数据展示。 点击任何 Issue 可以打开详情面板,查看更多信息。
基础信息
基础信息
面板上部显示 Issue 的基础信息,如状态、错误原因等。您还可了解 Issue 的生命周期:首次和最后出现日期、持续时间,以及时间内的错误发生次数(按照一定时间粒度聚合)。
标签分布
标签分布
在标签分布区块可按照各种维度查看该 Issue 下不同标签所占比重,从而快速判断问题影响范围,辅助定位根因。目前支持
view_name、browser_name、version、env 等标签。错误样例
错误样例
默认展示当前 Issue 发生期间最近一次上报的错误信息作为错误样例,您也可通过导航条进行切换。Native 崩溃的每条样例都会标注是否已符号化。如果最新一条样例尚未解析,详情会自动切换到更早的、可符号化的样例,点击 回到最新 可切回。如果一条崩溃目前只收到了崩溃发生那一刻发出的信标、完整报告还没上报,样例区显示 崩溃详情待补齐 和一句说明,而不是堆栈。堆栈等详细信息会在该用户再次打开 App 后上传,随后替换这一条样例。
错误堆栈与源码映射
错误堆栈与源码映射
查看错误的上下文信息和堆栈信息。如果已上传对应的 SourceMap、Android mapping 文件、iOS dSYM 文件或 Flutter 符号文件,您可以看到映射还原后的原始源码位置和代码片段。对于 Web、微信小程序和 HarmonyOS 错误,代码片段中超过 480 个字符的行会被裁剪,被裁剪的一端以
在「应用管理」-「源码管理」可查看已上传的源码信息,详见 源码映射。
… 标记。
错误堆栈(Native — Android/iOS)
错误堆栈(Native — Android/iOS)
Native 平台(Android/iOS)的错误堆栈展示针对移动端特点进行了专门设计,提供以下能力:Pretty / Raw 模式切换
- Pretty 模式:结构化展示堆栈信息,自动区分应用帧(app frames)和第三方帧(third-party frames),第三方帧默认折叠,突出显示您自己的代码
- Raw 模式:展示原始堆栈文本,方便复制和在外部工具中分析
- 查看线程总数和当前展示的线程数
- 展开/折叠所有线程
- 每个线程内独立区分应用帧和第三方帧,第三方帧可按需展开查看
- 崩溃线程的堆栈会被优先展示
- 复制 UUID,或点击 在符号表中查找 打开按该 UUID 筛选的源码映射页面;
- 对未解析的镜像点击 去上传 上传符号文件;
- 上传后点击 重新解析 刷新堆栈。
source_type 为 ndk、android 或 ios)携带线程堆栈和 Binary Images,与 Android/iOS 原生崩溃一样使用上述 Native 渲染展示;Dart 异常则按堆栈中的 build_id 匹配已上传的 Flutter 符号文件,进行符号化还原。React Native 支持React Native 与 Flutter 的形态一致:JS 错误按 Web 堆栈展示,并以上传的 JS sourcemap 还原原始源码;原生崩溃(source_type 为 ios、android 或 ndk)携带线程堆栈和 Binary Images,按上述 Native 堆栈视图展示,与 Android/iOS 原生崩溃一样通过 dSYM / NDK 符号文件还原。JS 错误的 sourcemap 匹配范围为 react-native 类型,并按错误的 OS(os_name)推算平台(iOS / Android)进一步收窄——两端 bundle 可能同名,平台收窄可以避免匹配到另一端的文件。Electron 支持Electron 错误按类型分流展示:主进程和渲染进程的 JavaScript 错误是 V8 堆栈,与浏览器错误一样按 Web 堆栈展示(上传 sourcemap 后还原原始源码);minidump 原生崩溃则是地址形式的 Native 堆栈(含线程与 binary_images),按上述 Native 堆栈视图展示,上传匹配的 Breakpad 符号后还原函数名、文件名和行号。详见 Electron 错误符号化。详细的符号文件上传流程请参阅 源码映射。会话时间线
会话时间线
查看当前错误示例所属的 Session 事件总数,以及该异常发生前后用户的资源访问情况和操作情况。
当前最多展示包含当前 Error 事件在内的 20 条上下文信息,后续您可在 Session 查看器模块查看更多日志信息。
属性
属性
异常事件在上报时会携带一系列属性,您可在属性区块查看当前的 Session、视图、用户等各类信息,方便排查问题。Electron 错误的属性面板会在 Other 属性组额外展示一个虚拟
process 属性(主进程 / 渲染进程),标识错误来自哪个运行时;非 Electron 错误不展示该属性。头部操作
Issue 详情面板右上角提供两个 AI SRE 相关的按钮,只在账户已开启 AI SRE 时显示:
开启自动分析 以故障为触发条件,所以该应用要先能产生故障。点击按钮时,RUM 会读取该应用的告警设置:告警已开启、投递方式为 Flashduty 协作空间、且至少选了一个协作空间时,才直接跳到创建表单,协作空间已按应用的告警配置选好,确认后点 创建 即可。不满足时提示「该应用还没开启 On-call 告警。异常要先生成故障才能触发自动分析,请先完成告警设置。」,并跳到该应用的 告警设置 页签。模板内容与表单字段见自动化。
异常告警
在「应用管理」中编辑应用,开启「告警」并选择协作空间或 Webhook。配置方法见 Issue 告警。最佳实践
- 配置源码映射:便于在生产环境定位问题
- 添加用户信息:配置用户相关信息,提供更好的错误上下文
- 设置告警策略:为错误配置合理的协作空间和分派策略
- 定期错误分析:定期检查错误报告,发现潜在问题
- 团队协作:利用团队所有权功能确保问题能够快速分配给相关团队
- 监控回归:密切关注已解决问题的潜在回归
下一步
源码映射
配置源码映射
异常聚合
了解聚合机制
Issue 状态
管理 Issue 状态
