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

# 创建告警订阅

> 在人工智能平台中创建事件告警或指标告警订阅，配置订阅范围、发送对象和降噪规则。

告警订阅用于定义哪些告警需要发送、发送给哪些对象，以及如何减少重复通知。创建完成并启用后，当告警满足订阅条件时，平台会通过绑定的通知目标、联系人组或第三方应用发送消息。

## 订阅与生效逻辑

一条告警订阅通常包含告警类型、订阅范围、发送对象和降噪规则。

| 配置                  | 说明                                                                                  |
| ------------------- | ----------------------------------------------------------------------------------- |
| **订阅名称**            | 用于识别订阅。建议体现业务对象、告警类型和接收范围。                                                          |
| **告警源类型**           | <ul><li>**事件告警**：按业务事件触发告警。</li><li>**指标告警**：按 Prometheus 指标阈值触发告警。</li></ul>       |
| **告警类型** 或 **指标条件** | 定义订阅哪些事件，或按什么指标阈值触发。                                                                |
| **缩小范围**            | 按 **实例 Owner**、**资源池** 等条件限定订阅对象；不填写时，订阅所选告警类型下的全部事件。                               |
| **发送对象**            | 选择通知目标或联系人组，至少选择一个。创建订阅前，请先在[管理告警通知目标](./manage-alert-notification-targets)中准备可用对象。 |
| **降噪设置**            | 配置分组聚合和静默时段，控制重复告警和免打扰时间。                                                           |

测试发送只验证通知目标连通性，不代表真实告警一定会发送成功。真实投递还取决于订阅范围、告警是否触发以及降噪设置。

## 创建事件告警订阅

事件告警按业务事件触发，适合关注训练任务失败、镜像构建结果、服务异常、订单、配额或存储等状态变化。

### 1. 进入创建页

1. 进入 **告警 > 告警订阅**。
2. 在 **我的订阅** 页签中单击 **新建**。

### 2. 填写订阅配置

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/alerts/media/event-alert-subscription-form.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=66852b7c86391d7340786458fa6ae1a9" alt="事件告警订阅配置" width="1892" height="1770" data-path="ai-platform/alerts/media/event-alert-subscription-form.png" />

#### 选择告警类型

1. 填写 **订阅名称**。
2. 将 **告警源类型** 设置为 **事件告警**。
3. 在告警类型列表中展开业务分类，选择需要订阅的告警类型。
4. 在 **已选告警类型** 中确认选择结果。

常见业务分类包括大模型推理、VSCS、JupyterLab、通用服务、订单、配额管理、存储和 CPU 等。实际可选分类和告警类型以当前控制台为准。如果需要同时订阅多种告警，可一次选择多个告警项，减少重复配置。

#### 配置订阅范围

单击 **下一步**，在 **缩小范围** 步骤中按需限定订阅命中的对象。

| 配置       | 说明                                                                                      |
| -------- | --------------------------------------------------------------------------------------- |
| **仅自己**  | 只订阅当前账号相关对象的告警，适合个人使用。                                                                  |
| **所有用户** | 订阅当前可见范围内所有用户相关对象的告警，适合管理员或团队值班场景。                                                      |
| **指定用户** | 只订阅指定用户相关对象的告警。选择后需要填写所有者。                                                              |
| **资源池**  | 仅关注指定资源池相关告警，适合共享集群或多资源池隔离场景。订单类和存储卷类告警没有稳定资源池语义，平台会忽略资源池筛选条件；这两类告警建议按归属用户或更细的订阅粒度控制范围。 |

该步骤可选。不填写时，订阅所选告警类型下的全部事件。

#### 配置发送对象和降噪

1. 单击 **下一步**。
2. 在 **发送对象** 步骤中，选择至少一个通知目标或联系人组。
3. 如缺少可用对象，可单击 **新建** 跳转创建通知目标或联系人组。
4. 单击 **下一步**。
5. 在 **降噪设置** 步骤中，按需配置分组聚合和静默时段。

| 配置          | 说明                                                                               |
| ----------- | -------------------------------------------------------------------------------- |
| **分组聚合**    | 开启后，平台会在聚合间隔内按聚合字段合并告警。适合短时间内重复触发的同类告警。                                          |
| **聚合间隔（秒）** | 合并告警的时间窗口，例如 `300` 秒。高频波动场景可适当放宽，不建议一开始设置过长，以免重要变化被延迟感知。                         |
| **聚合字段**    | 用于判断哪些告警属于同一组，例如 **Owner**、**集群**、**Aggregate ID**、**Event Type**、**SubStatus**。 |
| **静默时段**    | 开启后，在指定时间段内不发送匹配告警，适合维护窗口、发布窗口或夜间免打扰。                                            |

事件类 `Trigger` 告警会忽略阈值与间隔配置。

