karma

概述和主要用途

karma是Prometheus Alertmanager的告警仪表盘。Alertmanager UI虽可用于浏览告警和管理静默，但作为仪表盘工具存在不足，karma旨在填补这一空白。从0.7.0版本开始，它还能聚合多个Alertmanager实例（无论是HA模式还是独立运行）的告警，对重复告警进行去重，仅显示唯一告警。每个告警会标记其来自的所有Alertmanager实例名称，并可基于这些标签（@alertmanager）进行筛选（仅当配置多个Alertmanager实例时可见）。

!截图

告警按Alertmanager中group_by配置选项分组展示。如果一个组包含多个告警，仅显示前几个，其余可通过-/+按钮展开或隐藏。默认告警数量可在UI设置模块中配置。每个单独的告警仅显示唯一的标签和注解，所有告警共享的标签和注解将移至页脚。示例：

!示例

每个组可使用右上角的切换图标折叠为仅显示标题栏。

在线演示

若要获取karma新版本通知，可订阅GitHub提供的RSS feed [***]

核心功能和特性

• 多实例聚合：支持从多个Alertmanager实例收集告警，适用于HA模式或独立部署场景。
• 告警去重：自动识别并移除重复告警，仅展示唯一告警内容。
• 分组展示：严格遵循Alertmanager的group_by配置，按规则分组展示告警。
• 智能信息展示：组内共享标签和注解移至页脚，单个告警仅显示独特信息，提升可读性。
• 实例标签筛选：通过@alertmanager标签筛选不同来源实例的告警（多实例配置时可用）。
• UI可配置：支持自定义默认展示告警数量等界面参数。

历史

karma由作者在Cloudflare工作期间创建，最初名为unsee。该项目基于原代码重构，使用React从零重写UI层，后端API也进行了不兼容变更。由于React重写导致约50%的代码更新，且原项目已停止维护，为避免用户混淆，正式更名为karma。

支持的Alertmanager版本

Alertmanager的API尚未稳定，不同版本间可能存在差异。支持的所有版本列表参见internal/mock/Makefile中的VERSIONS。受API差异影响，部分功能可能表现不同或缺失，建议使用最新支持的Alertmanager版本。

安全

karma进程不会向Alertmanager发送修改告警或静默状态的API请求，但Web界面允许用户直接向Alertmanager API发送此类请求。若部署为只读工具，需确保：

• karma进程可连接Alertmanager API
• 只读用户可访问karma Web界面
• 只读用户无法直接连接Alertmanager API

指标

karma进程指标默认通过/metrics路径暴露。若设置--listen.prefix选项，则使用相对于该前缀的路径。

构建和运行

从源码构建

克隆仓库并构建二进制文件：

bash
git clone [***] $GOPATH/src/github.com/prymitive/karma
cd $GOPATH/src/github.com/prymitive/karma

编译karma：

bash
make

注意：本地构建需依赖Go、nodejs和yarn环境。

运行

支持通过配置文件、命令行标志或环境变量配置。单实例场景推荐使用环境变量或命令行标志：

bash
# 环境变量方式
ALERTMANAGER_URI=[***] karma

# 命令行标志方式
karma --alertmanager.uri [***]

使用make目标快速运行（默认监听8080端口，使用模拟数据）：

bash
make run

# 自定义端口和Alertmanager地址
make PORT=5000 ALERTMANAGER_URI=[***] run

Docker

运行预构建镜像

***镜像托管于hub.docker.com，自动构建标签包括：

• 发布版本：lmierzwa/karma:vX.Y.Z（对应git标签）
• 开发版本：lmierzwa/karma:latest（对应master分支最新提交）

示例

启动发布版本：

bash
docker run -e ALERTMANAGER_URI=[***] lmierzwa/karma:vX.Y.Z

启动开发版本（不推荐生产环境）：

bash
docker run -e ALERTMANAGER_URI=[***] lmierzwa/karma:latest

构建Docker镜像

bash
make docker-image

运行本地构建镜像

bash
make run-docker

# 自定义配置
make PORT=5000 ALERTMANAGER_URI=[***] run-docker

配置

完整配置选项参见CONFIGURATION，配置文件示例参见example.yaml。

贡献

详情参见CONTRIBUTING。

许可证

Apache License 2.0，详见LICENSE。