Keep 的告警映射富集功能提供了一种强大的机制,通过利用外部数据源(如 CSV 文件和拓扑数据)动态增强告警数据。此功能允许根据预定义属性(匹配器)将传入告警与 CSV 文件或拓扑数据中的特定记录进行匹配,并使用匹配记录中的附加信息富化这些告警。
简介
在复杂的监控环境中,用额外上下文富化告警数据对于有效的告警分析和响应至关重要。Keep 的告警映射和富集使用户能够定义规则,将告警与 CSV 文件或拓扑数据中的行进行匹配,并使用匹配行中的值附加或修改告警属性。这个过程为每个告警增加了重要价值,提供更深入的洞察并实现更精确和明智的决策。
工作原理
使用 CSV 文件进行映射
- 规则定义:用户定义映射规则,指定应使用哪些告警属性(匹配器)将告警与 CSV 文件中的行进行匹配。
- CSV 文件规范:每个映射规则关联一个 CSV 文件。该文件包含应添加到匹配规则的告警的附加数据。
- 告警匹配:当收到告警时,系统根据指定的匹配器检查其是否匹配任何映射规则的条件。
- 数据富化:如果找到匹配,则使用 CSV 文件相应行中的附加数据富化告警。
CVS 文件示例:
| region | responsible_team | severity_override |
|---|---|---|
| us-east-1 | team-alpha | high |
| us-west-2 | team-beta | medium |
| eu-central-1 | team-gamma | low |
使用拓扑数据进行映射
- 规则定义:用户定义映射规则,指定应使用哪些告警属性(匹配器)将告警与拓扑数据进行匹配。
- 拓扑数据规范:每个映射规则关联拓扑数据。此数据包含关于环境中组件及其关系的附加信息。
- 告警匹配:当收到告警时,系统根据指定的匹配器检查其是否匹配任何映射规则的条件。
- 数据富化:如果找到匹配,则使用相应拓扑数据中的附加数据富化告警。
实际示例
假设您有一个 CSV 文件,其列代表基础设施的不同方面,例如 region、responsible_team 和 severity_override。通过创建基于 service 和 region 匹配告警的映射规则,您可以自动使用负责的团队富化告警,并根据 CSV 文件中匹配的行调整严重程度。
同样,您可以使用拓扑数据来富化告警。例如,如果告警与特定服务相关,您可以使用拓扑数据来查找相关组件及其状态,从而提供更全面的问题视图。
核心概念
- 匹配器:告警中用于识别 CSV 文件或拓扑数据中匹配行的属性。常见匹配器包括
service或region等标识符。 - CSV 文件:包含数据行的结构化文件。每列代表可以添加到告警的潜在属性。
- 拓扑数据:关于环境中组件及其关系的信息。此数据可用于使用附加上下文富化告警。
- 富化:基于匹配 CSV 行或拓扑数据的数据向告警添加新属性或修改现有属性的过程。
创建映射规则
要创建告警映射和富集规则:
- 定义匹配器:指定将用于在 CSV 文件或拓扑数据中匹配行的告警属性。
- 指定数据源:提供要用于富化的 CSV 文件或指定拓扑数据。
- 配置规则:设置附加参数,例如规则是否应覆盖现有告警属性。
最佳实践
- 保持 CSV 文件和拓扑数据更新:定期更新 CSV 文件和拓扑数据以反映您基础设施和运营数据的当前状态。
- 使用特定匹配器:定义唯一且相关的匹配器以确保准确的匹配。
- 监控规则性能:审查映射规则的应用以确保它们按预期工作,并根据需要进行必要的调整。