Skip to main content

操作步骤

创建飞书机器人兼容集成

您可通过以下 2 种方式,获取一个飞书机器人兼容集成地址,任选其一即可。

使用专属集成

如果您只需将告警发往一个协作空间,选择此方式,配置更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增一个集成
  3. 选择 飞书机器人兼容 集成,点击 保存,生成卡片。
  4. 点击生成的卡片,可以查看到 飞书机器人兼容集成地址,复制备用,完成。

使用共享集成

如果您需要根据告警事件的 Payload 将告警路由到不同协作空间,选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 飞书机器人兼容 集成:
    • 集成名称:为当前集成定义一个名称。
    • 消息类型:选择飞书告警消息类型,目前仅支持文本(Text)、富文本(Post)。
    • 推送模式:选择飞书告警在何种情况下触发或恢复告警。
  3. 复制当前页面的 飞书机器人兼容集成地址 备用。
  4. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则

定制飞书机器人兼容集成

飞书机器人兼容集成地址

系统会帮您生成一个唯一的飞书机器人兼容集成地址,该地址兼容飞书机器人消息的协议,在有的平台仅支持飞书机器人通道时,您可以使用该地址来接收对应的消息。

推送模式

默认系统总是为每一条消息创建新的告警,但您可以切换模式为:
  1. 根据消息标题触发或更新告警:该模式下,每当接收到新消息,系统会根据消息标题查找未关闭告警。如果找到告警则进行更新,否则系统会触发一条新的告警。
  2. 根据规则触发或关闭告警:该模式下,每当接收到新消息,系统会根据您的规则进行消息匹配,匹配到的消息按照规则去触发新告警或关闭已有告警。
    • 您至少需要填写一条触发规则;
    • 您必须设置 Alert Key 的正则提取规则。系统使用该字段来查找历史告警,以便对其进行更新或关闭;如果正则提取失败,系统将使用消息标题来生成 Alert Key,以确保告警不会因为配置错误而丢失;
    • 您可以选择,当所有的规则都不匹配时,是否丢弃消息。
    配置示例:
    • 接收所有消息,当消息内容中包含 RESOVED 字样时,关闭告警,否则触发新告警;
    • Alert Key 从消息标题中提取,规则为 /(.*)/。

注意事项

  • 飞书机器人兼容集成地址仅支持接收文本(text)和富文本(post)两种消息类型,其他类型的消息无法接收。
  • 当飞书消息类型是 Text 时,Flashduty On-call 会生成默认告警标题 “飞书告警”。

严重程度映射关系

当前飞书机器人兼容集成推送到 Flashduty 的严重程度均为 Warning,但您可以通过告警处理 Pipeline 来自定义严重程度。

阿里云账号消息中心

阿里云账号消息中心的”机器人接收”支持将账户、产品、安全等通知推送到自定义 Webhook,其数据格式可以复用飞书机器人协议,能直接对接本页的飞书机器人兼容集成。
  1. 登录阿里云 消息中心,进入 机器人接收管理 → 机器人管理 → 添加机器人
  2. 机器人平台 选择 自定义,Webhook 地址 填写上文的 飞书机器人兼容集成地址,数据格式 选择 格式 B(典型应用飞书)
  3. 完成验证码校验,保存
消息中心推送的通知都是一次性的,没有配套的恢复消息。请参考上文”推送模式”,配置 根据消息标题触发或更新告警 或 根据规则触发或关闭告警,避免告警无法自动关闭。
如果您要接入的是阿里云云监控(CloudMonitor)的告警,建议直接使用 阿里云监控 CM 指标集成,可以获得完整的去重与恢复能力。