通知对象

更新时间:
复制 MD 格式

通知对象,包括联系人支持通过电话、短信和邮件方式接收告警通知,通知不同类型机器人,或者由自定义webhook处理,并且有效合理安排告警通知值班人员。

功能入口

  1. 登录云监控2.0控制台。

  2. 在左侧导航栏选择告警中心或者所有功能 - 告警中心。

  3. 在告警中心页面,选择通知管理 - 通知对象。

如何通过电话、短信、邮件接收告警通知

联系人

  1. 在联系人页签,单击新建联系人。

  2. 在新建联系人对话框中,根据需求设置以下参数,单击确定。

    • 名称:自定义联系人名称,可以设置重复的名称。

    • 标识符:自定义标识符,不可以与已添加联系人标识符重复。

    • 语言:选择告警通知的消息语言中文或者英文。

    • 电话:设置接收告警的手机号。

    • E-mail:设置联系人的邮箱地址接收告警通知。

  3. 验证手机号码和邮箱地址,在您设置的手机号和邮箱地址中,收到激活链接后单击即可完成。

  4. 告警通知的触达方式与联系人配置要求如下,未完成验证的手机号和邮箱地址收不到告警通知:

    • 电话:需要先完成手机号验证,即单击手机号收到的激活链接。未完成验证的手机号不会接到电话通知。

    • 短信:在电话中设置手机号并完成验证后,即可接收短信通知。

    • E-mail:在E-mail中设置邮箱地址并完成验证后,即可接收邮件通知。

    一条告警最终通过哪几种方式触达,由告警中心 - 通知管理 - 通知策略中该策略选择的通知方式决定,联系人本身只负责提供可用的手机号和邮箱地址。如果联系人信息已验证但仍未收到通知,请检查通知策略是否选择了对应的通知方式。

    费用说明:邮件通知不收费;短信通知和电话通知在超出免费额度后按量计费。

  5. 添加联系人后,可在联系人页签查询、编辑或删除联系人:

    • 搜索联系人:您可以在联系人页签,右侧搜索框中输入联系人姓名的关键字,并单击搜索图标。

    • 编辑联系人:单击目标联系人右侧操作列中的编辑,在弹出的对话框中修改联系人信息,单击确定。

    • 删除单个联系人:单击目标联系人右侧操作列中的删除,在对话框中单击确定。

    • 删除多个联系人:选择目标联系人,单击列表下方删除,在对话框中单击确定。

联系人组

  1. 在联系人页签,单击联系人组列表。

  2. 单击新建联系人组。

  3. 在新建联系人组对话框中,设置以下参数,单击确定。

    • 名称:自定义联系人组名称。

    • 标识符:自定义联系人组的唯一标识。

    • 联系人:选择已有联系人加入联系人组。

  4. 在添加联系人组后,可在联系人组列表,查询、编辑或删除联系人组:

    • 搜索:在右侧搜索框中输入联系人组名关键字,并单击搜索图标。

    • 编辑或者删除:选择目标联系人组操作列,单击编辑或者删除,进行目标联系人组操作。

如果联系人组显示无数据、或者绑定联系人组后无法获取联系人信息,请按以下顺序排查:

  1. 确认组内已加入联系人:在联系人页签单击联系人组列表,打开目标联系人组(例如系统预置的云账号报警联系人),确认联系人中已加入成员。未完成手机号或邮箱地址验证的联系人无法接收告警通知。

  2. 确认告警侧已引用该联系人组:在告警中心 - 通知管理 - 通知策略中打开目标策略,确认其通知对象中已选中该联系人组。联系人组只有被通知策略引用后才会参与告警通知下发。

  3. 通过 OpenAPI 复核组内实际成员:调用 ListContactGroups 查询联系人组,调用 ListContacts 查询联系人,将返回结果与控制台展示的内容比对,确认是配置未生效还是组内确实没有成员。

重要
  • 删除联系人或者联系人组之前,请确保目标联系人或者联系组没有添加至通知策略,否则可能导致告警通知无法发送。

  • 仅支持删除当前用户创建的联系人和组。

通过机器人(钉钉、飞书、SLACK、企业微信、TEAMS)接收告警通知

  1. 在通知对象页面,选择机器人页签,单击新建机器人。

  2. 在新建机器人对话框中,根据需求设置以下参数,单击确定。

    • 名称:自定义机器人名称,可以设置重复的机器人名称。

    • 标识符:自定义唯一标识,不可以与已添加的机器人标识重复。

    • 类型:可以支持不同类型机器人(钉钉、飞书、SLACK、企业微信、TEAMS)接收告警通知。

    • URL:根据选择的机器人类型,设置回调地址。

    • 语言:选择告警通知的消息语言中文或者英文。

  3. 添加机器人后,可在机器人页签查询、编辑或删除机器人:

    • 搜索:根据请选择类型、搜索名称的关键字,查询机器人。

    • 编辑:选择目标机器人,单击右侧操作列中的编辑,在编辑机器人对话框中修改信息,单击确认。

    • 删除:选择目标机器人,单击右侧操作列中的删除,如果需要批量删除,单击机器人列表下方按钮删除,单击确定。

说明
  • 机器人(钉钉、飞书、企业微信、Slack、TEAMS)类型的通知无需配置防火墙白名单。

  • 通知的重试策略为 3 次,超时时间为 5 秒,无退避。

