> ## 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.

# 管理告警通知目标

> 在人工智能平台中创建和管理告警通知目标、联系人组和第三方应用，用于接收告警订阅发送的消息。

通知管理用于维护告警接收对象。创建告警订阅前，您需要先准备可用的通知目标。

## 通知对象关系

| 对象    | 说明                             | 使用方式            |
| ----- | ------------------------------ | --------------- |
| 通知目标  | 最小的告警送达单元，定义一种通知方式和一个接收地址或接收人。 | 可直接绑定到告警订阅。     |
| 联系人组  | 多个通知目标的集合。                     | 可作为一个整体绑定到告警订阅。 |
| 第三方应用 | 飞书应用等企业应用配置。                   | 供飞书应用消息类通知目标引用。 |

通知目标和联系人组都可以设置启用状态。关闭后，依赖该对象的告警投递可能受影响。

## 创建通知目标

### 1. 进入创建页

1. 进入 **告警 > 通知管理**。
2. 在 **通知目标** 页签中单击 **新建**。

### 2. 填写通知方式配置

选择 **通知方式**，并按对应页签填写配置。

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/alerts/media/alert-notification-target-form.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=c1376c7dd475bb012707d5034decb25c" alt="告警通知目标配置" width="70%" data-path="ai-platform/alerts/media/alert-notification-target-form.png" />

