> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 过滤条件

> 通过条件匹配过滤特定告警或故障，应用于分派策略、静默、抑制、路由、标签增强等功能

过滤条件按字段值筛选告警或故障，满足条件的才会被对应规则处理。写法见[如何配置过滤条件](#如何配置过滤条件)。

## 在哪里使用过滤条件？

过滤条件应用于以下场景：

| 场景 | 说明 |
| - | - |
| **分派策略** | 同一个协作空间允许创建多个分派策略，每个分派策略可以设置不同的过滤条件，针对不同的故障设定不同的分派对象 |
| **静默规则** | 设置过滤条件来匹配特定的故障，满足条件的故障将会被静默 |
| **抑制规则** | 设置过滤条件，分别匹配新触发的故障和已有的活跃故障，当新故障满足条件，将被抑制 |
| **告警聚合** | 设置过滤条件匹配特定的告警，并针对这部分告警设置新的聚合维度 |
| **路由规则** | 使用集成中心的告警集成时，设置全局路由匹配规则，将不同的告警路由到特定协作空间 |
| **标签增强** | 设置过滤条件来匹配特定的告警，满足条件的告警按照规则进行标签的生成 |
| **告警处理** | 设置过滤条件来匹配特定的告警，满足条件的告警将按照规则进行处理 |

## 如何配置过滤条件？

### 规则设计

过滤条件由多组条件组成：

* **组内条件**：`AND` 关系，即每一个条件均匹配，整个组才为匹配
* **组与组之间**：`OR` 关系，即任一组条件匹配，整体即为匹配

每个条件由字段、操作符和目标值组成，操作符有两种：

* **匹配**：目标可以有多个值，任一值满足条件，则该条件匹配
* **不匹配**：目标可以有多个值，所有值均不满足条件，则该条件匹配

具体的匹配方式由目标值的格式决定，见[匹配方式](#匹配方式)。

#### 可选字段

过滤条件的 key 分为两类：

| 类别 | Key | 含义 |
| - | - | - |
| 内置属性 | `data_source_id` | 集成，匹配告警自身的来源集成，用于订阅/排除规则等按集成筛选告警的场景。value 为集成实例 ID，界面中通过下拉框多选 |
| 内置属性 | `integration_id` | 集成来源（首条告警），匹配故障首条告警的来源集成，用于分派策略的故障筛选。value 为集成实例 ID，界面中通过下拉框多选 |
| 内置属性 | `severity` | 严重程度（Critical / Warning / Info） |
| 内置属性 | `title` | 告警/故障标题 |
| 内置属性 | `description` | 告警/故障描述 |
| 动态标签 | `labels.<name>` | 以 `labels.` 为前缀的任意标签键，例如 `labels.service`、`labels.host` |

![过滤条件示例](https://download.flashcat.cloud/flashduty/kb/filter.png)

如上图所示，有两组条件，每组各含两个条件，条件的目标值有多个：

* **第一组**：`severity` 匹配 `Critical` 或 `Warning`，且 `labels.check` 匹配 `Binlog同步延迟`
* **第二组**：`labels.check` 匹配 `/cpu/`、`/io/` 或 `/disk/` 中任一，且 `labels.value` 匹配 `num:gt:90`

两组满足任一组，即整体匹配。

### 匹配方式

目标值（value）都是字符串，系统按格式识别匹配方式：**正则**、**通配**、**CIDR（IP 段）**、**数值大小**，其余均为**精确**匹配。条件编辑器会把可用方式直接列在输入框下方，其中第四种界面文案为 **CIDR 匹配**。

> [tab] 正则匹配
>
> 当 value 字符串以 `/` 为前后缀，整个 value 将被识别为**正则**。
>
> **示例**：
>
> * `labels.check`：`/宕机/` — check 标签包含"宕机"时，即匹配
>
> > [!NOTE]
> >
> > Flashduty 全平台使用 `RE2` 正则规范，部分 `Perl` 语法可能无法匹配。您可使用 AI Chatbot 生成表达式，并前往 [RE2 Playground](https://re2js.leopard.in.ua/) 进行验证。

> [tab] 通配匹配
>
> 当 value 字符串包含 `*` 或 `?` 且没有 `/` 前后缀，整个 value 将被识别为**通配**。
>
> * `*` 可匹配零个或多个任意字符
> * `?` 可匹配单个任意字符
>
> 除 `*` 和 `?` 之外的字符都按**字面**匹配，不会被当作正则：`host[0-9]*` 里的 `[`、`]`，`(a|b)*` 里的 `(`、`)`、`|`，`host.*` 里的 `.` 都只是普通字符，`host[0-9]*` 只匹配以字面量 `host[0-9]` 开头的值。要用字符类或分组，请写成正则，例如 `/^host[0-9]+.*$/`。
>
> **示例**：
>
> * `labels.check`：`宕机*` — check 标签以"宕机"作为前缀，即匹配
>
> > [!TIP]
> >
> > 您可使用 `*` 来判断一个字段**存在**或**不存在**：
> >
> > * 字段 `匹配 *`：表示您需要该字段存在
> > * 字段 `不匹配 *`：表示您需要该字段不存在

> [tab] CIDR 匹配
>
> 当 value 以 `cidr` 作为前缀，整个 value 将被识别为 **CIDR（IP 段）**。
>
> **示例**：
>
> * `labels.host`：`cidr:10.0.0.206/24` — host 标签在 10.0.0.206/24 这个 IP 段内，即匹配

> [tab] 数值匹配
>
> 当 value 以 `num:[gt|ge|lt|le]:` 作为前缀，整个 value 将被识别为**数值大小匹配**。
>
> | 前缀 | 含义 |
> | - | - |
> | `gt` | 大于 |
> | `ge` | 大于等于 |
> | `lt` | 小于 |
> | `le` | 小于等于 |
>
> **示例**：
>
> * `labels.value`：`num:ge:90` — value 标签大于等于 90，即匹配

> [tab] 精确匹配
>
> 当 value 不满足上述任意格式，即被视为**精确匹配**。此时，仅当字符串完全相等时，才算匹配通过。

> [!WARNING]
>
> CIDR 匹配和数值匹配不适用于：故障列表按 labels 筛选、告警列表按 labels 筛选，以及告警抑制规则对活跃告警的筛选。

## 常见问题

> [accordion] 为什么系统不提示我可选标签？
>
> Flashduty On-call 接受大量数据上报，为了保证系统的稳定性，系统仅查找过去 24 小时内，最多 500 条告警事件进行标签的去重操作。因此提取到的标签范围可能会动态变化，甚至在过去 24 小时没有新数据时提取不到任何标签。
>
> 这种情况下，**您可以手动输入标签**。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.