告警管理

「告警管理」覆盖告警从产生到关闭的全生命周期，包括告警列表查看、认领/静默/关闭、订阅分派、告警降噪、消息模板与通知记录审计。

入口路径：左侧菜单 告警中心 > 告警管理，页面路由 /admin/duty/alert/index。

页面菜单

页面	路由	说明
告警列表	/admin/duty/alert	查看与处置告警
告警详情	/admin/duty/alert/:uuid	单条告警的详情与事件追踪
订阅策略	/admin/duty/subscript-rules	配置告警通知范围与分派升级
创建订阅策略	/admin/duty/subscript-rules/create	新建订阅策略
编辑订阅策略	/admin/duty/subscript-rules/edit/:uuid	修改订阅策略
降噪配置	/admin/duty/noise	聚合相似告警，抑制告警风暴
消息模板	/admin/duty/template	统一通知内容格式
消息通知	/admin/duty/message	查看通知发送记录

---

告警列表：处置告警

1. 进入 告警管理 > 告警列表。
2. 使用顶部筛选：告警 ID、标题、认领人、来源、告警等级（P1/P2/P3）、状态、是否静默、触发时间范围。
3. 列表展示：名称/ID、来源、等级、状态、是否静默、静默结束时间、认领人、关联规则、描述、当前值、触发时间、持续时长、结束时间。
4. 点击告警名称或「查看」进入告警详情页。
5. 点击「编辑关联规则」可直接跳转到对应告警规则的编辑页。

告警详情页操作

进入告警详情后，页面头部提供以下操作：

• 认领：将告警认领给自己，可填写备注。
• 取消认领：取消当前认领人。
• 手动关闭：确认问题已处理后关闭告警，可填写备注。
• 静默：选择静默时长（2/4/12 小时），期间不再重复通知。
• 解除静默：提前结束静默状态。

详情页下方有两个页签：

• 概述：展示告警基本信息与标签明细。
• 事件追踪：以时间线形式展示告警全生命周期操作记录，含操作人、操作时间、备注等。

建议先认领再处理，避免多人重复排查；处理完成后及时关闭并填写备注，便于后续复盘。

---

订阅策略：把告警通知到正确的人

订阅策略决定哪些告警发给谁、怎么发、超时未处理如何升级。

创建订阅策略

1. 进入 告警管理 > 订阅策略。
2. 点击「新增订阅策略」。
3. 填写基础信息：
   • 策略名称：如 ai-gateway-critical。
   • 策略描述：说明策略用途。
4. 选择 告警模板：从已有消息模板中选择，统一通知格式。
5. 配置 告警范围：
   • 全部告警：订阅所有告警。
   • 部分告警：通过多组 AND/OR 条件过滤告警。
     • 每组条件内可添加多条「属性 + 匹配方式 + 标签值」规则，组内为 AND。
     • 多组之间为 OR。
     • 例如：等级 In P1 AND 来源 In ai-gateway。
6. 配置 分派阶段（可添加多个阶段）：
   • 每个阶段选择 值班小组。
   • 配置私聊通知：按 P1/P2/P3 分别选择通知渠道。
   • 配置群聊通知：统一选择通知渠道。
   • 设置 超时时间：超过 N 分钟未关闭则升级到下一阶段。
   • 选择 升级条件：
     • 未关闭即升级：只要超时未关闭就升级。
     • 未关闭且未认领才升级：已被认领的告警不会升级。
7. 点击「创建」。

多阶段分派可实现逐级兜底：第一阶段通知一线值班，超时未处理自动升级到二线值班。

编辑与删除

1. 在订阅策略列表中找到目标策略。
2. 行操作：编辑、删除（删除前二次确认）。
3. 列表支持按名称、描述排序。

---

降噪配置：抑制告警风暴

降噪配置会把同一窗口内、按相同维度聚合的告警合并为一条通知，避免短时间内大量重复告警轰炸值班人员。

1. 进入 告警管理 > 降噪配置。
2. 选择聚合模式：
   • 不聚合：每条告警都单独发送通知。
   • 聚合：按维度标签与时间窗口合并。
3. 选择 聚合维度标签：
   • 标签选项从服务端异步加载。
   • 支持手动输入创建自定义维度标签。
4. 设置 聚合时间窗口：1 ~ 1440 分钟。
   • 同一窗口内、按所选维度聚合的告警会合并为一条通知。
5. 点击「保存」。
6. 保存成功后页面会自动刷新当前配置。

建议对来源相同、等级相近的告警开启聚合，例如同一节点的 GPU 使用率告警。

---

消息模板：统一通知格式

消息模板用于定义邮件、短信、钉钉机器人三种渠道的通知内容。一条模板可同时适配多种渠道。

新建消息模板

1. 进入 告警管理 > 消息模板。
2. 点击「新增模板」。
3. 填写 模板名称，名称需全局唯一。
4. 分别配置三种渠道的内容：
   • 邮件：标题与正文。
   • 短信：短信正文（注意长度）。
   • 钉钉机器人：Markdown 或文本内容。
5. 点击「确定」。

编辑与搜索

1. 列表支持按模板名称模糊搜索。
2. 行操作：查看、编辑。

订阅策略中引用的模板被修改后，后续发送的通知会立即使用新内容。

---

消息通知：审计通知发送

1. 进入 告警管理 > 消息通知。
2. 使用顶部筛选：接收人、通知类型、发送状态（成功/失败）、时间段。
3. 列表展示：通知 ID（可复制）、通知类型、接收人、发送状态、消息内容、发送时间。
4. 失败消息悬浮可查看错误原因，便于快速定位通知发送异常。

如果值班人员反馈没收到告警，先来这里查看发送状态与失败原因。

---

常见问题

Q：告警触发了但没有通知？ A：请按以下顺序排查：

1. 告警规则是否已启用。
2. 是否已创建订阅策略并匹配到该告警。
3. 订阅策略中的值班小组/通知渠道是否配置正确。
4. 消息通知中是否显示发送失败及失败原因。
5. 告警是否被静默或降噪合并。

Q：如何临时屏蔽某条告警？ A：在告警详情页点击「静默」，选择 2/4/12 小时即可。

Q：P1 告警想同时打电话和发钉钉怎么办？ A：在订阅策略的分派阶段中，P1 的私聊通知渠道同时选择「电话」和「钉钉机器人」即可。

Q：告警处置记录在哪里查看？ A：认领、静默、关闭等处置操作都会写入告警详情页的「事件追踪」时间线，便于审计与复盘。

Q：修改降噪配置后为什么历史告警没有合并？ A：降噪配置修改后立即生效，但仅影响新产生的告警，已发送或已生成的告警不会回溯合并。

Q：订阅策略的过滤条件逻辑如何理解？ A：订阅策略的过滤条件使用 AND/OR 组合，配置时请留意组内（AND）与组间（OR）的逻辑关系，避免过滤条件过严导致告警无法匹配。