管理联系人

通知策略的匹配规则被触发时,可以向您指定的联系人发送通知。本文介绍如何设置联系人、联系人组、钉钉机器人,以及如何获取钉钉机器人Webhook地址创建Webhook告警。

联系人

创建联系人

  1. 登录SAE控制台

  2. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  3. 在左侧导航栏,选择通知告警 > 联系人管理

  4. 通知对象页面的联系人页签,单击新建联系人

  5. 新建联系人对话框,配置相关信息,然后单击确认

    配置项

    说明

    姓名

    自定义联系人姓名。

    手机号码

    设置联系人的手机号码后,可以通过电话和短信的方式接收告警通知。

    说明

    仅验证过的手机号码可以在通知策略中使用电话的通知方式。验证手机号的操作,请参见验证手机号

    邮箱

    设置联系人的邮箱地址后,可以通过邮箱接收告警通知。

    联系人组

    选择联系人需要加入的联系人组。创建联系人组的操作,请参见联系人组

    电话通知失败补发类型

    选择电话通知失败后,通知补发类型。您可以在联系人页签设置全局默认值。具体操作,请参见设置联系人默认配置

    说明
    • 手机号码和邮箱至少填写一项,每个手机号码或邮箱只能用于一个联系人。

    • 如果您需要创建钉钉机器人,请在钉钉/飞书/企微页签新建钉钉机器人。具体操作,请参见钉钉机器人

    创建联系人后,您可以在联系人页签查询、编辑或删除联系人。

验证手机号

仅验证过的手机号可以在通知策略中使用电话的通知方式。

  1. 登录SAE控制台

  2. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  3. 在左侧导航栏,选择通知告警 > 联系人管理

  4. 通知对象页面的联系人页签,选择为一个或多个联系人验证手机号。

    • 如需为单个联系人验证手机号:单击未验证手机号右侧的未验证

    • 如需为多个联系人批量验证手机号:在复选框选中需要验证手机号的联系人,然后单击批量验证

    系统将会给各联系人发送验证手机号短信。

  5. 使用浏览器打开短信中的链接。

    验证手机号短信

  6. 在验证页面确认手机号信息,然后单击验证

设置联系人默认配置

告警通过电话通知失败后,您可以设置通知补发类型。

  1. 登录SAE控制台

  2. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  3. 在左侧导航栏,选择通知告警 > 联系人管理

  4. 通知对象页面的联系人页签,选择更多操作 > 联系人默认配置

  5. 在弹出的对话框,选择通知补发类型,然后单击确认

联系人组

创建通知策略时,您可以将联系人组指定为通知对象。当通知策略的匹配规则被触发时,SAE告警管理会向该联系人组中的联系人通过电话、短信、邮件和钉钉等方式发送告警通知。

前提条件

创建联系人

创建联系人组

  1. 登录SAE控制台

  2. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  3. 在左侧导航栏,选择通知告警 > 联系人管理

  4. 通知对象页面的联系人页签,单击新建联系人组

  5. 新建联系组对话框,输入组名,选择告警联系人,并单击确认

    创建成功后,对应的联系人组将显示在联系人页签的左侧列表中。

管理联系人组

创建联系人组后,您可以在联系人页签查询、编辑或删除联系人组。

  • 编辑联系人组:在目标联系人组右侧选择更多图标 > 编辑组,在弹出的对话框中修改联系人组的名称或包含的联系人,然后单击确认

  • 查看联系人组详情:单击联系人组左侧的Down arrow图标展开联系人组。

  • 删除联系人组:在目标联系人组右侧选择更多图标 > 删除组,然后在弹出的提示对话框中单击确认

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

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

钉钉机器人

SAE通知告警中创建钉钉机器人后,您可以在通知策略中指定对应的钉钉群用于接收告警。当通知策略的规则被触发时,系统会自动向您指定的钉钉群发送告警通知。钉钉群收到通知后,您可以在钉钉群中对告警进行管理。

在SAE控制台创建告警通知钉钉群

  1. 在钉钉群中创建自定义机器人并获取机器人Webhook地址。具体操作,请参见获取钉钉机器人Webhook地址

  2. 登录SAE控制台

  3. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  4. 在左侧导航栏,选择通知告警 > 联系人管理,在通知对象页面的钉钉/飞书/企微页签,单击钉钉卡片。

  5. 新建钉钉机器人面板,设置相关信息,然后单击确定

    说明

    在通知策略中需要选择通知方式钉钉才能在钉钉群中接收告警。具体操作,请参见通知策略

    配置项

    说明

    名称

    自定义钉钉机器人的名称。

    签名密钥

    可选,如配置了密钥则会通过加签的方式进行钉钉认证。如果没有配置密钥,默认使用关键字白名单的方式进行认证,白名单关键字为告警更多信息,请参见钉钉官方文档

    机器人地址

    输入钉钉机器人的Webhook地址。

    机器人是否发送每日统计

    选中后,需要输入每日统计信息发送的时间点,使用英文半角逗号(,)分隔多个发送时间点,时间点格式为HH:SS。告警管理将在设置的时间点发送今日产生告警的总数、解决数和待解决数。

    卡片内容配置

    自定义告警通知卡片样式和内容。

