跳转到主要内容
版本要求:基础标签增强需要 On-call 标准版及以上订阅,高级标签增强(如 API 映射)需要专业版及以上。了解更多

核心用途

标签贯穿告警处理全流程:故障列表按标签筛选,路由规则按标签分发到协作空间,分派策略按标签匹配,降噪按标签聚合,静默与抑制按标签匹配。标签增强让这些环节可以用上源数据里没有直接提供的信息。

配置标签增强

  1. 进入 集成中心 → 告警事件,在右侧集成列表中打开您的集成,选择 标签增强。
  2. 首次配置时点击 添加;已有规则时点击 编辑。
  3. 在编辑器中点击 添加标签规则,填写规则并预览效果,点击 保存 后生效。
删除全部规则并保存,即可关闭该集成的标签增强(对告警事件和变更事件均生效)。重新配置时,点击 添加 进入编辑器。

增强类型

标签增强类型

映射方式

源标签的值不固定或含义不直观时,可以用映射把它转换为新的标签和值。添加映射规则时,可选择 元数据表 或 API 两种方式:

配置选项

多条规则从上到下依次执行。规则不匹配时跳过,不会生成对应标签。

预览规则

编辑器右侧的 预览 卡片用一条原始事件跑当前规则,未保存的改动也参与,结果分两块:一张标签表,加上 这条事件的执行过程。
  • 标签表列出预览后的全部标签:新增的标签前带 +,被修改的标签显示原值 → 新值,被删除的标签加删除线。每处变化注明是哪条规则造成的(规则 N 新增 / 规则 N 修改 / 规则 N 删除),该生成却没生成的标签标注 未生成(规则 N 未匹配)。
  • 这条事件的执行过程 每条规则一行,写明它生成了哪些标签,或没生效的原因。左侧规则卡头上同时标记 本条生效 / 本条未匹配 / 本条跳过 / 本条出错。
事件来源在 最近事件 和 自定义 之间切换。最近事件 从该集成收到的原始事件里挑一条(每个集成保留最近 20 条,7 天过期,每 10 秒最多记录 1 条);要预览的事件不在列表里时,切到 自定义 粘贴一条事件 JSON。预览跑的就是编辑器里的内容,最近事件 模式下改过的地方会标出来,也可以一键还原。 映射规则还会在规则内显示它在映射表里命中的那一行,匹配列标注 (匹配列),新生成的标签标绿并汇总成一句 这条原始事件在表里找到 1 行,新增 …。取值正则和模板编辑器里的示例值也取自这条事件。 规则没生效时,预览给出的就是原因: 一次最多预览 50 条规则。映射类型为 API 的规则会让预览真实调用您的映射服务,因此需要该集成的编辑权限;没有编辑权限时提示 映射 API 规则预览需要编辑权限,页面其余部分照常可用。

限制条件字段

标签增强规则对告警事件和变更事件统一生效,限制条件中可使用的字段为两者的并集:
条件字段在保存规则时校验:使用以上词汇表之外的字段(例如拼写错误,或属于其他规则类型的字段如 incident_severity、dedup_key)会导致保存失败并提示错误。

配置示例

场景:告警事件来自邮件集成,需要从描述信息中提取关键信息作为标签应用到其他场景,比如将描述信息中的 IP 和触发值提取为独立的标签。
1

查看告警原文

告警原文
2

配置提取规则

提取规则配置
3

验证提取效果

提取效果

映射数据管理

每个账户最多可创建 20 个映射表和 50 个映射服务(API),每个映射表默认最多 10000 条数据,超出限制时创建或上传将失败并提示数量超限。

映射表数据管理

在映射表详情页面中,可以对映射表数据进行管理:
映射表数据管理
映射表仍被引用时不能删除。删除会被拒绝并提示 删除失败,资源正在使用中,下面按类型列出仍在引用它的对象,点击可直接打开对应配置:
  • 集成:标签增强规则里选用了这张映射表
  • 分派策略、值班表:通知的机器人打开了 开启 @ 提醒,并把这张表作为 用户信息映射表。关闭这个开关后所选映射表会保留,仍然算引用
先解除这些引用(换一张表、清空映射表选择,或删掉该机器人)再删除映射表。
对于频繁变更的映射关系(如从 CMDB 同步的数据),建议使用 API 映射方式,或通过 Flashduty API 自动化更新映射表数据。

映射服务的 API 规范

自建映射服务的请求体、响应格式、禁用 Header 和实现建议,见 标签映射 API。

延伸阅读

配置分派策略

使用标签匹配分派条件

配置告警降噪

使用标签作为聚合维度

配置过滤条件

了解标签匹配语法

配置路由规则

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