跳转至

巧用 Issue 自动发现功能快捷响应异常


Issue 自动发现

在观测云平台中,我们引入了【Issue 自动发现】功能,旨在通过应用性能监测(APM)和用户访问监测(RUM)模块检测出的错误,自动批量生成 Issue 并通知相关成员。

这一功能相较于传统的手动创建 Issue,显得更快捷、灵活,有效加速了异常问题的定位与解决。

接下来看看如何使用 Issue 自动发现的功能吧。

如何使用 Issue 自动发现功能

适用范围和权限

Issue 自动发现功能适用于:应用性能监测(APM) > 错误追踪、用户访问监测(RUM) > 错误查看器。

操作权限:Owner、Administrator、Standard、拥有【Issue 自动发现】权限的自定义角色。

配置【Issue 自动发现】

初见:Issue 自动发现

有操作权限的成员进入APM > 错误追踪、RUM > 错误查看器两个查看器后,右上角会显示 Issue 自动发现的文字、编辑按钮和开启标识。

  • 点击编辑按钮可配置 Issue 自动发现规则;
  • 开关按钮控制是否开启 Issue 自动发现。

编辑Issue 自动发现配置

概念先解

点击编辑按钮,弹出配置栏,进行 Issue 自动发现规则的配置。

配置项 说明
数据来源 根据用户自动发现开启的菜单位置的不同自主填充
组合维度 选取规则:默认填充对应的 APM > 错误追踪 / RUM > 错误数据中的维度字段。
作用:基于配置的字段组合进行 Issue 的分类,错误数据中有相关的字段分组及对应的数据则会自动产生一条 Issue。
检测频率 Issue 自动可定期检测 APM > 错误追踪/ RUM > 错误数据。
在此处自定义选择发现的频率。
Issue 定义 定义自动发现生成的 Issue,Issue 创建规则可查看:创建 Issue
模板变量:新增支持在 Issue 的标题、描述中使用预置的模板变量。添加模板变量后,在生成的 Issue 中即可查看此 Issue 对应事件的详情。

补充说明:

分别进入APM > 错误追踪、RUM > 错误查看器两个查看器进行配置时,【组合维度】和【Issue 中模版变量】的选项有区别,但是配置逻辑不变。

1、组合维度:自动填充,填充字段项不同。

  • APM 组合维度:

  • RUM 组合维度:

2、模版变量:Issue 的标题、描述支持模板变量,APM / RUM 可选变量类目不同。

配置完成 Issue 自动发现规则,点击“保存”。

开启 Issue 自动发现按钮。

使用 Issue 自动发现功能生成 Issue 并查看

Issue 投递

配置好Issue 自动发现规则并开启此功能后,系统将自动按照配置的检测频率进行错误发现并生成 Issue,生成的 Issue 会投递到配置的频道下。

Issue 展示

通过【Issue 自动发现】创建的异常追踪 Issue 会以[组合维度]作为唯一的 ID,若历史已经存在了相同组合维度的 Issue,则不会创建一个新的 Issue 而是通过将内容追加到历史 Issue 回复区域做更新。一般情况下可以通过 “新问题”、“重复问题”、“回归问题” 的特殊标记来识别状态。

自动发现的 Issue 卡片特别元素介绍:

  • 创建人:显示为【Issue 自动发现】,标明其自动生成的属性。

  • 组合维度:新增组合维度分组信息,展示在 Issue 卡片页面和详情页。

  • 特殊标记:自动发现的 Issue 一般情况下会存在 “新问题”、“重复问题”、“回归问题” 3 种不同的特殊标记。

    • 新问题:若历史 Issue 不存在有相同组合维度,则创建 Issue 并在右侧标记“新问题”;

    • 重复问题:若历史 Issue 已经存在有相同组合维度且状态为 Open 或者 Pending,即为问题重复出现,历史Issue右侧标记为“重复问题”;

    • 回归问题:若历史 Issue 已经存在有相同组合维度且状态为 Resolved,即为问题已解决后又重现,历史 Issue 右侧标记为“回归问题”。

除以上的特别字段和元素外,其他的标题、内容、等级、状态、回复等逻辑与常规 Issue 一致。

常见问题

点击 Issue 自动发现启用按钮不生效。

若您是首次使用此功能,还未编辑自动发现配置的话,不支持直接启用。可先点击 Issue 自动发现编辑按钮,配置自动发现规则后再进行启用。

进入 APM > 错误追踪、RUM > 错误查看器看不到这个功能。

此功能的权限范围为:Owner、Administrator、Standard、自定义角色(创建时配置了【Issue 自动发现】权限)。

因此请先进入管理 > 成员管理菜单下确认自己的角色,若为自定义角色,请确认已经授予了此项权限。

文档评价

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