通过自定义webhook接收告警通知

  1. 在通知对象页面,选择自定义Webhook页签,单击新建 Webhook。

  2. 在新建 Webhook对话框中,根据需求设置以下参数,单击确认。

    • 名称:自定义Webhook名称,可以设置重复的名称。

    • 标识符:自定义唯一标识,不可以与已添加的自定义Webhook标识重复。

    • URL:设置自定义的Webhook回调地址。

    • Headers:设置可以携带的参数Param,以<key><value>形式填写,最多可以设置5个参数。

    • Method:设置请求方法GET或者POST。

    • 数据格式:可以选择数据格式FORM或者JSON。

    • 语言:选择通知消息是中文或者英文。

  3. 添加自定义Webhook后,可在自定义Webhook页签查询、编辑或删除自定义Webhook:

    • 搜索:搜索名称的关键字,查询自定义Webhook。

    • 编辑:选择目标自定义Webhook,单击右侧操作列中的编辑,在编辑 Webhook对话框中修改信息,单击确认。

    • 删除:选择目标自定义Webhook,单击右侧操作列中的删除,如果需要批量删除,单击列表下方批量删除,单击确认。

说明
  • 云监控通过 HTTP 协议或 HTTPS 协议的 POST 请求推送告警通知到指定的 URL 地址,请将以下 IP 地址加入防火墙白名单:

    106.11.225.0/24
    106.11.226.0/24
    106.11.227.0/24
    106.11.242.0/24
    106.11.167.0/24
    106.11.245.0/24
    59.82.0.0/16
    59.82.84.0/24
    203.119.128.0/17
    203.119.156.0/24
    121.41.9.246
  • 通知的重试策略为 3 次,超时时间为 5 秒,无退避。

如果推送状态显示成功但接收端未收到告警通知,请按以下顺序排查:

  1. 确认通知对象的类型选择正确:钉钉、飞书、企业微信、SLACK、TEAMS 的群机器人应在机器人页签创建,自定义Webhook页签仅用于自行接收并处理 HTTP 请求或 HTTPS 请求的服务端地址。两者的请求体和鉴权方式不同,把群机器人的回调地址填写在自定义Webhook页签,会出现推送成功但群内没有消息的现象。

  2. 在接收端确认请求是否到达:查看接收端(群机器人平台或自研服务)的 incoming message 记录或访问日志,确认告警时间点是否有请求到达。如果接收端没有任何记录,请先按本章节列出的 IP 地址完成防火墙白名单放通后重试。

  3. 如果请求已到达但接收端未展示消息,请确认Method、数据格式和Headers与接收端的要求一致,并确认接收端在重试策略的超时时间内返回了响应。

Webhook返回字段说明

分类

字段

类型

描述

CloudEvents 标准字段

specversion

String

CloudEvents 规范版本

id

String

事件唯一 ID

type

String

事件类型,如 "ALERT"、“Change”

subtype

String

事件子类型,如 "NORMAL_TRIGGER"(正常触发)、"NORMAL_RESOLVE"(恢复)

source

String

事件来源路径,格式 /{userId}/rules/{ruleId}

sourcetype

String

事件来源系统标识,如 "ALERT_ALIYUN_ALERT_CENTER"

time

String

事件发生时间,ISO 8601 格式

timestamp

Long

事件发生时间,Unix 毫秒时间戳

subject

String

告警规则名称

datacontenttype

String

data 字段的内容类型,固定 "application/json"

告警核心字段

severity

String

严重级别,如:CRITICAL / WARNING / INFO

status

String

告警状态,如 "OCCURRED"(发生)、"RESOLVED"(恢复)

userId

String

用户 ID

ruleId

String

告警规则 ID

workspace

String

工作空间标识,如region内的默认工作空间 default-cms-{userId}-{region}

traceId

String

链路追踪 ID,用于排查问题

alertMessage

String

告警描述消息,主要是告警摘要

alertEntityId

String

告警实体唯一标识

resource 对象

resource.entity.domain

String

实体域,如 "ecs"、"rds"、“apm”

resource.entity.entity_type

String

实体类型,如 "instance"、"disk"

resource.entity.entity_id

String

实体 ID

resource.entity.prop

Object

实体属性,键值对,如 instanceName

resource.tags

Object

资源标签,键值对,包含 instanceId、regionId 等

labels 对象

labels._cms_region

String

地域 ID,如 "cn-hangzhou"

labels._cms_workspace

String

工作空间标识

labels._cms_rule_id

String

告警规则 ID

labels._cms_rule_name

String

告警规则名称

annotations 对象

annotations.current_value

String

当前监控指标值

annotations._cms_promql

String

触发告警的 PromQL 查询表达式

annotations._cms_business_url

String

业务详情页链接

annotations._cms_alert_rule_url

String

告警规则配置页链接

annotations._cms_alert_history_url

String

告警历史记录页链接

data 对象

data.value

Number

触发告警时的实际监控值

data.threshold

Number

告警阈值

data.comparisonOperator

String

比较运算符

alertEntityFields 对象

alertEntityFields

Object

告警实体关键属性平铺,如 instanceName、regionId

快捷链接字段

ruleUrl

String

告警规则控制台链接

entityUrl

String

告警实体详情控制台链接

alertRuleUrl

String

告警规则配置页链接

alertHistoryUrl

String

告警历史页链接

常见问题

如何取消云监控周报邮件通知?

控制台暂无关闭云监控周报邮件的入口。如需停止接收,请联系阿里云客服提交申请,由研发人员在后台关闭该阿里云账号 UID 下的云监控周报通知。关闭后,该云账号下的所有联系人都不再收到云监控周报。

能否通过手机号查询联系人的历史操作日志?

不支持。云监控不提供按手机号查询该联系人操作过哪些服务器的历史操作日志的能力,联系人的手机号仅用于接收告警通知。