跳转至

通知对象管理


更新日志

2024.1.31:新增通知对象——简单 http 请求

2023.9.21邮件组类型正式下架,已创建的不受影响。后续使用管理 > 成员管理 > 团队功能代替。

观测云支持设置告警事件的通知对象,包括系统默认通知对象(钉钉机器人、企业微信机器人、飞书机器人、Webhook 自定义、短信组和简单 http 请求)和自建通知对象

关于如何设置告警通知,可参考 告警设置

默认通知对象

进入监控 > 通知对象管理 > 新建通知对象,选择钉钉机器人、企业微信机器人、飞书机器人、Webhook自定义、短信、简单 http 请求后,输入对应配置信息后,点击确认即可完成新建通知对象。

注意:钉钉机器人、企业微信机器人、飞书机器人告警通知是每分钟合并了发送,并不是产生后立刻发送,会存在约一分钟的延迟。

1、新建钉钉机器人

为了适配最新的钉钉机器人创建和使用模式,用户需先在钉钉开发平台创建企业内部应用机器人,创建完成后,登录观测云新建钉钉机器人。

可参考企业内部应用机器人的创建和安装

钉钉机器人新旧区别
  • 钉钉平台:创建机器人从群管理直接创建变更为在开发平台创建应用
  • 观测云:最新的钉钉机器人密钥配置为非必填项。

1)创建企业内部应用机器人

  • 申请钉钉开发平台开发者权限

  • 创建应用。

创建步骤:

步骤一:选择应用开发 > 钉钉应用 > 创建应用,单击创建应用。

步骤二:点击应用详情,在机器人配置页面填写相关配置后发布即可。

注意:此处使用机器人仅用于接收信息,不存在交互,消息接收模式配置可任意选择,HTTP 模式下地址可以为空。

步骤三:在目标群里点击添加机器人,在企业机器人列表中选择新创建的应用机器人,点击添加、完成。

步骤四:获取机器人 Webhook 地址,在机器人管理找到新创建的应用机器人,点击查看详情,复制 Webhook 地址。

2)登录观测云,配置钉钉机器人

进入监控 > 通知对象管理 > 新建通知对象,选择钉钉机器人,输入配置信息,包括自定义的通知对象名称、密钥和 Webhook 地址。

钉钉群组成功添加机器人之后,在机器人配置详情中可查询该机器人的加签密钥和 Webhook 地址。

2、新建企业微信机器人

选择企业微信机器人,输入配置信息,包括自定义的通知对象名称、Webhook 地址。

企业微信群组成功添加机器人之后,在机器人配置详情中可查询该机器人特有的 Webhook 地址

3、新建飞书机器人

选择飞书机器人,输入配置信息,包括自定义的通知对象名称、Webhook 地址和密钥。

飞书群组成功添加机器人之后,在机器人配置详情中可查询该机器人的签名校验Webhook 地址

4、新建 Webhook 自定义

选择 Webhook 自定义,输入所需信息。

Webhook 自定义通知类型为 HTTPRequest,会向指定的地址发送纯文本 POST 请求。

假设用户配置的地址为 [http://my-system/accept-webhook](http://my-system/accept-webhook),产生的告警标题和内容分别为:

标题:

您的 ECS 存在问题

内容:

您的 ECS 存在以下问题: 
- CPU 使用率过高(92%) 
- 内存使用率过高(81%)

发送的请求会根据所配置的请求类型不同而不同:

1)当 bodyType 不指定或为 text 时,请求详情如下:

POST http://my-system/accept-webhook
Content-Type: text/plain

您的 ECS 存在问题

您的 ECS 存在以下问题:
- CPU 使用率过高(92%)
- 内存使用率过高(81%)

其中,第 1 行为事件标题 df_title,第 2 行为空行,之后所有内容为事件内容 df_message

2)当 bodyTypejson 时,请求详情如下:

POST http://my-system/accept-webhook
Content-Type: application/json

{
    "timestamp"               : 1625638440,
    "df_status"               : "warning",
    "df_event_id"             : "event-xxxxxxxxxx",
    "df_title"                : "web001存在问题",
    "df_message"              : "web001存在问题\nCPU使用率大于90\n内存使用率大于90",
    "df_dimension_tags"       : "{\"host\":\"web001\"}",
    "df_monitor_id"           : "monitor_xxxxxxxxxx",
    "df_monitor_name"         : "异常检测名",
    "df_monitor_checker_id"   : "rul_xxxxxxxxxx",
    "df_monitor_checker_name" : "异常检测项目名",
    "df_monitor_checker_value": "99",
    "df_event_link"           : "https://console.guance.com/keyevents/monitorChart?xxxxxxxxxx"
    "df_workspace_uuid"       : "wksp_xxxxxxxxxx",
    "df_workspace_name"       : "我的工作空间",
    "Result"                  : 99,
    "...其他更多字段": "略",

    // 以下为旧版字段
    "date"          : 1625638440,
    "workspace_uuid": "wksp_xxxxxxxxxx",
    "workspace_name": "我的工作空间",
}

注意:在 Webhook 对外同步事件信息时,会同步追加工作空间属性声明

Webhook 自定义通知发送内容的类型仅支持使用 JSON 格式,各字段的详情可参考 事件产生

有关 Webhook 自定义更详细的实践文档,可参考 观测云 Webhook 自定义告警通知集成

5、新建短信

选择短信,输入所需信息。短信组可同时添加多个成员。

注意

  • 成员需要先在管理 > 成员管理中邀请加入到工作空间后才可选择;
  • 短信组告警通知是每分钟合并了发送,并不是产生后立刻发送,会存在约一分钟的延迟。

6、新建简单 HTTP 请求

选择简单 HTTP 请求,输入所需信息:

自建通知对象

观测云除提供默认通知对象外,还支持您通过第三方 Func 接入外部通知渠道形式,实现自建通知对象并对齐发送相关告警信息。

更多详情,可参考 对接自建通知对象

通知对象列表操作

成功添加通知对象后,可在监控 > 通知对象管理页面中进行查看。您可修改或删除特定通知对象。

文档评价

文档内容是否对您有帮助? ×