更新时间:2025-08-28 GMT+08:00
分享

创建AOM告警消息模板

AOM提供消息模板功能,可通过创建消息模板自定义配置通知消息,当AOM触发已设定的告警通知策略时,可通过此功能以您自定义消息模板的邮件、短信、飞书、企业微信、钉钉、语音、welink、HTTP或HTTPS形式通知指定的人员。

功能介绍

  • 支持邮件、短信、企业微信、钉钉、飞书、语音、welink、HTTP或HTTPS消息模板。
  • 支持消息模板自定义,详情请参考自定义消息模板内容

约束与限制

  • 您最多可创建100个“指标或事件(Prometheus监控)”类型的消息模板,100个日志(日志监控)类型的消息模板,100个云监控类型的消息模板,如果某种类型的消息模板数量已达上限100时,请删除不需要的消息模板。
  • 系统默认预置多个消息模板供用户使用,预置消息模板不可删除与编辑。当用户未自定义消息模板时,默认采用预置消息模板发送通知。
  • 如果您未创建任何消息模板,则采用默认消息模板。
  • welink消息模板当前受限开放,如有需求可以通过提交工单,联系工程师为您开放此功能。
  • 仅开通了云监控CES融合功能才支持创建“云监控”类型消息模板。当前云监控CES融合功能受限开放,如有需求可以通过提交工单,为您开放此功能。
  • AOM 2.0融合CES相关功能后,会向AOM FullAccess策略中添加“CES:*:*”,“ecs:instance:list”,“dms:instance:list”,“dms:instance:get”,“lts:topics:list”,“lts:groups:list”,“smn:topic:list”,“smn:topic:publish”,“swr:repository:*”,“swr:repo:*”,“vpc:bandwidths:get”,“as:groups:get”,“astrocanvas:*:*”细粒度权限,若您之前通过AOM FullAccess策略对租户下子用户进行了权限控制,那么AOM FullAccess策略增加上述权限后,子用户也会展示上述云服务资源,您若仍有子用户云服务资源控制诉求,则您可自行进行自定义的子用户权限配置,从而达成子用户云服务资源展示控制效果。
  • 邮箱、企业微信、钉钉、飞书消息模板的告警通知内容中告警级别取值的颜色不同。(当前受限开放,如有需求可以通过提交工单,联系工程师为您开放此功能。)
    • 紧急告警:红色。
    • 重要告警:橙色。
    • 次要告警:黄色。
    • 提示告警:蓝色。
    • 恢复告警:绿色。

    其中飞书消息模板的告警通知内容中的重要,提示,次要的告警级别都显示灰色。