<Tabs>
  <Tab title="飞书通知">
    **飞书通知** 适合将告警发送给指定飞书用户。

    | 配置项          | 说明                                   |
    | ------------ | ------------------------------------ |
    | **第三方应用**    | 选择可用的飞书应用。租户内没有可用飞书应用时，普通用户无法创建飞书通知。 |
    | **飞书绑定的手机号** | 填写接收人的飞书绑定手机号。                       |
    | **备注**       | 说明通知目标用途，便于后续维护。                     |
    | **语言**       | 选择告警消息展示语言。                          |
    | **可见范围**     | **仅自己** 表示仅创建者可用；**公开** 表示同租户内可以复用。  |
    | **启用**       | 控制该通知目标是否参与告警发送。                     |
  </Tab>

  <Tab title="Webhook">
    **Webhook** 适合将告警发送到群机器人、第三方系统或统一通知平台。

    | 配置项            | 说明                                                       |
    | -------------- | -------------------------------------------------------- |
    | **Webhook 地址** | 填写接收告警的 Webhook 地址。                                      |
    | **备注**         | 说明通知目标用途，便于后续维护。                                         |
    | **语言**         | 选择告警消息展示语言。                                              |
    | **可见范围**       | **仅自己** 表示仅创建者可用；**公开** 表示同租户内可以复用。                      |
    | **启用**         | 控制该通知目标是否参与告警发送。                                         |
    | **模板**         | 配置 Webhook 请求体模板。模板写法请参考[配置 Webhook 模板](#配置-webhook-模板)。 |

    Webhook 通知目标仅支持事件告警和指标告警；如果绑定到其他类型告警，创建或投递可能被拒绝，并提示 `webhook notification method is only supported for trigger and metric_rule type alarms`。
  </Tab>

  <Tab title="短信通知">
    **短信通知** 适合通过手机短信直接接收告警。

    | 配置项            | 说明                                    |
    | -------------- | ------------------------------------- |
    | **接收短信告警的手机号** | 填写国内 11 位手机号，不需要添加 `+86` 前缀；暂不支持国外号码。 |
    | **备注**         | 说明通知目标用途，便于后续维护。                      |
    | **语言**         | 选择告警消息展示语言。                           |
    | **可见范围**       | **仅自己** 表示仅创建者可用；**公开** 表示同租户内可以复用。   |
    | **启用**         | 控制该通知目标是否参与告警发送。                      |
  </Tab>
</Tabs>

### 3. 提交创建

单击 **测试**，验证当前通知目标是否可达。测试通过后，单击 **新建**。

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

同一手机号可能存在小时级发送频控，超出频控的短信会被跳过，但不影响飞书通知或 Webhook 投递。

## 创建联系人组

联系人组适合把多个通知目标组合为一个接收对象。

1. 进入 **告警 > 通知管理**。
2. 选择 **联系人组** 页签。
3. 单击 **新建**。
4. 填写联系人组配置。

| 配置项      | 说明                                     |
| -------- | -------------------------------------- |
| **组名**   | 联系人组名称。建议体现用途，例如训练任务值班组、资源告警组。         |
| **备注**   | 说明联系人组的使用场景或维护人。                       |
| **通知目标** | 选择组内包含的通知目标。组内没有可用通知目标时，该联系人组无法用于有效投递。 |
| **启用**   | 控制该联系人组是否可用于告警发送。                      |

5. 单击 **新建**。

创建完成后，您可以在创建告警订阅时选择该联系人组。

## 创建第三方应用

第三方应用用于维护飞书应用等企业级应用配置。创建飞书应用消息类通知目标前，可能需要先准备可用的第三方应用。

1. 进入 **告警 > 通知管理**。
2. 选择 **第三方应用** 页签。
3. 单击 **新建**。
4. 填写第三方应用配置。

| 配置项                | 说明                             |
| ------------------ | ------------------------------ |
| **名称**             | 第三方应用名称。                       |
| **飞书应用**           | 飞书应用标识。                        |
| **飞书应用 AppSecret** | 飞书应用密钥。请妥善保管，不要在文档、工单或公开渠道中暴露。 |
| **启用**             | 控制该第三方应用是否可被通知目标引用。            |

5. 单击 **新建**。

第三方应用通常由租户管理员维护。普通用户创建飞书应用消息通知目标前，需要确认租户内已有可引用且处于启用状态的第三方应用。

## 管理通知对象

在 **告警 > 通知管理** 中找到目标对象后，可以按需维护配置：

| 操作     | 说明                                  |
| ------ | ----------------------------------- |
| **编辑** | 修改配置以及是否启用。修改接收地址、接收人或应用配置后，建议重新测试。 |
| **删除** | 删除不再使用的通知对象。删除前，请确认相关订阅已改用其他发送对象。   |

## 配置 Webhook 模板

Webhook 通知目标可将告警发送到群机器人、第三方系统或统一通知平台。创建 Webhook 通知目标时，可以自定义 JSON 格式的请求体模板，平台在发送时会将变量替换为真实告警数据后向 Webhook 地址发起 POST 请求。

支持的顶层变量如下：

* `{{ .Content }}`：告警的完整内容，可能是 JSON 对象或字符串。
* `{{ .AlarmTime }}`：告警发生时间，例如 `2025-12-05T06:52:04Z`。

除完整对象外，还可直接引用 `{{ .Content }}` 中的二级字段。不同告警类型可用字段可能不同，完整变量范围以控制台模板配置提示为准。

| 变量                               | 含义                                       |
| -------------------------------- | ---------------------------------------- |
| `{{ .Content.alarmName }}`       | 告警名称。                                    |
| `{{ .Content.summary }}`         | 告警摘要。                                    |
| `{{ .Content.description }}`     | 告警描述，原文可能包含链接。                           |
| `{{ .Content.descriptionText }}` | 告警描述纯文本。                                 |
| `{{ .Content.level }}`           | 告警级别。                                    |
| `{{ .Content.severity }}`        | 告警严重级别，例如 `critical`、`warning` 或 `info`。 |
| `{{ .Content.status }}`          | 告警状态，例如 `firing` 或 `resolved`。           |
| `{{ .Content.bizId }}`           | 业务 ID。                                   |
| `{{ .Content.cluster }}`         | 集群名称。                                    |
| `{{ .Content.region }}`          | 区域名称。                                    |
| `{{ .Content.location }}`        | 位置信息，例如 region / cluster。                |
| `{{ .Content.orgName }}`         | 租户名。                                     |
| `{{ .Content.user }}`            | 用户名。                                     |
| `{{ .Content.workloadType }}`    | 负载类型。                                    |
| `{{ .Content.workloadId }}`      | 负载 ID。                                   |
| `{{ .Content.resourcePool }}`    | 资源池标识。                                   |
| `{{ .Content.generator }}`       | 详情页地址。                                   |
| `{{ .Content.alarmTime }}`       | 告警时间，等同于 `{{ .AlarmTime }}`。             |

发送给自建服务并传递完整告警数据：

```json theme={null}
{
  "msg_type": "alarm",
  "data": "{{ .Content }}",
  "timestamp": "{{ .AlarmTime }}"
}
```

发送给钉钉、企业微信或飞书自定义机器人，并拼接为文本消息：

```json theme={null}
{
  "msg_type": "text",
  "content": {
    "text": "告警触发！\n详情：{{ .Content }}\n时间：{{ .AlarmTime }}"
  }
}
```

接收端应按标准 JSON 解析请求体。创建或修改模板后，请先测试发送，再将通知目标绑定到告警订阅。

## 后续操作

* [创建告警订阅](./create-alert-subscriptions)