跳到主要内容
版本：3.7.0

异常判定

终端应用​

ONE支持管理终端应用的卡顿判定规则 ，支持通过主线程 Runloop 循环耗时和周期流畅度两种方式识别卡顿，用户可配置对应的阈值，实现对终端应用卡顿场景的精准检测。1759979885251

主线程 Runloop 循环耗时​

当「主线程 Runloop 循环耗时 > 设定阈值」时，判定为卡顿。

  • 示例阈值：5000 ms（可根据业务对应用流畅性的预期自定义修改）。
信息

Runloop说明：RunLoop（运行循环）是 iOS/macOS 开发中管理线程事件与消息的核心机制

周期流畅度​

当「连续 N 个周期的流畅度 < 设定阈值」时，判定为卡顿。

  • 连续周期数：示例为 5 个周期（可自定义，代表连续多少个周期的流畅度需同时满足条件）；
  • 流畅度阈值：示例为 40（可自定义，流畅度数值越低，代表主线程越不流畅）。
信息

流畅度说明 ：流畅度表示主线程 vSync 每秒钟循环的次数，该指标直接反映主线程的运行流畅程度，数值越低，卡顿风险越高。

用户操作​

ONE平台支持对于终端应用用户操作的异常识别规则 ，支持对请求失败操作、崩溃操作、阻塞操作三类场景，通过自定义识别规则和默认识别规则精准判定异常行为，为应用稳定性监控、用户体验问题排查提供依据。

请求失败操作​

识别用户操作触发的网络请求、业务请求等失败的异常场景。默认规则用于全局的请求失败异常判定逻辑（当无自定义规则匹配时生效）

1759981178067

  1. 应用选择：通过应用名称下拉框，选定需要配置 “请求失败操作” 异常规则的 目标终端应用。
  2. 自定义识别规则：用于 精细化定义特定场景的请求失败异常规则 （优先级高于 “默认识别规则”）：

  • 添加规则 ：点击添加按钮，可创建新的自定义规则，支持选择特定的用户操作名称以及网络请求失败率、制定网络请求的阈值进行配置，当达到阈值时会定义为应用的请求失败。

    1759988670449

  • 搜索规则 ：在搜索框中输入 “规则描述”，可快速定位已有自定义规则。

  • 规则管理 ：每条规则包含优先级（多规则冲突时的排序依据）、描述（说明规则用途）字段；可通过启用开关控制规则是否生效；支持编辑（修改规则内容）、删除（移除规则）操作，灵活调整规则。

  1. 默认识别规则：用于全局兜底的请求失败异常判定逻辑（当无自定义规则匹配时生效）：
  • 判定逻辑：当网络请求失败率 ≥ 1000‰ 时，认为是异常操作（注：“失败率阈值” 可通编辑按钮修改，以适配业务对 “请求失败异常” 的判定预期）。

崩溃操作​

ONE支持识别终端应用（如 App、小程序等）在用户操作过程中发生的应用崩溃类异常

1759987966340

阻塞操作​

ONE支持识别终端应用（如 App、小程序等）在用户操作过程中，主线程执行时间过长导致的 “阻塞类异常操作” 。

1759988192220

  1. 应用选择：通过应用名称下拉框，选定需要配置 “阻塞操作” 异常规则的 目标终端应用。

  2. 自定义设置：用于 精细化定义特定场景的阻塞操作异常规则 （优先级高于 “默认设置”）：

  • 添加规则 ：点击添加按钮，可创建新的自定义规则。选择用户操作名称并配置单段主线程执行时间的阈值，当达到阈值时会将此操作判定为阻塞操作。

    1759988865181

  • 搜索规则 ：在搜索框中输入 “规则描述”，可快速定位已有自定义规则。

  • 规则管理 ：每条规则包含优先级（多规则冲突时的排序依据）、描述（说明规则用途）字段；可通过启用开关控制规则是否生效；支持编辑（修改规则内容）、删除（移除规则）操作，灵活调整规则。

  1. 默认设置：用于全局的阻塞操作异常判定逻辑（当无自定义规则匹配时生效）：
  • 判定逻辑：当单段主线程执行时间 ≥ 设定阈值（如示例中 5000 ms）时，则认为是阻塞操作。
  • 编辑与保存 ：可修改阈值输入框中的数值（如调整为 3000 ms），修改后点击确定保存配置，点击取消则放弃本次修改。

网络请求​

