跳到主要内容

异常黑名单

基于异常类名和消息内容进行过滤,在故障检测期间忽略符合规则的异常,避免无效异常干扰故障分析,使 APM 更聚焦于需重点关注的异常场景。

功能入口

进入部署配置 → 规则配置 → 数据采集 → 异常采集 → 异常黑名单

页面与「异常字段提取」同属异常采集,通过顶部 Tab 切换。列表展示规则的优先级、描述、启用状态,并支持按描述搜索。

异常黑名单列表

列表支持以下操作:

操作说明
创建新增黑名单规则
编辑修改已有规则
删除删除规则
启用 / 停用控制规则是否生效

可通过拖拽调整规则优先级顺序。

如何配置黑名单

点击创建,从右侧打开配置抽屉。

创建异常黑名单

1. 生效范围

指定规则作用对象,支持按以下维度选择(可多选):

维度说明
服务选择具体服务
服务标签按服务标签匹配
进程组选择具体进程组
进程组标签按进程组标签匹配

配置多行条件时,可通过「与 / 或」组合关系。

生效范围

2. 配置项

用于定义在故障检测期间应忽略的异常类型。

类名

算子说明
全部不限类名;选择「全部」时类名输入框隐藏
包含 / 不包含类名包含或不包含指定字符串
等于 / 不等于类名与指定字符串完全一致或不一致(可含包路径)
开始于 / 结束于类名以指定字符串开头或结尾

类名算子

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

类名包含配置

消息内容

在类名匹配基础上,进一步按消息内容过滤:

  • 类名为「全部」时,消息内容固定为「包含」,且必须填写匹配字符串
  • 类名为非「全部」时,消息内容可选「包含」或「任意」;选「任意」时不做内容过滤

示例:选择「包含」并输入 "timeout",则异常消息中包含该字符串的异常会被忽略。

消息内容配置

3. 描述

填写规则的描述信息,保存后显示在列表「描述」列,便于检索与管理。

描述

配置完成后点击保存