Skip to content

关于本页

本页介绍更夫所基于的开源内核 Keep 的通用能力。更夫在其上提供国内化增强:钉钉/企业微信/飞书通知、国产大模型接入、LDAP 认证与值班管理。部署与上手请看快速上手。

Keep 的告警映射富集功能提供了一种强大的机制,通过利用外部数据源(如 CSV 文件和拓扑数据)动态增强告警数据。此功能允许根据预定义属性(匹配器)将传入告警与 CSV 文件或拓扑数据中的特定记录进行匹配,并使用匹配记录中的附加信息富化这些告警。

简介 ​

在复杂的监控环境中,用额外上下文富化告警数据对于有效的告警分析和响应至关重要。Keep 的告警映射和富集使用户能够定义规则,将告警与 CSV 文件或拓扑数据中的行进行匹配,并使用匹配行中的值附加或修改告警属性。这个过程为每个告警增加了重要价值,提供更深入的洞察并实现更精确和明智的决策。

工作原理 ​

使用 CSV 文件进行映射 ​

  1. 规则定义:用户定义映射规则,指定应使用哪些告警属性(匹配器)将告警与 CSV 文件中的行进行匹配。
  2. CSV 文件规范:每个映射规则关联一个 CSV 文件。该文件包含应添加到匹配规则的告警的附加数据。
  3. 告警匹配:当收到告警时,系统根据指定的匹配器检查其是否匹配任何映射规则的条件。
  4. 数据富化:如果找到匹配,则使用 CSV 文件相应行中的附加数据富化告警。

CVS 文件示例:

regionresponsible_teamseverity_override
us-east-1team-alphahigh
us-west-2team-betamedium
eu-central-1team-gammalow

使用拓扑数据进行映射 ​

  1. 规则定义:用户定义映射规则,指定应使用哪些告警属性(匹配器)将告警与拓扑数据进行匹配。
  2. 拓扑数据规范:每个映射规则关联拓扑数据。此数据包含关于环境中组件及其关系的附加信息。
  3. 告警匹配:当收到告警时,系统根据指定的匹配器检查其是否匹配任何映射规则的条件。
  4. 数据富化:如果找到匹配,则使用相应拓扑数据中的附加数据富化告警。

实际示例 ​

假设您有一个 CSV 文件,其列代表基础设施的不同方面,例如 region、responsible_team 和 severity_override。通过创建基于 service 和 region 匹配告警的映射规则,您可以自动使用负责的团队富化告警,并根据 CSV 文件中匹配的行调整严重程度。

同样,您可以使用拓扑数据来富化告警。例如,如果告警与特定服务相关,您可以使用拓扑数据来查找相关组件及其状态,从而提供更全面的问题视图。

核心概念 ​

  • 匹配器:告警中用于识别 CSV 文件或拓扑数据中匹配行的属性。常见匹配器包括 service 或 region 等标识符。
  • CSV 文件:包含数据行的结构化文件。每列代表可以添加到告警的潜在属性。
  • 拓扑数据:关于环境中组件及其关系的信息。此数据可用于使用附加上下文富化告警。
  • 富化:基于匹配 CSV 行或拓扑数据的数据向告警添加新属性或修改现有属性的过程。

创建映射规则 ​

要创建告警映射和富集规则:

  1. 定义匹配器:指定将用于在 CSV 文件或拓扑数据中匹配行的告警属性。
  2. 指定数据源:提供要用于富化的 CSV 文件或指定拓扑数据。
  3. 配置规则:设置附加参数,例如规则是否应覆盖现有告警属性。

最佳实践 ​

  • 保持 CSV 文件和拓扑数据更新:定期更新 CSV 文件和拓扑数据以反映您基础设施和运营数据的当前状态。
  • 使用特定匹配器:定义唯一且相关的匹配器以确保准确的匹配。
  • 监控规则性能:审查映射规则的应用以确保它们按预期工作,并根据需要进行必要的调整。

基于 MIT 协议开源的 Keep · 由更夫社区维护