在钉钉群管理告警

在钉钉群中收到告警通知后,您可以在钉钉群里查看并管理告警。更多信息,请参见在告警通知群中处理告警

获取钉钉机器人Webhook地址

设置钉钉群或在联系人中设置钉钉机器人时,需要先在钉钉群中获取自定义机器人Webhook地址。本文介绍如何获取钉钉机器人Webhook地址。请按照以下步骤在钉钉群中添加自定义钉钉机器人并获取Webhook地址。

  1. 在PC版钉钉上打开您想要添加报警机器人的钉钉群,并单击右上角的群设置图标。

  2. 群设置面板中单击机器人,然后单击添加机器人

  3. 智能群助手面板单击添加机器人,继续单击添加机器人,然后选择添加自定义image.png

  4. 群机器人对话框单击添加机器人区域的设置图标,然后选择添加自定义

  5. 机器人详情对话框单击添加

  6. 添加机器人对话框中执行以下操作。db_add_custom_robot.png

    1. 设置机器人头像和名字。

    2. 安全设置选中自定义关键词,设置关键词为SAE

    3. 选中我已阅读并同意《自定义机器人服务及免责条款》

    4. 单击完成

    说明

    更多关于钉钉机器人的操作,请参见自定义机器人接入

  7. 添加机器人对话框中复制生成的机器人Webhook地址,然后单击完成

    生成的Webhook地址可匹配联系人的通知方式,并用于设置事件中心的订阅规则。具体操作,请参见联系人管理订阅事件sc_create_a_new_contact_and_add_dingding_robot_webhook

通过Webhook自定义告警通知联系人

创建通知策略时,您可以将告警通知发送到自定义的Webhook地址中。通知告警支持对飞书、微信、钉钉等群组发送Webhook告警。本文以飞书为例,介绍如何创建Webhook告警。

步骤一:获取Webhook地址

  1. 打开并登录飞书。

  2. 单击+图标,然后单击创建群组,新建一个用于发送告警的群组。

  3. 单击群组设置图标,然后单击群机器人页签,在群机器人页签,单击添加机器人

  4. 添加机器人面板,选择Custom Bot,然后在配置页,输入机器人名称描述,单击添加

  5. 复制Webhook地址,然后选中自定义关键词并输入关键词为告警,然后单击完成

步骤二:创建Webhook联系人

  1. 登录SAE控制台

  2. 在左侧导航栏,选择应用管理 > 应用列表,在顶部菜单栏选择地域,然后单击具体应用名称。

  3. 在左侧导航栏,选择通知告警 > 联系人管理

  4. 通知对象页面的Webhook集成页签,单击新建Webhook

  5. 新建Webhook对话框,配置以下信息,然后单击确定

    信息配置完成后,您可以先单击发送测试,验证配置是否成功,然后再单击确定

    配置项

    说明

    Webhook名称

    自定义Webhook名称。

    Post/Get

    设置请求方法。URL不超过100个字符。

    此例中选择Post,并将步骤一:获取Webhook地址中保存的Webhook地址粘贴至右侧文本框。

    Header/Param

    设置请求头,不可超过200个字符。 单击添加,可以添加其他Header信息或Param信息。默认请求头为Content-Type: text/plain; charset=UTF-8,Header和Param个数总数不能超过6个。

    此例中设置以下两个Header

    • Arms-Content-Type : json

    • Content-Type : application/json

    通知模板

    告警触发时发送的通知模板,在Post方法下出现,可使用$content占位符输出通知内容,不可超过500个字符。更多信息,请参见配置通知模板和Webhook模板

    通知模板如下:

    {
    "告警名称":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "集群名称":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "应用名称":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "通知策略":"{{ .dispatchRuleName }}",
    "告警时间":"{{ .startTime }}",
    "告警内容":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    此处以飞书为例,可以设置如下文本格式:

    {
      "msg_type": "text",
      "content": {
        "text": "告警名称: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}集群名称: {{ .commonLabels.clustername }}\n{{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}应用名称: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}通知策略: {{ .dispatchRuleName }} \n告警时间: {{ .startTime }} \n告警内容: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

    恢复模板

    告警恢复时发送的通知模板,在Post方法下出现,可使用$content占位符输出通知内容,不超过500个字符。更多信息,请参见配置通知模板和Webhook模板

    恢复模板如下:

    {
    "告警名称":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "集群名称":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "应用名称":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "通知策略":"{{ .dispatchRuleName }}",
    "恢复时间":"{{ .endTime }}",
    "告警内容":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    此处以飞书为例,可以设置如下文本格式:

    {
      "msg_type": "text",
      "content": {
        "text": "告警名称: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}集群名称: {{ .commonLabels.clustername }}\n{{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}应用名称: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}恢复时间: {{ .startTime }} \n通知策略: {{ .dispatchRuleName }} \n恢复告警内容: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

步骤三:设置通知策略

新建或编辑通知策略,选择通知对象通用Webhook,然后选择对应的Webhook集成。具体操作,请参见通知策略

说明

Webhook告警的超时时间为5秒,如果发出请求后5秒内没有返回,即没有收到告警信息,则表示发送失败。