跳转至

通知对象管理


更新日志

2024.6.26:新增编辑和删除通知对象的权限配置。

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

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

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

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

默认通知对象

进入监控 > 通知对象管理,选择通知对象后,输入对应配置信息,点击确认即可完成创建。

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

配置 Webhook

钉钉机器人

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

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

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

创建企业内部应用机器人

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

  • 创建应用:

选择应用开发 > 钉钉应用 > 创建应用,单击创建应用。

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

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

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

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

回到钉钉机器人配置页面

输入配置信息,包括自定义的通知对象名称、密钥和 Webhook 地址。

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

企业微信机器人

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

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

飞书机器人

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

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

Webhook 自定义

选择 Webhook 自定义,输入名称、Webhook 地址和成员等信息。

最终对外发送的 Webhook 事件通知包含以下内容:

事件信息:

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 通知对象规则生效后,Webhook 除了会传递上面两种事件信息外,还会将当前配置内输入的成员信息一同对外发送,以便利后续第三方接收到后可以根据成员信息做不同的规则操作。

此处可选成员包含当前工作空间内的所有团队和工作空间成员:

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

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

短信

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

注意

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

简单 HTTP 请求

选择简单 HTTP 请求,输入所需信息,当产生的事件触发告警时,服务会向自定义的 Webhook 地址发送事件所有的告警通知。

配置操作权限

新建通知对象时,您可以按需为当前工作空间内的角色、团队及空间成员配置通知对象操作权限。

  • 不开启该配置:跟随【通知对象配置管理】的默认权限
  • 开启该配置并选定自定义权限对象:此刻仅创建人和被赋予权限的对象可对该条通知对象设置的规则进行编辑、删除操作;
  • 开启该配置,但并未选定自定义权限对象:则仅创建人拥有此通知对象的编辑、删除权限。

注意:当前工作空间的 owner 角色不受此处操作权限配置影响。

自建通知对象

为进一步满足您实际业务的需要,除官方提供的默认通知对象外,观测云还支持您通过第三方 Func 接入外部通知渠道的形式,将告警信息直接通知到本地 DataFlux Func。

具体操作步骤,可参考 对接自建通知对象

通知对象列表操作

成功添加的通知对象均可在监控 > 通知对象管理页面中进行查看。

您可按需针对特定通知对象进行修改或删除操作。

若通知对象规则未赋予您权限,则无法编辑或删除:

文档评价

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