cuigh/prometheus

Prometheus Swarm 发现镜像

镜像概述和主要用途

该镜像为Prometheus v2.x版本，集成了Docker Swarm服务发现功能，旨在简化Docker Swarm集群环境下的监控配置。通过Swarm服务发现机制，Prometheus能够自动发现并监控Swarm集群中的服务实例，无需手动配置目标端点。

核心功能和特性

• Swarm服务自动发现：通过Swarm API自动发现集群中的服务实例
• 灵活的标签控制：支持通过服务标签配置监控规则
• 可定制化抓取参数：支持配置抓取间隔、超时时间、指标路径等参数
• 多维度标签注入：自动注入服务名、节点IP、节点名称等元数据标签

使用场景和适用范围

适用于Docker Swarm集群环境下的服务监控，特别适合动态扩缩容的服务场景，可自动适应服务实例的变化，减少手动配置维护成本。

详细配置说明

Prometheus配置

在Prometheus配置文件中添加Swarm服务发现配置：

yaml
- job_name: swarm
  scrape_interval: 15s  # 抓取间隔，默认15秒
  scrape_timeout: 10s   # 抓取超时时间，默认10秒
  metrics_path: /metrics  # 指标路径，默认/metrics
  scheme: http  # 协议，默认http
  swarm_sd_configs:
  - api_server: http://docker-proxy:2375  # Docker Swarm API地址
    # api_version: 1.32  # API版本，可选
    # group: xxx  # 服务组，需与服务标签中的prometheus.group匹配，可选
    # network: xxx  # 网络名称，可选
    # refresh_interval: 10s  # 刷新间隔，默认10秒，可选
    # timeout: 15s  # 超时时间，默认15秒，可选
  relabel_configs:
    # 添加服务标签
    - source_labels: [__meta_swarm_service]
      target_label: service
    # 添加节点IP标签
    - source_labels: [__meta_swarm_node_ip]
      target_label: node_ip
    # 添加节点名称标签
    - source_labels: [__meta_swarm_node_name]
      target_label: node_name

Swarm服务标签配置

在Swarm服务中添加以下标签可控制Prometheus的抓取行为：

• prometheus.enable - 必填，启用Prometheus监控
• prometheus.port - 必填，服务暴露指标的端口
• prometheus.network - 可选，网络类型，可设为"host"或Prometheus与服务共同连接的overlay网络
• prometheus.path - 可选，指标路径，默认为/metrics
• prometheus.group - 可选，服务组名称，必须与swarm_sd_configs中的group配置匹配
• prometheus.mode - 可选，抓取模式，"task"（任务级）或"service"（服务级），默认为"task"

部署示例

Docker Run命令

bash
docker run -d \
  --name prometheus-swarm \
  -p 9090:9090 \
  -v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
  --network swarm-network \
  cuigh/prometheus

Docker Compose配置

yaml
version: '3.8'
services:
  prometheus:
    image: cuigh/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    networks:
      - swarm-network
    deploy:
      placement:
        constraints: [node.role == manager]

networks:
  swarm-network:
    driver: overlay

注：部署前需确保Prometheus容器能够访问Docker Swarm API（如通过docker-proxy或直接访问Docker socket），并正确配置网络以保证与被监控服务的连通性。