通知渠道说明

本文介绍使用各个告警通知渠道的注意事项、前提条件和配置参数等信息。

背景信息

您可以在行动组中,选择如下渠道进行告警通知。

  • 用户:短信、语音、邮件

  • Webhook:

    • 钉钉、企业微信、飞书、Slack、通用Webhook

      在行动组中选择您已创建的Webhook。您可以在Webhook集成管理Webhook。更多信息,请参见Webhook集成

    • 钉钉-自定义、Webhook-自定义

      在行动组中填写Webhook URL等信息。保留这两种方式是为了兼顾历史配置。建议新创建的行动策略,使用Webhook集成方式。

  • 其它:消息中心、事件总线、函数计算

短信

设置告警通知渠道为短信,则触发告警后,日志服务会向指定的用户、用户组或值班组发送短信通知。

  • 注意事项

    使用短信告警通知时,发送通知的号码是随机的,无法提供固定号码。

  • 前提条件

    已创建用户、用户组或值班组。具体操作,请参见创建用户和用户组创建值班组

  • 配置参数

    选择短信渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择短信

    接收人

    选择告警通知的对象(用户、用户组或值班组)。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

语音

设置告警通知渠道为语音,则触发告警后,日志服务会向指定的用户、用户组或值班组发送电话通知。

  • 注意事项

    • 如果某次告警电话未接通,将以短信方式发送一次通知。

    • 日志服务使用如下号码进行语音告警通知,您可将如下号码添加到手机白名单中,以免告警电话被拦截。

      057126885887、057126885890、057126885891、057126885892、057126885893、057126885895、057126885897、057126885901、057126885902、057126885905、057126885907、057126885910、057126885923、057100000268、057100000425、057100000426、057126886776、057126886767、057126886644、057126886464、057128354209、057128354029、057100001824、057128357746、057128357749、02162510523、02162569018、02152362232、02152765115、02152927208、02062766635、02062766652、02062766651、02062766650、05923396667、05923396515、05923396622、05923396548、05923396629

  • 前提条件

    已创建用户、用户组或值班组。具体操作,请参见创建用户和用户组创建值班组

  • 配置参数

    选择语音渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择语音

    接收人

    选择告警通知的对象(用户、用户组或值班组)。

    重要

    语音渠道仅支持中国内地手机号码(+86),即您在创建用户时,配置的手机号码须为中国内地手机号码。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

邮件

设置告警通知渠道为邮件,则触发告警后,日志服务会向指定的用户、用户组或值班组发送邮件通知。

  • 注意事项

    日志服务使用monitor@monitor.aliyun.com邮件地址发送邮件告警通知,您可将该邮件地址添加到邮箱白名单中,以免告警邮件被拦截。

  • 前提条件

    已创建用户、用户组或值班组。具体操作,请参见创建用户和用户组创建值班组

  • 配置参数

    选择邮件渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择邮件

    接收人

    选择告警通知的对象(用户、用户组或值班组)。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

钉钉-自定义

设置告警通知渠道为钉钉-自定义,则触发告警后,日志服务会通过钉钉机器人向指定的钉钉群发送告警通知,并且支持提醒指定成员。

  • 注意事项

    每个机器人每分钟最多发送20条告警通知。

  • 前提条件

    使用钉钉发送告警通知前,需要完成如下配置。

    • 根据钉钉企业内部应用机器人的创建和安装创建一个消息接收模式为HTTP模式的机器人应用。

    • 打开钉钉客户端,进入钉钉群,单击右上角的群设置图标。

    • 选择  机器人 > 添加机器人

    • 选择第一步创建的机器人,并单击添加,再点击完成。

    • 在群聊中的机器人管理页面查看创建好的机器人,复制Webhook链接。

  • 配置参数

    选择钉钉-自定义渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择钉钉-自定义

    请求地址

    配置为您在钉钉群里生成的Webhook链接。

    提醒方式

    支持在钉钉群里提醒指定成员,可选值为不提醒、所有人、指定成员。

    配置为指定成员时,需选择被提醒的用户、用户组或值班组。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    说明

    钉钉支持Markdown格式。更多信息,请参见钉钉

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

