Aggregate Exporter 镜像文档

概述和主要用途

Aggregate Exporter是一款用于聚合多个指标导出器（exporter）的工具，能够将多个独立的指标端点（如Prometheus exporter的/metrics页面）整合到单个页面，从而减少需要暴露的端点数量。

注意：该工具并不对指标进行实际聚合计算（如求和、平均值等），其名称可能存在误导。实际上，它通过为每个目标指标添加来源标签，以在聚合视图中区分不同来源的指标，避免重复。

核心功能和特性

• 多目标聚合：支持同时聚合多个指标端点，通过单个页面统一提供所有目标的指标数据
• 来源标签机制：默认自动为指标添加来源标签（默认标签名ae_source），清晰标识指标来自哪个目标
• 自定义标签配置：支持自定义标签名称及标签值，满足不同场景下的指标区分需求
• 超时控制：可配置目标指标页面的抓取超时时间，防止单个目标无响应影响整体服务
• 详细日志输出：支持启用verbose模式输出更多运行信息，便于调试和问题排查
• 版本查看：提供版本查看功能，方便快速确认当前工具版本

使用场景和适用范围

适用于需要集中管理多个Prometheus exporter指标端点的场景，例如：

• 监控系统中部署了多个独立的exporter（如node-exporter、cadvisor、应用自定义exporter等），希望通过单个端点统一访问所有指标
• 需要区分不同来源指标，避免因指标名称相同导致的数据冲突
• 简化监控系统配置，减少Prometheus等工具的抓取目标数量

详细使用方法和配置说明

配置参数说明

以下是工具的主要配置参数，支持通过命令行参数或环境变量进行配置：

Docker部署示例

基本运行

使用Docker运行Aggregate Exporter，聚合单个目标指标：

docker run -it -p 8080:8080 -e TARGETS="http://localhost:3000/metrics" warmans/aggregate-exporter:latest

聚合多个目标

聚合多个目标，并自定义绑定端口和超时时间：

docker run -it -p 8081:8081 \
  -e SERVER_BIND=":8081" \
  -e TARGETS="[***]" \
  -e TARGETS_SCRAPE_TIMEOUT=2000 \
  warmans/aggregate-exporter:latest

自定义标签名称和值

为不同目标设置自定义标签值和标签名称，便于区分来源：

docker run -it -p 8080:8080 \
  -e TARGETS="node=[***]" \
  -e TARGETS_LABEL_NAME="metrics_source" \
  warmans/aggregate-exporter:latest

此时指标将包含类似metrics_source="node"或metrics_source="container"的标签。

处理包含=字符的目标URL

若目标URL中包含=字符（如Consul的指标端点/v1/agent/metrics?format=prometheus），必须使用自定义标签格式：

docker run -it -p 8080:8080 \
  -e TARGETS="consul=http://localhost:8500/v1/agent/metrics?format=prometheus" \
  warmans/aggregate-exporter:latest

高级使用说明

禁用来源标签

若不需要为指标添加来源标签（如确认所有目标指标名称唯一），可通过TARGETS_LABEL=false禁用：

docker run -it -p 8080:8080 \
  -e TARGETS="http://localhost:3000/metrics" \
  -e TARGETS_LABEL=false \
  warmans/aggregate-exporter:latest

启用详细日志

通过VERBOSE=true启用详细日志，便于调试目标抓取问题：

docker run -it -p 8080:8080 \
  -e TARGETS="http://localhost:3000/metrics" \
  -e VERBOSE=true \
  warmans/aggregate-exporter:latest