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

# 静默与分组

> 用静默策略在维护期或已知噪声期间暂停通知，并按标签把相关事件收成一组。

静默会暂停匹配事件的通知与升级，事件本身仍会记录。语义分组把相关事件收拢到一起，让处理人员一次处理。两者都不会修改规则。

## 静默策略

打开 **告警 → 静默策略**。每条策略显示状态、时间窗和匹配条件。

| 状态 | 含义 |
| - | - |
| **正在静默** | 匹配的事件处于静默中。 |
| **尚未开始** | 时间窗尚未开始。 |
| **未到时段** | 周期重复的时间窗当前不在生效时段内。 |
| **已结束** | 时间窗已结束。 |
| **已关闭** | 策略已停用。 |

创建策略：

1. 点击 **新建静默策略** 并填写 **名称**，保持 **启用** 开启。
2. 在 **匹配** 中，为事件标签上的每个条件点击 **添加匹配器**，例如 `service` `=` `checkout`。所有匹配器都必须命中，`=~` 与 `!~` 为正则表达式。没有匹配器时，策略匹配 **所有事件**。
3. 在 **时间窗** 中选择 **窗口类型**：
   * **固定区间**：一个 **开始** 和一个 **结束**；
   * **周期重复**：**时区**、**星期**，以及从 **起始小时** 到 **结束小时**（0 到 24）的时段，例如每周六 2 点到 6 点。
4. 在 **备注** 中填写 **原因**，然后点击 **创建静默**。

静默匹配事件携带的标签：规则的标签，以及[按维度拆分](https://docs.molesignal.com/zh-Hans/alerting/rules.md#按维度拆分)的规则中各组的取值。每个计划内的静默都应写明受影响的服务和结束时间，并让它到期自动结束，而不是事后再删除。

> [!WARNING]
>
> 静默只是隐藏通知，并不能证明服务已经恢复。时间窗结束时请查看事件列表。

### 静默单个事件

事件上的 **静默** 只暂停这一个事件的通知与升级，时长可选 **1 小时**、**4 小时**、**24 小时** 或 **7 天**，还可以填写 **原因**。它不会停用规则，也不会静默同一服务的其他事件。这条静默会出现在 **静默策略** 中，可以在那里修改或提前移除。

创建、修改和移除静默需要 `alerts.silence`。

## 语义分组

打开 **告警 → 分组**。语义分组把标签取值相同的事件收成一组，类似 Alertmanager 的 `group_by`。通过 API 确认或解决分组时，组内每个事件都会同样处理，参见[事件分组](https://docs.molesignal.com/zh-Hans/alerting/incidents.md#事件分组)。

1. 点击 **新建分组** 并填写 **名称**，例如 `critical-by-service`，保持 **启用** 开启。
2. 在 **匹配条件** 中添加事件必须满足的条件，例如 `severity` = `critical`。所有条件都必须命中；没有条件时，分组适用于所有事件。
3. 在 **分组键** 中填写 **分组标签键**，用逗号分隔，例如 `service, region`。这些标签取值相同的事件会收成同一组。
4. 点击 **创建分组**。

已禁用的分组会被跳过。删除分组会保留事件，只移除分组规则。

**导入** 从 JSON 创建分组：分组数组，或带 `groups` 数组的对象。

```json theme={null}
[
  {
    "name": "crit-by-service",
    "enabled": true,
    "matchers": [{ "label": "severity", "op": "eq", "value": "critical" }],
    "group_by": ["service"]
  }
]
```

管理分组需要 `alerts.manage`。


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