异常黑名单
基于异常类名和消息内容进行过滤,在故障检测期间忽略符合规则的异常,避免无效异常干扰故障分析,使 APM 更聚焦于需重点关注的异常场景。
功能入口
进入部署配置 → 规则配置 → 数据采集 → 异常采集 → 异常黑名单。
页面与「异常字段提取」同属异常采集,通过顶部 Tab 切换。列表展示规则的优先级、描述、启用状态,并支持按描述搜索。

列表支持以下操作:
| 操作 | 说明 |
|---|---|
| 创建 | 新增黑名单规则 |
| 编辑 | 修改已有规则 |
| 删除 | 删除规则 |
| 启用 / 停用 | 控制规则是否生效 |
可通过拖拽调整规则优先级顺序。
如何配置黑名单
点击创建,从右侧打开配置抽屉。

1. 生效范围
选择全局生效时,规则作用于全部适用对象,无需配置条件。选择局部生效时,须按以下维度至少选择一个对象:
| 维度 | 说明 |
|---|---|
| 服务 | 选择具体服务 |
| 服务标签 | 按服务标签匹配 |
| 进程组 | 选择具体进程组 |
| 进程组标签 | 按进程组标签匹配 |
配置多行条件时,可通过「与 / 或」组合关系。

2. 配置项
用于定义在故障检测期间应忽略的异常类型。
类名
| 算子 | 说明 |
|---|---|
| 全部 | 不限类名;选择「全部」时类名输入框隐藏 |
| 包含 / 不包含 | 类名包含或不包含指定字符串 |
| 等于 / 不等于 | 类名与指定字符串完全一致或不一致(可含包路径) |
| 开始于 / 结束于 | 类名以指定字符串开头或结尾 |

选择非「全部」算子时,需填写类名(可含包路径,如 com.br.TraceController):

消息内容
在类名匹配基础上,进一步按消息内容过滤:
- 类名为「全部」时,消息内容固定为「包含」,且必须填写匹配字符串
- 类名为非「全部」时,消息内容可选「包含」或「任意」;选「任意」时不做内容过滤
示例:选择「包含」并输入 "timeout",则异常消息中包含该字符串的异常会被忽略。

3. 描述
填写规则的描述信息,保存后显示在列表「描述」列,便于检索与管理。
配置完成后点击保存。