ONE支对符合特定条件的网络请求错误进行过滤。符合规则的网络请求错误数据将不会在平台展示，也不会计入统计数据。

1759990062877

自定义屏蔽规则：点击添加按钮，可以自定义规则配置

1759990122080

  1. 条件：通过下拉菜单选择 网络请求的维度 ，并配置对应的匹配逻辑，支持以下维度：

  • HTTP 请求状态码 ：基于 HTTP 响应状态码（如 404、500 等）设置过滤条件。

  • 错误描述 ：基于网络请求错误的描述文本（如 “连接超时”“SSL 握手失败” 等）设置过滤条件。

  • 请求地址 ：基于网络请求的目标 URL 地址（如特定接口路径）设置过滤条件。

  1. 描述：填写规则的描述信息，用于后续快速识别规则用途（如 “屏蔽客户端错误类 HTTP 状态码的请求错误”“屏蔽特定接口的超时错误” 等）。
  2. 点击确定按钮保存成功。

代码异常​

崩溃​

ONE平台支持针对终端应用的代码层面异常的 “自定义屏蔽规则” 。通过该功能，可对符合规则的代码异常进行过滤，使其不计入应用总体崩溃次数、崩溃率等核心指标（也不影响会话满意度、健康评分计算），仅在检索中心保留展示，从而帮助用户聚焦需重点关注的代码异常问题。

1759990540628

自定义屏蔽规则：点击添加按钮，可以自定义规则配置

1759990968607

  1. 条件 ：点击下拉框，默认显示 “崩溃问题”，可选择的维度包括：崩溃问题、崩溃原因、崩溃方法、崩溃类型和崩溃来源。
  2. 描述：在 “描述” 输入框中，填写规则的说明文字（如 “屏蔽某第三方 SDK 导致的崩溃”），用于后续识别规则用途。

卡顿​

ONE平台支持配置终端应用的卡顿类代码异常的 “自定义屏蔽规则” 。通过该功能，可对符合规则的卡顿异常进行过滤，使其不计入应用总体卡顿次数、卡顿率等核心指标（也不影响会话满意度、健康评分计算），仅在检索中心保留展示，助力用户聚焦需重点关注的卡顿问题。

1759991632497

自定义屏蔽规则 ：点击添加按钮，进行规则配置

1759991733251

  1. 条件：针对卡顿方法、卡顿类型进行配置

  2. 描述：在 “描述” 输入框中，填写规则的说明文字，用于后续识别规则用途。

JS错误​

ONE平台支持配置前端类应用中 JavaScript 代码错误的自定义屏蔽规则 。通过该功能，可对符合规则的 JS 错误进行过滤，使其不计入应用总体 JS 错误次数、JS 错误率等核心指标（也不影响会话满意度、健康评分计算），仅在检索中心保留展示，助力用户聚焦需重点关注的 JS 错误问题。

1760000765271

自定义屏蔽规则：

1760000910209

  1. 条件：通过下拉菜单选择 JS 错误的特征维度 ，并配置对应的匹配逻辑，支持以下维度：
  • JS 错误信息 ：基于错误的具体描述文本（如 “Uncaught TypeError” 等错误提示内容）设置过滤条件。
  • JS 错误类型 ：基于错误的分类类型（如语法错误、引用错误、类型错误等）设置过滤条件。
  1. 描述：填写规则的描述信息，用于后续快速识别规则用途（例如：“屏蔽测试环境下的已知 JS 错误”“屏蔽某非核心脚本的语法错误” 等）。

服务端请求状态码​

ONE平台支持自定义服务端 HTTP 状态码的 “正常 / 错误” 分类规则 。通过自定义状态码实现特定业务场景下状态码区间的分类，为应用服务端交互的异常监控提供精准依据。

1760003157873

自定义状态码：

1760004719834

  1. 生效范围：通过下拉菜单选择规则作用范围，当前支持「全局生效」（对所有服务端请求状态码判定生效）。
  2. 配置项：
  • 类型 ：下拉选择状态码分类，支持正常状态码或错误状态码，标记该区间状态码属于 “正常” 或 “错误” 类别。
  • 上边界 / 下边界 ：输入状态码的 数值区间 （如定义 200 - 299 为正常状态码区间，需在下边界填 200、上边界填 299）。
  • 包含边界值 ：勾选后，状态码区间 包含 “下边界” 和 “上边界” 本身 （如勾选时，200 和 299 会被纳入规则匹配范围）。
  1. 描述：输入规则描述信息，用于后续快速识别规则用途