跳转到主要内容
告警处理 Pipeline 允许您在告警数据进入 Flashduty On-call 的第一时间(集成层),对其进行清洗、转换和过滤。经过处理后,流入协作空间的告警格式规范、内容清晰。

处理顺序

告警事件进入 Flashduty 后,依次经过三个阶段: 由于标签增强在 Pipeline 之前执行,Pipeline 的匹配条件可以引用增强阶段新增或修改的标签。
恢复事件(event_status 为 Ok)不经过告警处理 Pipeline,直接进入告警合并流程。因此,Pipeline 中配置的丢弃、抑制、重写等规则不会对恢复事件生效。
事件经过 Pipeline 后,能否合入已有告警,由目标协作空间的 事件聚合 配置决定(默认 24 小时窗口,可关闭或自定义为 1–1440 分钟)。详见告警降噪 - 事件聚合。

工作原理

Pipeline 位于 标签增强 和 路由分发 之间。它的执行逻辑如下:
  1. 链式处理:您可以配置多个处理规则,系统按照从上到下的顺序依次执行
  2. 输入输出:上一个规则处理后的结果(如修改了标题),可以作为下一个规则的输入
  3. 层级定位:Pipeline 作用于 集成层。这意味着规则一旦生效,所有通过该集成接入的告警都会受影响,无论它最终被路由到哪个协作空间
告警处理工作原理

配置入口

  1. 进入 集成中心 → 告警事件,在右侧集成列表中打开已创建的集成,选择 告警处理。
  2. 首次配置时点击 添加;已有规则时点击 编辑。
  3. 在编辑器中点击 添加处理规则,填写规则并预览效果,点击 保存 后生效。
告警处理配置入口
删除全部处理规则并保存,即可关闭该集成的告警处理。重新配置时,点击 添加 进入编辑器。

核心功能与场景

严重程度自定义

Flashduty On-call 已经为标准集成内置了等级映射(例如将 Zabbix High 映射为 Critical)。但如果默认规则不满足您的需求,您可以通过 Pipeline 进行覆盖。 场景:监控系统中的 Warning 级别告警,对于核心支付业务来说实际上是致命的,需要升级为 Critical 以触发电话通知。

信息重写

通过模板语法,将晦涩难懂的机器语言转换为人类可读的业务语言。
场景:原始标题包含大量 ID,缺乏业务含义。

告警丢弃

命中的告警直接丢弃:不产生告警,也不进入任何协作空间。这与协作空间的”排除规则”类似,但生效位置更靠前。

告警抑制

Pipeline 中的抑制功能与协作空间的抑制规则类似,都支持基于源告警、目标告警和关联条件的依赖抑制。需要注意的是,Pipeline 抑制仅在同一集成的告警范围内匹配源告警,而协作空间抑制则在整个空间的告警范围内匹配。
当整个机房断网时,该机房下的所有告警(无论属于哪个业务线)都应该被抑制。此时在集成层配置一条规则,比在几十个协作空间里分别配置要高效得多。
抑制功能仅匹配最近 10 分钟(600 秒)内仍处于活跃状态的源告警。如果源告警在 10 分钟前已触发且未更新,则不会被用于抑制匹配。请确保您的源告警在此时间窗口内持续活跃。

规则预览

告警处理 页签的右栏是一张常驻的 预览 卡片:它用一条原始事件跑编辑区里当前的规则(未保存的修改也算),实时显示每条规则做了什么、事件处理前后差在哪。还没有处理规则时,页签先显示 未配置告警处理 空态和 添加 按钮。

预览事件来源

最近事件 只保留每个集成最近 20 条原始事件:每 10 秒最多采集 1 条,7 天后过期,且只保留该功能上线之后收到的事件。要预览的事件不在列表里,切到 自定义。 自定义 至少要有 title 或 title_rule、event_status(Critical / Warning / Info / Ok)和 labels,其他字段可省略;点 插入示例 可以填入一条示例事件。 两种来源共用同一个 事件 JSON 编辑器。最近事件 模式下改动过的行会被标出,可点 还原 回到原文;换另一条事件前会确认是否放弃修改。JSON 写错时提示出错的行、列和原因,上一次的预览结果保留,改好后自动重跑。

预览的执行顺序

预览按真实接入的顺序执行:先跑该集成已保存的 标签增强,再从上到下跑编辑区里的处理规则。对照表左列 处理前(标签增强之后) 是运行处理规则前的事件,右列 处理后 是运行规则后的结果;保留的事件会以处理后的内容继续路由。对照的字段是 标题、描述、严重程度、标签。样例只保留描述的前 8 KB。

结果怎么看

一句话结论说明这条事件最后会怎样: 每条规则的结果显示在规则卡标题旁: 右栏的 这条事件的执行过程 把结果按规则顺序逐条列出。规则没填完整时,从那条起不参与预览,这里显示 未预览:这条或前面的规则还没填完整;一次最多预览 50 条规则,超过时提示先删掉一些规则。预览请求失败时,卡片显示 预览失败 和原因。 写标题或描述的模板时,输入框下方会直接显示模板在这条事件上渲染出的结果(→ 后面),变量提示里的标签也是标签增强之后的。
首次配置规则时,在 最近事件 里选一条真实事件,边改边看对照,不必保存后再等一条真实告警来验证。

引用语法说明

重写标题或描述时,在内容前加 [TPL] 前缀,再用 {{ }} 引用告警的标签和属性。更多写法见 引用变量。

延伸阅读

配置标签增强

动态生成或修改告警标签

配置过滤条件

了解条件匹配语法

配置路由规则

将告警分发到不同协作空间

配置降噪策略

在协作空间层面抑制告警