跳转到主要内容

操作步骤


创建飞书告警集成

您可通过以下2种方式,获取一个飞书告警集成地址,任选其一即可。

使用专属集成

当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,进入某个空间的详情页面
  2. 选择 集成数据 tab,点击 添加一个集成,进入添加集成页面
  3. 选择 飞书告警 集成,点击 保存,生成卡片。
  4. 点击生成的卡片,可以查看到 飞书告警集成地址,复制备用,完成。

使用共享集成

当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心=>告警事件,进入集成选择页面。
  2. 选择 飞书告警 集成:
    • 集成名称:为当前集成定义一个名称。
    • 消息类型:选择飞书告警消息类型,目前仅支持 Text、Markdown。
    • 推送模式:选择飞书告警在何种情况下触发或恢复告警。
  3. 复制当前页面的 飞书告警集成地址 备用。
  4. 配置默认路由,并选择对应的协作空间(集成创建后可以前往 路由 进行更多路由规则的配置)。
  5. 完成。

定制飞书告警集成

飞书告警集成地址

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

推送模式

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

注意事项

  • 飞书告警集成地址仅支持接收文本、富文本中 text 和 markdown 的消息类型,其他消息无法接收。
  • 当飞书消息类型是Text 时,Flashduty On-call 会生成默认告警标题 “飞书告警”。

严重程度映射关系


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