### 3. 提交创建

单击 **新建**。创建完成后，订阅在启用状态下即时生效。

为避免产生完全重复的订阅，平台会按条件自动归并订阅：当再次创建的订阅与已有订阅满足同一用户、同一告警项、相同筛选条件时，平台会更新已有订阅而不是新建。若需要创建独立订阅，请调整筛选条件或订阅对象。

## 创建指标告警订阅

指标告警按 Prometheus 指标阈值触发，适合监控资源利用率、服务指标或业务自定义指标。

### 1. 进入创建页

1. 进入 **告警 > 告警订阅**。
2. 在 **我的订阅** 页签中单击 **新建**。

### 2. 填写订阅配置

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/alerts/media/metric-alert-subscription-form.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=e88c0e252bd88572e8f6b542a7b60bd0" alt="指标告警订阅配置" width="1894" height="1504" data-path="ai-platform/alerts/media/metric-alert-subscription-form.png" />

#### 配置指标条件

1. 填写 **订阅名称**。
2. 将 **告警源类型** 设置为 **指标告警**。
3. 选择 **指标来源**。

| 指标来源      | 说明                                                  |
| --------- | --------------------------------------------------- |
| **基础指标**  | 平台提供的常见监控指标，适合快速配置 CPU、GPU、内存、网络等告警。                |
| **自定义指标** | 由业务或服务暴露的指标，适合监控平台内置列表未覆盖的业务指标。指标名称仅允许字母、数字、下划线和冒号。 |

继续配置指标条件：

| 配置项      | 说明                                |
| -------- | --------------------------------- |
| **指标类别** | 用于筛选指标。                           |
| **指标名称** | 需要监控的具体指标。配置前建议通过指标预览确认目标指标有数据。   |
| **指标预览** | 查看指标近期趋势，辅助判断是否有数据以及阈值是否合理。       |
| **统计方式** | 对指标进行聚合或计算，例如时间窗口均值、最大值、速率等。      |
| **运算符**  | 阈值比较方式，例如 `>`、`>=`、`<`、`<=`。      |
| **阈值**   | 触发告警的判断值，建议结合指标预览和业务影响设置。         |
| **持续时间** | 指标条件需要持续满足的时间，例如 `5m`，用于减少瞬时波动误报。 |
| **告警级别** | 告警严重程度，例如 **严重**、**警告** 或 **提示**。 |

#### 使用高级模式

如基础模式无法表达条件，可单击 **切换到高级模式**，使用 PromQL 表达式配置告警。

高级模式适合多条件组合、自定义标签过滤或复杂指标计算。使用高级模式前，请确认 PromQL 表达式已包含必要的 `namespace` 或 `orgname` 隔离标签，避免查询范围不符合平台隔离要求。

#### 配置订阅范围、发送对象和降噪

单击 **下一步**，继续配置 **缩小范围**、**发送对象** 和 **降噪设置**。指标告警可按可选负载范围进一步限定生效对象，例如全部负载、指定负载类型或指定资源池。

发送对象和降噪设置与事件告警一致。

### 3. 提交创建

确认配置后，单击 **新建**。创建完成后，订阅在启用状态下即时生效。

## 管理订阅和降噪规则

在 **告警 > 告警订阅** 中找到目标订阅后，可以按需调整订阅配置或启用状态。

| 操作          | 说明                               |
| ----------- | -------------------------------- |
| **搜索订阅**    | 按告警来源或告警名称筛选订阅。                  |
| **启用 / 停用** | 控制订阅是否参与告警匹配和发送。                 |
| **编辑**      | 调整告警类型、筛选范围、发送对象或降噪设置。           |
| **删除**      | 删除不再需要的订阅。删除后，匹配该订阅的告警不再通过该订阅发送。 |

如果需要统一处理多个订阅的降噪策略，可以在 **全局降噪规则** 页签中维护全局规则。全局降噪规则按当前用户生效，不影响其他用户。订阅级降噪规则优先于全局规则；静默和分组聚合是两类独立规则，会分别判断是否使用订阅级规则或回退到全局规则。

如果某条订阅已存在某类订阅级规则，即使该规则被停用，同类型全局规则通常也不会再自动接管。希望继续继承全局规则时，不要在订阅里创建同类型但关闭状态的规则。

## 查看结果

订阅创建后，可以通过以下方式验证：

* 在 **我的订阅** 列表中确认订阅已启用。
* 对绑定的通知目标执行测试发送，确认接收端可达。
* 当真实告警发生后，在 **告警总览** 中查看告警记录、投递方式和投递结果。

如果未收到真实告警，请先确认告警是否发生，再检查订阅范围、发送对象启用状态和降噪设置。

## 相关文档

* [查看告警历史](./view-alert-history)
* [管理告警通知目标](./manage-alert-notification-targets)