Webhook-自定义

设置告警通知方式为Webhook-自定义,当触发告警时,日志服务会向自定义的Webhook地址发送告警通知。

  • 注意事项

    Webhook方式对应的超时时间为5秒,如果发出请求后5秒内没有返回,则表示发送失败。

  • 前提条件

    已获取Webhook地址。

  • 配置参数

    选择Webhook-自定义渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    说明

    Webhook调用成功时返回的状态码需为200,否则会被日志服务认为请求失败,导致重复调用。

    参数

    说明

    渠道

    选择Webhook-自定义

    请求地址

    Webhook地址,必须为公网地址(例如外网域名、IP:Port格式的URL)。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    使用自定义Webhook时,建议设置内容模板中的内容为JSON格式。

    请求方式

    支持GET、POST、DELETE、PUT和OPTIONS。

    无特殊需求时,推荐使用POST方法。该方法在各个Web框架中的支持程度最好。

    请求头

    单击添加请求头,可添加请求头信息。例如Content-Type: application/json;charset=utf-8

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

消息中心

设置告警通知渠道为消息中心,则触发告警后,日志服务会通过消息中心向指定人员发送告警通知。

  • 前提条件

    使用消息中心发送告警通知前,需先在阿里云消息中心完成如下配置。

    1. 登录阿里云消息中心

    2. 选择消息接收管理 > 基本接收管理,单击日志服务(LOG)告警右侧的修改

    3. 修改消息接收人对话框中,选择消息接收人,单击保存

      本账号负责人可新增消息接收人。配置完成后,系统将自动发送验证信息到所填手机号码和邮箱,通过验证后方可接收消息。

      说明
      • 最少需要设置1位消息接收人。

      • 消息接收方式默认为邮件+短信,且不可更改。

  • 配置参数

    选择消息中心渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择消息中心

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

钉钉

设置告警通知渠道为钉钉,则触发告警后,日志服务会通过钉钉机器人向指定的钉钉群发送告警通知,并且支持提醒指定成员。

  • 注意事项

    每个机器人每分钟最多发送20条告警通知。

  • 前提条件

    已创建Webhook。具体操作,请参见Webhook集成

  • 配置参数

    选择钉钉渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择钉钉

    选择Webhook

    选择您已创建的Webhook。

    提醒方式

    支持在钉钉群里提醒指定成员,可选值为不提醒、所有人、指定成员。

    配置为指定成员时,需选择被提醒的用户、用户组或值班组。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    说明

    钉钉支持Markdown格式。更多信息,请参见内容格式

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

企业微信

设置告警通知渠道为企业微信,则触发告警后,日志服务会通过企业微信机器人向指定的企业微信群发送告警通知。

  • 前提条件

    已创建Webhook。具体操作,请参见Webhook集成

  • 配置参数

    选择企业微信渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择企业微信

    选择Webhook

    选择您已创建的Webhook。

    提醒方式

    支持在企业微信群里提醒指定成员,可选值为不提醒、所有人、指定成员。

    配置为指定成员时,需选择被提醒的用户、用户组或值班组。

    重要

    配置为所有人指定成员时,企业微信的通知内容只能为普通文本格式,不支持Markdown格式。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    说明

    企业微信支持Markdown格式。更多信息,请参见内容格式

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

飞书

设置告警通知渠道为飞书,则触发告警后,日志服务会通过飞书机器人向指定的飞书群发送告警通知。

  • 前提条件

    已创建Webhook。具体操作,请参见Webhook集成

  • 配置参数

    选择飞书渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择飞书

    选择Webhook

    选择您已创建的Webhook。

    提醒方式

    支持在飞书群里提醒所有人,可选值为不提醒、所有人。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    说明

    飞书支持Markdown格式。更多信息,请参见内容格式

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

