帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

通知列表

用户可以将一组手机号、邮箱和 webhook 保存到通知列表中,用以接收青云系统发送的通知。 目前监控告警功能使用了通知列表,在资源发生告警时第一时间将受监控的资源情况通知用户。

本指南将详细介绍如何新建和管理你的通知列表。

创建通知列表

每个青云账户(包括子账户)都可以创建、管理自己的通知列表。你可以在控制台左侧导 航拦中找到 “通知列表 (Notification Lists)”一项,点击即进入通知列表管理界面。

点击 “创建” 按钮,在弹出框中将需要添加的手机和邮箱逐项录入。通常可以按你的工作 人员组别列入不同的通知列表,例如建立开发团队、运维团队、产品团队等列表。如果在 创建告警策略时还没有一个通知列表,在添加告警行为时点击 “新列表”,也能弹出新建 通知列表的窗口完成创建。

注解

点击 “对勾” 图标添加一条手机号/邮箱后,会自动通过短信或邮件发出验证码。手机号和邮箱的验证可以后续完成,不影响通知列表的创建,但只有验证成功的手机号/邮箱才可以接受告警通知,相同的手机号/邮箱只需要验证一次,再次添加时无需验证。

创建通知列表

每个通知列表的手机和邮箱数量总和上限是20个。点击 “提交” 按钮,即可完成通知列表 的创建。

目前短信和邮件通知都是完全免费的,由于短信发送有成本,未来不排除短信收费的可能。如果有计费变动,我们会提前通知到您。

修改通知列表

你可以在通知列表界面修改通知列表的内容,点击 ID 号或 “修改” 按钮都可以弹出修改框。 与创建时一样,如果还没有达到总和上限,你可以继续往列表中添加手机号/邮箱。也可以 将通知列表中的手机号/邮箱从列表中移除。

修改通知列表

验证手机号和邮箱

每加入一条新手机/邮箱,系统会发送一条验证短信或验证邮件,以确保该工作人员同意加 入通知列表,并接收来自青云系统的通知短信。如果没有收到验证短信/邮件,或者过期未 验证,可以在修改通知列表时再次发送验证短信/邮件。

验证手机/邮箱

你可以在通知列表界面或修改弹出框中看到每个手机/邮箱是否已经验证,已经验证的手机 /邮箱,以后再加入本用户的通知列表,无需再次验证。

创建 Webhook

Webhook 可以让你的系统直接收到青云的通知。当监控告警发生时,青云系统会以 HTTP POST 的方式将通知信息发送到指定 URL ,你可以在这个 URL 的接收逻辑中自行处理通知信息。

每加入一条新的 Webhook URL 都需要先进行验证。验证方法是在 URL Response 中返回指定的 token ,一旦通过验证就无需再在 Response 中保留这个 token 。 每个 URL 对于同一个用户只需验证一次。

验证 webhook

添加完 URL 后会自动尝试验证一次,如果此时还没有修改好了对应 URL 的返回内容,那么可以在保存完通知列表后,再次展开并点击再次验证的按钮来触发验证。

验证 webhook

验证通过后,当监控告警发生时,URL 会收到来自青云主动推送的通知, 携带的参数如下

{
  "alarm_policy": "inst",                         # 监控告警策略名称
  "resource": {                                   # 资源信息
    "resource_id": "i-fsda5aiv",
    "resource_name": "",
    "resource_type": "instance"
  },
  "rules": {                                      # 监控告警规则列表
    "alpr-lr3gv19q": {
      "alarm_policy_id": "alp-7x97ldud",          # 监控告警策略 ID
      "alarm_policy_rule_id": "alpr-lr3gv19q",    # 告警规则 ID
      "alarm_policy_rule_name": "",               # 告警规则名称
      "condition_type": "gt",                     # 判断条件:gt (>), lt (

因为通知列表不仅用于监控告警,还可用于接收自动伸缩和定时器的通知, 而不同服务推送的 webhook 数据也不同,这里一并说明。

当自动伸缩触发通知时,webhook 携带的参数如下

{ “zone”: “beta”, “autoscaling_rules”: { # 自动伸缩规则属性 “autoscaling_policy_rule_id”: “aspr-96lss7vs”, “history_type”: “scale_success”, # 执行结果 “description”: “”, “scale_direction”: “decrease” # increase: 上调, decrease: 下调 }, “autoscaling_policy”: { # 自动伸缩策略属性 “autoscaling_policy_id”: “asp-36fcf6sb”, “resource”: { # 自动伸缩调整的资源 “resource_name”: “”, “eip_addr”: “192.168.7.88”, “resource_type”: “eip”, “resource_id”: “eip-5irjjfki” }, “description”: “”, “autoscaling_policy_name”: “”, “scale_type”: “eip_bandwidth” # 自动伸缩策略类型 } }


当定时器触发通知时,webhook 携带的参数如下

{ “tasks”: [{ # 定时器任务属性 “scheduler_task_id”: “st-jtwx7hqt”, “history_type”: “task_fail”, # 任务执行结果 “task_type”: “start_instances”, # 任务类型 “scheduler_task_name”: “” }], “scheduler”: { # 定时器属性 “scheduler_name”: u”scheduler”, “scheduler_id”: “schd-x0v8l9x9” }, “zone”: “beta” } ```