创建消息模板

  1. 登录AOM 2.0控制台
  2. 在左侧导航栏中选择“告警中心 > 告警通知”。
  3. 在右侧区域的“消息模板”页签下,单击“创建消息模板”。

    1. 输入模板名称、模板描述、消息模板类型和企业项目信息。
      表1 参数说明

      参数名称

      说明

      模板名称

      消息模板的名称,只能由中文、数字、字母、下划线、中划线、小数点组成,且不能以下划线、中划线、小数点开头和结尾,最多可输入100个字符。当前消息模板的名称支持小数点受限部分区域开放,如有需求可以通过提交工单,为您开放此功能。

      模板描述

      消息模板的描述信息,最多可输入1024个字符。

      消息模板类型

      消息模板的类型,当前支持“prometheus监控”和“日志监控”类型。

      当前仅华南-广州区域消息模板类型为“prometheus监控”、“日志监控”和“云监控”。AOM 2.0控制台中创建“云监控”类型消息模板功能由云监控服务CES提供,操作详情请参考创建通知内容模板

      企业项目

      所属的企业项目。

      • 如果在全局页面设置为“ALL”,此处请从下拉列表中选择企业项目。
      • 如果在全局页面已选择企业项目,则此处灰化不可选。
      • 在创建告警消息模板过程中,如果要选择刚新创建的企业项目,建议企业项目创建后等待10分钟左右,再进行告警消息模板创建。
    2. 选择语言,当前仅支持选择中文简体和英文。
    3. 自定义模板内容(创建prometheus监控类消息模板时会自动填充默认字段),模板包括邮件、短信、企业微信、钉钉等。prometheus监控类消息模板具体请参见表2。日志监控类消息模板具体请参见表3
      • 除默认模板的消息字段外,消息模板还支持用户自定义字段,需用户在上报事件告警信息时在指定参数上传该字段。
      • 自定义字段支持以JSONPath的方式取值,示例:$event.metadata.case1、$event.metadata.case[0]
      • 在“正文”区域右上角,单击“添加变量”可复制需要的变量信息。
      • 当在消息模板中添加“TMS标签: $event.annotations.tms_tags;”变量时,需要在配置告警消息内容显示资源的TMS标签开关配置中打开“告警消息内容显示资源的TMS标签开关”开关后,该变量才会生效。
      • 选择“邮件”方式发送通知时,可单击“预览”查看设置的邮件消息模板效果。在预览界面,可根据需要修改消息主题。
      表2 默认消息模板变量说明

      变量名称

      变量说明

      变量定义

      告警名称

      触发的告警规则的名称。

      ${event_name_alias}

      告警ID

      触发的告警规则的ID。

      ${id}

      通知规则

      发送告警通知的告警通知规则名称。

      ${action_rule}

      触发时间

      触发此告警或事件的时间。

      ${starts_at}

      触发级别

      创建告警规则时选择告警或事件级别:紧急、重要、次要、提示。

      ${event_severity}

      告警内容

      详细的告警信息说明。

      ${alarm_info}

      资源标识

      触发告警或事件对应的具体资源。

      ${resources_new}

      自定义标签

      标签扩展字段。

      $event.metadata.key1

      修复建议

      修复建议,非自定义上报则展示"NA"。

      ${alarm_fix_suggestion_zh}

      自定义标注

      标注扩展字段。

      $event.annotations.key2

      表3 配置日志消息模板参数

      参数名称

      说明

      校验规则

      样例

      主题

      消息的主题

      支持自定义主题名称和使用变量命名主题两种方式。主题名称长度不能超过512个字符。

      仅邮件类型支持配置消息主题。

      test

      正文

      消息的内容

      添加变量:

      • 规则原始名称:${event_name}
      • 告警级别:${event_severity}
      • 发生时间:${starts_at}
      • 发生区域:${region_name}
      • 华为云账号:${domain_name}
      • 告警源:$event.metadata.resource_provider
      • 资源类型:$event.metadata.resource_type
      • 资源标识:${resources}
      • 告警状态:$event.annotations.alarm_status
      • 表达式:$event.annotations.condition_expression
      • 当前值:$event.annotations.current_value
      • 统计周期:$event.annotations.frequency
      • 规则名称:$event.annotations.alarm_rule_alias
      • 关键词变量
        1. 查询时间:$event.annotations.results[0].time
        2. 查询日志:

          $event.annotations.results[0].raw_results

        3. 查询URL:

          $event.annotations.results[0].url

        4. 日志组/日志流名称:$event.annotations.results[0].resource_id

          只支持添加首次创建的日志组/日志流原始名称,不支持添加修改后的日志组/日志流名称。

      • SQL变量
        1. 图表0的日志组/流名称:$event.annotations.results[0].resource_id

          只支持添加首次创建的日志组/日志流原始名称,不支持添加修改后的日志组/日志流名称。

        2. 图表0的查询语句:$event.annotations.results[0].sql
        3. 图表0的查询时间:$event.annotations.results[0].time
        4. 图表0的查询URL:$event.annotations.results[0].url
        5. 图表0的查询日志:$event.annotations.results[0].raw_results

      ${event_name}

      ${event_severity}

      ${starts_at}

      ${region_name}

    4. 设置完成,单击“确定”完成消息模板创建。

更多操作

消息模板创建完成后,您还可以对消息模板列表执行表4中的相关操作。

表4 相关操作

操作

说明

编辑消息模板

单击“操作”列的“编辑”。

复制消息模板

单击“操作”列的“复制”。

删除消息模板

  • 删除单条消息模板:单击对应规则“操作”列的“删除”,随后在提示页面单击“确定”即可删除。
  • 删除单条或多条消息模板:勾选对应规则前的复选框,单击“批量删除”,随后在提示页面单击“确定”即可删除。

删除消息模板前需要先删除消息模板绑定的告警通知规则。

搜索消息模板

在搜索框中通过消息模板名称、描述、消息模板类型、更新时间筛选消息模板,也可以直接通过输入关键字搜索消息模板。

相关文档