labbsr0x/bb-promster

Big Brother Promster

https://img.shields.io/docker/pulls/labbsr0x/bb-promster.svg](https://hub.docker.com/r/labbsr0x/bb-promster)

镜像概述

本项目定义了自定义 https://github.com/flaviostutz/promster 镜像，用于适配 https://github.com/labbsr0x/big-brother 项目的特定监控指标，帮助用户快速搭建标准化的应用监控体系。

核心功能

1. 自动服务发现: 通过ETCD集群自动识别待监控的服务实例，无需手动配置目标。
2. 标准化指标采集: 支持采集Big Brother定义的核心指标（如请求耗时、响应大小、依赖可用性等）。
3. 联邦扩展: 利用Prometheus联邦特性实现监控集群的水平扩展，应对大规模指标负载。
4. 动态告警规则: 基于ETCD中注册的版本信息（prod/pilot）加载告警模板，支持版本间对比告警。

使用场景

适用于微服务或分布式应用的监控场景，尤其适合采用Big Brother生态的团队，可快速实现指标采集、存储（如Cortex）与可视化（如Grafana）的全链路监控。

配置说明

必选配置项

1. BB_PROMSTER_LEVEL: 监控层级（1级直接采集服务指标，2级及以上用于联邦聚合）。
2. ETCD_URLS: ETCD集群地址，用于服务发现。
3. REGISTRY_ETCD_BASE: ETCD中监控组件的分组基础路径。
4. REGISTRY_SERVICE: 待监控服务名称（需与ETCD记录一致）。
5. SCRAPE_ETCD_PATH: 1级实例查找目标IP的ETCD路径（仅1级必填）。

多ETCD场景配置

若需分离Promster与服务实例的注册集群，留空ETCD_URLS并配置：

• REGISTRY_ETCD_URL: Promster实例注册的ETCD地址。
• SCRAPE_ETCD_URL: 服务实例注册的ETCD地址。

可选配置项

• TLS_INSECURE: 是否忽略TLS验证（布尔值）。
• SCHEME: 采集协议（http/https，默认http）。
• SCRAPE_PATHS: 指标暴露路径（默认/metrics）。
• CLEAR_RR: 是否清除默认记录规则（布尔值）。
• ALERT_MANAGER_URLS: 告警管理器地址（仅1级实例生效）。

告警规则模板加载

1. 设置ALERT_RULES_FILE为/etc/prometheus/comparative-alerts.yml。
2. 在alert_rules目录创建alert-rules.yml.tmpl模板（支持.PilotVersion/.ProdVersion变量）。
3. 在ETCD注册版本信息：etcdctl put /versions/$REGISTRY_SERVICE/prod_version/v0001。

部署示例

Docker Compose快速启动

bash
docker-compose up

示例包含ETCD集群、指标生成服务、1级/2级Promster实例，可测试服务扩展与联邦功能。

Cortex集成示例

1. 启动Cassandra：

bash
docker run -d --name cassandra --rm -p 9042:9042 docker.xuanyuan.run/cassandra:3.11

2. 创建Cortex键空间：

bash
docker exec -it cassandra cqlsh -e "CREATE KEYSPACE cortex WITH replication = {'class':'SimpleStrategy', 'replication_factor':1};"

3. 启动Cortex集群（进入cortex目录）：

bash
docker-compose up -d

4. Grafana配置：添加Cortex数据源（http://cortex1:9009/api/prom），导入仪表盘ID 11544。

关于Big Brother

本镜像属于 https://github.com/labbsr0x/big-brother 项目生态，旨在提供开箱即用的分布式应用监控解决方案。