mpolednik/exporter-merger

exporter-merger

![Build Status]([***]

合并来自多个来源的Prometheus指标。

开发状态 exporter-merger 处于早期开发阶段，可能随时发生不兼容变更或停止维护。

核心功能

• 支持动态端点发现（通过Docker SDK识别容器）
• 支持静态端点配置（通过YAML文件指定指标URL）
• 可通过环境变量或命令行参数配置
• 可作为Kubernetes Sidecar运行

使用场景

• Prometheus监控中需要统一收集多来源指标的场景
• 容器化环境下动态获取容器指标的需求
• 简化多exporter的Prometheus配置

配置说明

动态端点发现（Docker）

需挂载/var/run/docker.sock，通过环境变量配置：

yaml
environment:
- MERGER_LABEL=traefik.frontend.rule
- MERGER_LABEL_CONFIG=/metrics:8080:Host:my-container /metrics:8080:Host:my-container2

静态端点配置

创建YAML配置文件（如merger.yaml）：

yaml
exporters:
- url: http://localhost:9100/metrics
- url: http://localhost:9101/metrics

启动命令：

bash
exporter-merger --config-path merger.yaml --listen-port 8080

环境变量配置

关键环境变量：

• MERGER_PORT: 监听端口（默认8080）
• MERGER_URLS: 空格分隔的指标URL列表
• MERGER_LABEL: 用于动态发现的容器标签
• MERGER_LABELS: 空格分隔的端口:路径:标签元组

Kubernetes部署示例

作为Sidecar与nginx-exporter配合：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
  labels:
    app: my-nginx
spec:
  selector:
    matchLabels:
      app: my-nginx
  template:
    metadata:
      labels:
        app: my-nginx
      annotations:
        prometheus.io/scrape: "true"
        prometheus.io/port: "8080"
    spec:
      containers:
      - name: nginx
        image: my-nginx
        volumeMounts:
        - name: mtail
          mountPath: /var/log/nginx/mtail
      - name: nginx-exporter
        image: quay.io/rebuy/nginx-exporter:v1.1.0
        ports:
        - containerPort: 9397
        env:
        - name: NGINX_ACCESS_LOGS
          value: /var/log/nginx/mtail/access.log
        - name: NGINX_STATUS_URI
          value: http://localhost:8888/nginx_status
        volumeMounts:
        - name: mtail
          mountPath: /var/log/nginx/mtail
      - name: exporter-merger
        image: quay.io/rebuy/exporter-merger:v0.2.0
        ports:
        - containerPort: 8080
        env:
        - name: MERGER_URLS
          value: http://localhost:9000/prometheus/metrics http://localhost:9397/metrics
      volumes:
      - name: mtail
        emptyDir: {}

计划功能

• 支持指标转换（添加前缀、标签）
• 支持动态添加exporter
• 优化指标连续性处理