统一告警模板规范¶

文档版本：V1.0 发布日期：2026-09-02 文档性质：模板规范类

1. 文档概述¶

本规范定义了告警通知模板的统一结构、内容要素及渠道适配规则。所有告警通知（邮件、IM、短信、电话）必须遵循本规范，确保信息完整性与一致性。

2. 告警模板核心结构¶

每条告警通知必须包含以下五大核心模块：

+--------------------------------------------------+
| 1. 告警身份区    - 告警ID、级别、时间            |
| 2. 资源定位区    - 受影响资源、环境、位置          |
| 3. 故障详情区    - 触发条件、当前值、阈值          |
| 4. 工单关联区    - 工单编号、状态、处理人、SLA     |
| 5. 行动指引区    - 处理建议、文档链接、升级路径    |
+--------------------------------------------------+

3. 告警级别与模板映射¶

不同级别使用不同的模板样式和通知渠道：

数字权重	级别	通知渠道	模板风格	是否触发工单
6	CRITICAL	电话 + 短信 + IM + 邮件	红色紧急模板	是
5	HIGH	短信 + IM + 邮件	橙色紧急模板	是
4	ERROR	IM + 邮件	黄色模板	是
3	WARNING	邮件（或IM静默）	蓝色模板	视情况
2	INFO	不推送（仅日志）	—	否
1	DEBUG	不推送（仅日志）	—	否
0	CLOSE	IM静默 + 邮件	绿色恢复模板	关闭工单

4. 各渠道模板规范¶

4.1 邮件告警模板¶

邮件主题格式：

【{级别}】{告警名称} - {资源标识} - {告警ID}

邮件正文结构（JSON格式，便于解析）：

{
  "alarm": {
    "id": "${alarm_id}",
    "level": "${alarm_level}",
    "weight": ${alarm_weight},
    "name": "${alarm_name}",
    "status": "${alarm_status}",
    "time": "${alarm_time}",
    "source": "${alarm_source}"
  },
  "resource": {
    "type": "${event_type}",
    "name": "${server_name}",
    "ip": "${server_ip}",
    "env": "${env}",
    "region": "${region}",
    "zone": "${zone}"
  },
  "details": {
    "condition": "${trigger_condition}",
    "current_value": "${current_value}",
    "threshold": "${threshold}",
    "content": "${alarm_content}"
  },
  "ticket": {
    "id": "${case_id}",
    "status": "${case_status}",
    "priority": "${case_priority}",
    "assignee": "${assignee}",
    "sla_remaining": "${sla_remaining}",
    "sla_status": "${sla_status}"
  },
  "actions": {
    "suggestions": "${suggestions}",
    "doc_url": "${doc_url}",
    "escalation_contact": "${escalation_contact}"
  }
}

4.2 钉钉/企业微信告警模板（Markdown格式）¶

标题：

## 【{级别}】{告警名称}

正文：

> **告警ID**：${alarm_id}
> **时间**：${alarm_time}
> **环境**：${env}（${region}/${zone}）

> **资源**：${server_name}（${server_ip}）

> **详情**：${alarm_content}
> **当前值**：${current_value}（阈值：${threshold}）

> **工单**：[${case_id}]（${case_status}）
> **处理人**：@${assignee}
> **剩余SLA**：${sla_remaining}

> 🔗 [查看详情](${alarm_url})

4.3 短信告警模板（纯文本，限140字符）¶

【${级别}】${告警名称} ${资源名} ${当前值}/${阈值} 工单${工单ID} 处理人:${处理人}

示例：

【CRITICAL】存储池使用率超限 backup-01 95%/90% 工单TKT-123 处理人:zhangli

4.4 电话告警模板（语音播报）¶

告警级别{级别}，{告警名称}，资源{资源名}，当前值{当前值}，阈值{阈值}，请立即处理。

5. 模板变量填充规范¶

5.1 必填变量（所有模板必须包含）¶

变量	说明
`${alarm_id}`	告警唯一标识
`${alarm_level}`	级别名称
`${alarm_weight}`	级别权重
`${alarm_time}`	触发时间
`${alarm_content}`	详细描述
`${server_name}`	资源名称
`${case_id}`	工单编号（如有）
`${assignee}`	处理人（如有）

5.2 条件必填变量（根据场景）¶

场景	必填变量
阈值告警	`${current_value}`、`${threshold}`
性能告警	`${trigger_condition}`
恢复通知	`${recovery_time}`、`${previous_level}`

5.3 敏感变量处理规则¶

变量	处理方式
`${password}`	禁止出现在任何通知中
`${token}`	禁止出现在任何通知中
`${phone}`	仅允许在短信/电话渠道使用，禁止邮件明文
`${email}`	仅允许在邮件渠道使用

6. 模板管理与版本控制¶

6.1 模板生命周期¶

[创建] -> [审批] -> [测试] -> [发布] -> [使用] -> [归档]

6.2 模板版本号规则¶

版本类型	格式	示例
初始版本	`v1.0`	新建模板
小变更	`v1.1`、`v1.2`	新增变量、修改措辞
大变更	`v2.0`、`v3.0`	结构调整、渠道变更

6.3 模板审批流程¶

创建人：编写模板草案
运维组长：审核告警内容完整性
安全专员：审核敏感变量处理合规性
研发负责人：审核变量来源正确性
发布：审核通过后上线

7. 模板示例集¶

7.1 备份任务失败告警（CRITICAL）¶

邮件主题：

【CRITICAL】备份任务异常 - ${job_name} - ${alarm_id}

IM通知：

## 【CRITICAL】备份任务异常

> **告警ID**：${alarm_id}
> **时间**：${alarm_time}
> **环境**：${env}

> **任务**：${job_name}（${backup_type}）
> **资源**：${source_path}
> **目标**：${target_path}

> **错误码**：${error_code}
> **详情**：${alarm_content}

> **工单**：[${case_id}]（${case_status}）
> **处理人**：@${assignee}

> 🚨 请立即处理！已升级至${escalation_level}

7.2 存储库容量告警（HIGH）¶

邮件主题：

【HIGH】存储库容量告警 - ${storage_name} - ${alarm_id}

IM通知：

## 【HIGH】存储库容量告警

> **告警ID**：${alarm_id}
> **时间**：${alarm_time}

> **存储库**：${storage_name}
> **已用**：${storage_used} / ${storage_total}（${storage_usage_rate}%）
> **阈值**：${threshold}%

> **影响**：剩余容量仅 ${storage_free}，预计 ${predicted_full_time} 后写满

> **工单**：[${case_id}]（${case_status}）
> **处理人**：@${assignee}
> **剩余SLA**：${sla_remaining}

7.3 告警恢复通知（CLOSE）¶

邮件主题：

【恢复】${alarm_name} - ${server_name} - ${alarm_id}

IM通知：

## ✅ 【恢复】${alarm_name}

> **告警ID**：${alarm_id}
> **触发时间**：${alarm_time}
> **恢复时间**：${recovery_time}
> **持续时长**：${duration}

> **资源**：${server_name}（${server_ip}）
> **原告警级别**：${previous_level}

> **恢复原因**：${recovery_reason}
> **当前值**：${current_value}（已恢复正常）

> **关联工单**：[${case_id}] 已自动关闭

7.4 网络丢包率告警（HIGH）¶

IM通知：

## 【HIGH】网络链路质量异常

> **告警ID**：${alarm_id}
> **时间**：${alarm_time}

> **链路**：${link_name}（${server_name} → ${peer_ip}）
> **丢包率**：${packet_loss_rate}%（阈值 ${threshold}%）
> **延迟**：${rtt_avg} ms（抖动 ${jitter} ms）

> **影响**：备份数据同步效率下降，增量备份窗口可能超时

> **工单**：[${case_id}]
> **处理人**：@${assignee}

8. 模板合规检查清单¶

上架新模板前，必须完成以下检查：

检查项	状态
包含告警身份区（ID、级别、时间）	☐
包含资源定位区（名称、IP、环境）	☐
包含故障详情区（条件、当前值、阈值）	☐
包含工单关联区（ID、状态、处理人、SLA）	☐
包含行动指引区（建议、文档、升级路径）	☐
敏感变量（password/token）已排除	☐
所有必填变量已替换验证	☐
各渠道模板（邮件/IM/短信）已适配	☐
模板版本号已更新	☐
已通过审批流程	☐

附录：模板变量引用速查¶

模板模块	常用变量
告警身份	`${alarm_id}`、`${alarm_level}`、`${alarm_weight}`、`${alarm_time}`
资源定位	`${server_name}`、`${server_ip}`、`${env}`、`${region}`、`${zone}`
故障详情	`${trigger_condition}`、`${current_value}`、`${threshold}`、`${alarm_content}`
工单关联	`${case_id}`、`${case_status}`、`${assignee}`、`${sla_remaining}`
备份专用	`${job_name}`、`${backup_type}`、`${backup_size}`、`${storage_usage_rate}`
网络专用	`${packet_loss_rate}`、`${rtt_avg}`、`${jitter}`、`${availability_rate}`
恢复专用	`${recovery_time}`、`${previous_level}`、`${recovery_reason}`