Slack

设置告警通知渠道为Slack,则触发告警后,日志服务会向Slack用户发送告警通知。

  • 前提条件

    已创建Webhook。具体操作,请参见Webhook集成

  • 配置参数

    选择Slack渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择Slack

    选择Webhook

    选择您已创建的Webhook。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    说明

    Slack支持Markdown格式。更多信息,请参见内容格式

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

通用Webhook

设置告警通知渠道为通用Webhook,则当触发告警时,日志服务会向自定义的Webhook地址发送告警通知。

  • 前提条件

    已创建Webhook。具体操作,请参见Webhook集成

  • 配置参数

    选择通用Webhook渠道时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择通用Webhook

    选择Webhook

    选择您已创建的Webhook。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

事件总线(EventBridge)

设置告警通知渠道为事件总线(EventBridge),则触发告警后,日志服务会向事件总线发送一个告警事件。

  • 前提条件

    • 已在阿里云事件总线EventBridge服务中创建自定义总线。具体操作,请参见创建自定义总线

      说明

      在创建自定义总线时,可忽略事件源的配置。如果要添加事件源,则需创建一个名为acs.sls.alert的事件源,与告警事件中source字段的值保持一致。

    • 如果您使用的是RAM账号,需先授予该RAM用户AliyunEventBridgeReadOnlyAccess权限。

  • 配置参数

    选择事件总线(EventBridge)时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择事件总线(EventBridge)

    地域

    选择您已创建的事件总线的所在地域。

    事件总线

    选择您已创建的事件总线。日志服务将发送告警事件给该事件总线。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制

  • 事件字段说明

    触发告警后,日志服务会生成一个告警事件并发送给事件总线,事件规范请参见事件概述。日志服务生成的事件字段说明如下:

    重要
    • 如果生成了多个告警,则每个告警都会发送告警事件,不会进行告警合并。

    • 如果内容模板(事件总线)中的发送内容不是JSON格式,则告警事件发送成功后,在事件总线的事件规则中将无法使用data字段中的变量。

    字段名称

    说明

    id

    事件ID,全局唯一。

    source

    事件源,固定为acs.sls.alert。

    specversion

    CloudEvents协议版本,当前为1.0版本。

    type

    事件类型。

    • 如果告警状态为触发告警,则事件类型为sls:AlertEvent:Firing。

    • 如果告警状态为恢复通知,则事件类型为sls:AlertEvent:Resolved。

    datacontenttype

    data字段的内容格式,固定为application/json。

    subject

    事件主题,对应内容模板中设置的EventBridge主题。

    time

    事件产生的时间,对应告警消息中的alert_time字段。

    data

    事件内容,对应内容模板中设置的EventBridge发送内容,必须为JSON格式。

函数计算(FC)

设置告警通知渠道为函数计算(FC),则告警触发后,日志服务会调用您所创建的函数。

  • 注意事项

    • 只支持非HTTP函数。如果是HTTP函数,请使用自定义Webhook方式。

    • 只支持以sls-ops-开头的函数。

  • 前提条件

    • 已经在阿里云函数计算服务中创建服务以及函数(仅支持非HTTP函数)。更多信息,请参见快速创建函数

    • 如果您使用的是RAM账号,需先授予该RAM用户AliyunFCReadOnlyAccess权限。

  • 配置参数

    选择函数计算(FC)时,需在行动组对话框中完成如下配置。具体操作,请参见创建行动策略

    参数

    说明

    渠道

    选择函数计算(FC)

    地域

    选择您已创建的函数的所在地域。

    服务

    选择您已创建的函数计算服务。

    版本/别名

    选择服务的版本或别名,默认为LATEST。

    函数

    选择您已创建的函数。仅支持以sls-ops-开头的函数。

    内容模板

    告警通知的内容。日志服务根据您所选择的内容模板,发送告警通知的内容。

    发送时段

    告警通知的发送时间。更多信息,请参见通知发送时段机制