文档

配置开放告警对外接口

更新时间:

您可以在日志服务控制台上配置开放告警对外接口(创建开放告警服务和应用),用于接收外部监控系统中的告警消息。

步骤一:创建开放告警服务和应用

  1. 登录日志服务控制台

  2. 进入开放告警管理页面。

    1. 在Project列表区域,单击任意一个Project。

    2. 在左侧导航栏中,单击告警

    3. 告警中心页面,选择其它 > 开放告警

  3. 创建开放告警服务。

    1. 单击创建

    2. 添加服务对话框中,配置开放告警服务的ID和名称,并单击保存

  4. 创建告警应用。

    1. 单击目标开放告警服务对应的应用

    2. 应用管理对话框中,单击创建

    3. 添加应用对话框中,配置如下参数,然后单击保存

      参数

      说明

      ID

      告警应用的ID。

      名称

      告警应用的名称。

      协议认证

      协议

      用于定义告警消息的格式,根据您要接入的第三方告警进行选择。

      告警策略

      告警策略用于合并和静默已产生的告警。

      • 选择极简模式普通模式时,您无需配置告警策略。日志服务默认使用SLS内置动态告警策略(sls.builtin.dynamic)进行告警管理。

      • 选择高级模式时,您可以选择内置的或自定义的告警策略进行告警管理。如何创建告警策略,请参见创建告警策略

      行动策略

      行动策略用于控制告警通知渠道和通知发送频率。

      • 告警策略选择为极简模式时,您只需配置行动组即可。

        您配置行动组后,日志服务自动为您创建一个名为规则名称-行动策略的行动策略。由该告警监控规则触发的所有告警都通过该行动策略发送通知。如何配置,请参见通知渠道说明

        重要

        您可以在行动策略管理页面,修改该行动策略。具体操作,请参见创建行动策略。如果您在修改行动策略时添加了判断条件,则此处的告警策略将自动变更为普通模式

      • 告警策略选择为普通模式高级模式时,您可以选择内置的或自定义的行动策略进行告警通知。如何创建行动策略,请参见创建行动策略

        其中,您选择告警策略选择为高级模式时,还可以开启或关闭自定义行动策略。更多信息,请参见动态行动策略机制

      重复等待

      在重复等待时间内,重复的告警只触发一次行动策略,即日志服务只发送一次告警通知。

      密钥ID白名单

      开启密钥ID白名单后,需添加阿里云访问密钥中的AccessKey ID。通过使用了该AccessKey ID的接口才能接入告警。

      例如您在此处配置AccessKey ID为AEDC****ERT,您在Prometheus中将path_prefix中的{ACCESS_KEY_ID}也配置为AEDC****ERT,则表示对应的告警消息可被接入到日志服务告警系统中。

      重要

      该访问密钥所属的RAM用户需具备AliyunLogPutOpenEventPolicy权限。更多信息,请参见附录:获取AccessKey ID

      请求过滤

      关键字检查

      配置告警关键字后,开放告警系统仅接收告警消息中包含其中任意一个告警关键字的告警。

      信息加工

      添加标签

      为告警消息添加标签信息,键值对格式。例如配置key为环境,value为预发环境。更多信息,请参见标签

      添加标注

      为告警消息添加标注信息,键值对格式。例如配置key为title,value为Prometheus告警。更多信息,请参见标注

      如果您选择协议阿里云云监控,则日志服务将根据控制台语言自动添加标注__user_language__ ,值可以为en(英文)或cn(中文)。

      重要

      此处配置的标注信息不支持使用模板变量。

步骤二:获取接口信息

您在Prometheus或Grafana端配置信息时,需使用该接口信息。

  1. 应用管理对话框中,单击目标应用对应的接口

  2. 接口信息对话框中,选择告警消息接入的地域。

    说明

    如果您的Prometheus或Grafana运行在阿里云ECS上,则建议您在选择告警消息接入的地域时,选择ECS所在地域,并使用局域网或VPC接口。否则您选择任一地域的公网接口即可。

  3. 将鼠标悬浮在文本框右侧的空白位置,复制完整URL、域名或子路径信息。

    其中,接口信息中的{ACCESS_KEY_ID}为阿里云访问密钥中的AccessKey ID,请根据实际情况替换。如何获取AccessKey ID,请参见附录:获取AccessKey ID

    接口信息

附录:获取AccessKey ID

为保证账号安全,强烈建议您使用RAM用户进行告警接入操作,不要直接使用阿里云账号。用于告警接入的RAM用户需具备AliyunLogPutOpenEventPolicy权限。具体操作如下:

  1. 创建RAM用户。具体操作,请参见创建RAM用户

  2. 授予RAM用户AliyunLogPutOpenEventPolicy权限。具体操作,请参见为RAM用户授权

  3. 为RAM用户创建访问密钥(AccessKey)。具体操作,请参见创建AccessKey

后续步骤