跳转到主要内容
错误上报后可在异常追踪模块查看 Issue。在 Flashduty RUM 中,一个 Issue 是由一组相似错误组成的,这些错误通常与同一个 bug 相关。
Issue 列表
详细的聚合规则请参阅 异常聚合。

Issue 信息概览

Issue 信息概览
Issue 浏览器中列出的每个条目包含以下信息:
Issue 列表支持按优先级排序,筛选条件默认包含「优先级」;每条 Issue 错误消息左侧的竖条颜色反映其优先级(Critical 为红色、Warning 为橙色、Info 为浅橙色,无优先级数据时为灰色)。优先级由告警分级规则或系统评分判定,不可手工修改;进入 Issue 详情页同样可在头部看到该优先级。

Issue 状态

Issue 有待处理、处理中、已解决和已忽略 4 种状态;其中已解决按复现后的处理方式分为「再次出现时重新打开」与「新版本出现时重新打开」两种,作为已解决的子菜单项在状态下拉中切换。流转规则见 Issue 状态。

筛选与排序

浏览器右上角显示时间轴,允许您显示在选定时间段内发生错误的 Issue。您可以:
  • 从下拉菜单中选择预设范围
  • 直接修改时间
  • 输入自然语言进行筛选

导出 Issue

Issue 列表右上角提供 CSV 导出按钮,导出内容与当前列表的筛选、排序条件保持一致。 点击 CSV 按钮后,可在弹层中选择导出内容:
错误样例只在错误数据保留期内存在,更早的 Issue 导出后样例列会为空。
导出文件始终包含 Issue 的 18 个字段(问题 ID、问题链接、应用、服务、错误类型、错误信息、状态、优先级、是否崩溃、错误数、影响会话数、首次出现、首次出现版本、最近出现、最近出现版本、涉及版本、疑似原因、解决时间),样例列在「包含错误样例」开启后附加。
  • 单次最多导出 100 条。超过时请缩小时间范围或增加筛选条件。
  • 时间列(首次出现 / 最近出现 / 解决时间 / 样例发生时间)的列头会附加时区标识(如 首次出现 (Asia/Shanghai)),列内值为该时区下的 YYYY-MM-DD HH:mm:ss 文本,便于电子表格按日期排序。
  • 以 =、+、-、@ 开头的单元格会被加上引号前缀,防止公式注入。
  • 样例堆栈截取前 20 行。完整堆栈可在 Issue 详情页查看(那里会按平台做符号化还原);导出不做符号化,给出的是上报的原始帧。

错误原因分类

Flashduty 在创建 Issue 时为其标注可能的错误原因分类,用于缩小排查范围。
鼠标悬停在错误原因分类上时,AI 会进一步给出推断的根因和修复建议。

分类方式

系统先按错误类型和消息判断分类,例如 HTTP 状态码为 4xx 或 5xx 的请求归为 API 请求失败,TypeError 访问空值归为非法对象访问。无法判断时,AI 会结合错误消息、堆栈和平台,给出分类和不超过 100 字的原因说明,在 Issue 卡片上以悬停提示显示。

问题复现

已解决的 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)的错误堆栈展示针对移动端特点进行了专门设计,提供以下能力:Pretty / Raw 模式切换
  • Pretty 模式:结构化展示堆栈信息,自动区分应用帧(app frames)和第三方帧(third-party frames),第三方帧默认折叠,突出显示您自己的代码
  • Raw 模式:展示原始堆栈文本,方便复制和在外部工具中分析
符号化状态如果已上传对应版本的符号文件(Android mapping 或 iOS dSYM),堆栈中的混淆地址会被自动还原为可读的函数名、文件名和行号。未符号化时,系统会提示您上传符号文件,并提供直达「源码管理」和上传工具的链接。符号化结果会被缓存。如果为一条已经出现过的崩溃补传了符号文件,点击提示条或「本条崩溃所需符号」区块中的「重新解析」按钮,即可跳过缓存强制重新执行符号化(重新拉取 dSYM 并完整还原),并刷新当前堆栈,无需等待新的崩溃上报。线程堆栈(Threads)Native 崩溃通常涉及多个线程。线程面板展示崩溃时所有线程的堆栈信息,支持:
  • 查看线程总数和当前展示的线程数
  • 展开/折叠所有线程
  • 每个线程内独立区分应用帧和第三方帧,第三方帧可按需展开查看
  • 崩溃线程的堆栈会被优先展示
Binary Images(iOS)对于 iOS 崩溃,还可以查看崩溃时加载的 Binary Images(二进制镜像)列表,包含镜像名称、地址范围和 UUID 等信息,用于辅助离线符号化分析。本条崩溃所需符号(非系统库)iOS、Electron 等 Native 崩溃(含 Flutter 的 iOS 原生崩溃)会在堆栈上方列出本条崩溃引用的非系统二进制镜像,每个镜像显示名称、UUID 和是否已解析(存在未解析镜像时默认展开)。您可以:
  • 复制 UUID,或点击 在符号表中查找 打开按该 UUID 筛选的源码映射页面;
  • 对未解析的镜像点击 去上传 上传符号文件;
  • 上传后点击 重新解析 刷新堆栈。
下载崩溃日志堆栈区可以把当前这条崩溃导出一个纯文本日志文件(下载崩溃日志),内容包含错误摘要、崩溃堆栈、各线程堆栈和 Binary Images。还原过的堆栈在文件末尾的 Original Stacks 区块里附有符号化之前的原始文本。Flutter 支持Flutter 原生崩溃(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 状态