pambrose/prometheus-proxy

Prometheus Proxy

概述

Prometheus Proxy是一个专为Prometheus监控系统设计的代理服务工具。它作为Prometheus服务器与监控目标之间的中间层，提供了一系列增强功能，帮助用户更安全、更高效地管理Prometheus监控环境。

核心功能与特性

安全增强

• 提供认证与授权机制，保护Prometheus API
• 支持TLS加密，确保数据传输安全
• 实现IP白名单/黑名单功能，限制访问来源

请求管理

• 请求限流，防止Prometheus服务器被过多请求压垮
• 请求过滤，只允许符合特定规则的请求通过
• 请求转发，支持将请求路由到不同的Prometheus实例

数据处理

• 指标数据转换与重命名
• 支持数据聚合与采样
• 指标标签管理与过滤

高可用支持

• 实现负载均衡，分发请求到多个Prometheus实例
• 提供故障转移功能，增强系统可靠性
• 支持多区域部署，提高监控系统的容错能力

使用场景与适用范围

适用场景

• 企业级Prometheus部署，需要增强安全性
• 大规模监控环境，需要负载均衡和请求管理
• 多团队共享Prometheus实例，需要访问控制
• 需要实现Prometheus高可用架构
• 需要对监控数据进行预处理或转换

适用范围

• 各类基于Prometheus的监控系统
• Kubernetes集群监控
• 微服务架构监控
• 云原生应用监控
• 混合云环境监控

使用方法与配置说明

基本使用

Docker Run 命令

bash
docker run -d \
  --name prometheus-proxy \
  -p 8080:8080 \
  -e PROMETHEUS_TARGET=http://prometheus:9090 \
  pambrose/prometheus-proxy

Docker Compose 配置

yaml
version: '3'
services:
  prometheus:
    image: prom/prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
    restart: always
    
  prometheus-proxy:
    image: pambrose/prometheus-proxy
    ports:
      - "8080:8080"
    environment:
      - PROMETHEUS_TARGET=http://prometheus:9090
      - PROXY_PORT=8080
      - LOG_LEVEL=info
    depends_on:
      - prometheus
    restart: always

配置参数

环境变量

配置文件

Prometheus Proxy支持通过配置文件进行更详细的配置。默认配置文件路径为/etc/prometheus-proxy/config.yml，可以通过-c或--config参数指定自定义路径。

示例配置文件:

yaml
proxy:
  port: 8080
  timeout: 30s
  max_connections: 1000

prometheus:
  target: http://localhost:9090
  timeout: 10s
  
security:
  tls:
    enabled: true
    cert_path: /etc/tls/cert.pem
    key_path: /etc/tls/key.pem
  auth:
    enabled: true
    users:
      - username: admin
        password: securepassword
  ip_whitelist:
    - 192.168.1.0/24
    - 10.0.0.0/8

rate_limit:
  enabled: true
  requests: 100
  duration: 60s

logging:
  level: info
  format: json

启动命令参数

bash
# 基本启动
prometheus-proxy

# 指定配置文件
prometheus-proxy -c /path/to/config.yml

# 显示帮助信息
prometheus-proxy -h

# 显示版本信息
prometheus-proxy -v

部署示例

单节点Prometheus增强部署

yaml
version: '3'
services:
  prometheus:
    image: prom/prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus-data:/prometheus
    restart: always
    networks:
      - monitoring-network
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.enable-lifecycle'

  prometheus-proxy:
    image: pambrose/prometheus-proxy
    ports:
      - "8080:8080"
    environment:
      - PROMETHEUS_TARGET=http://prometheus:9090
      - PROXY_PORT=8080
      - LOG_LEVEL=info
      - AUTH_ENABLED=true
      - AUTH_USERNAME=monitor
      - AUTH_PASSWORD=securepass123
      - RATE_LIMIT_ENABLED=true
      - RATE_LIMIT_REQUESTS=200
      - RATE_LIMIT_DURATION=60
    depends_on:
      - prometheus
    restart: always
    networks:
      - monitoring-network

networks:
  monitoring-network:
    driver: bridge

volumes:
  prometheus-data:

高可用Prometheus集群部署

yaml
version: '3'
services:
  prometheus-1:
    image: prom/prometheus
    volumes:
      - ./prometheus-1.yml:/etc/prometheus/prometheus.yml
      - prometheus-data-1:/prometheus
    restart: always
    networks:
      - monitoring-network

  prometheus-2:
    image: prom/prometheus
    volumes:
      - ./prometheus-2.yml:/etc/prometheus/prometheus.yml
      - prometheus-data-2:/prometheus
    restart: always
    networks:
      - monitoring-network

  prometheus-proxy:
    image: pambrose/prometheus-proxy
    ports:
      - "8080:8080"
    volumes:
      - ./proxy-config.yml:/etc/prometheus-proxy/config.yml
    restart: always
    networks:
      - monitoring-network
    command: -c /etc/prometheus-proxy/config.yml

networks:
  monitoring-network:
    driver: bridge

volumes:
  prometheus-data-1:
  prometheus-data-2: