故障聚合¶
故障聚合用于将满足相同规则、具有相同聚合键值的事件归入同一条故障，减少同类事件集中触发时产生的大量重复故障。
在故障中心 > 配置管理 > 聚合规则中可配置聚合规则。
使用前提¶
故障聚合由工作空间总开关控制。开启总开关后，事件会按已启用的故障聚合规则处理；未命中任何已启用规则的事件不会再按原监控器关联故障方式创建故障。
注意
开启总开关前，请确认已创建并启用了能够覆盖目标事件范围的聚合规则。若没有启用规则，或事件不满足规则的过滤条件，该事件不会创建故障。
关闭总开关后，后续事件不再使用故障聚合规则；已经生成的聚合故障不会因此被删除或关闭。
配置故障聚合规则¶
- 在故障聚合页面开启总开关，并在确认窗口中确认；
- 点击新建聚合规则，填写规则名称；
- 设置事件过滤条件；
- 选择聚合键；
- 设置故障等级生成策略和故障内容展示规则；
- 保存并启用规则。
设置事件范围¶
事件范围仅通过过滤条件定义。只有满足过滤条件的事件才会参与该规则的故障聚合。
过滤条件的输入和匹配维度保持一致，可按事件字段筛选。例如，使用 service:trade-api AND env:prod 可将范围限制为生产环境的 trade-api 服务事件。
选择聚合键¶
聚合键用于确定哪些事件应归入同一条故障。系统根据"规则 + 聚合键值"识别同一组事件。
- 每条规则至少选择 1 个、最多选择 3 个聚合键；
- 只有聚合键均有有效值的事件才会参与聚合；
- 相同规则下，聚合键值相同的事件会归入同一条故障；
- 建议选择稳定且能代表故障对象的字段，例如
service、host、env；不要使用时间戳、请求 ID 等高基数字段，否则会产生大量独立故障。 例如，聚合键选择host和service后，同一主机且同一服务的事件会归入同一条故障。
设置故障等级生成策略¶
| 策略 | 说明 |
|---|---|
| 固定等级 | 为该规则选择一个固定故障等级，所有由该规则生成的故障均使用该等级。 |
| 历史最高等级 | 故障等级保持本次生命周期内出现过的最高等级，不因后续较低等级事件而降低。 |
| 实时等级变动 | 故障等级随最新关联事件的等级实时更新。 |
| 故障首次等级 | 故障创建时采用首次触发事件的等级，后续事件不再改变故障等级。 |
设置故障内容展示规则¶
| 规则 | 说明 |
|---|---|
| 按最新事件内容 | 使用最新关联事件的标题和描述更新故障内容。 |
| 按首次触发事件内容 | 始终保留首次触发事件的标题和描述。 |
| 自定义 | 使用配置的故障标题和描述模板生成内容，模板中可引用聚合键和事件字段。 |
自定义规则下，如未填写故障标题，系统会使用首次触发事件的事件标题。
聚合后的故障处理¶
当新事件命中某条启用规则且聚合键值与已有未恢复故障一致时，系统会将该事件关联到已有故障，而不是创建新的故障。关联事件发生恢复时，系统会同步处理对应聚合故障的恢复状态。
如果事件同时命中多条启用规则，系统会按每条命中的规则分别处理。建议避免创建过滤条件和聚合键完全重叠的规则，以免形成重复聚合结果。
与 Webhook 的关系¶
如 Webhook 勾选了聚合变更事件，聚合故障的关联事件发生变化时，系统会向第三方推送最新的故障和关联事件快照。