okirmis/prometheus-satellite

Prometheus Satellite

镜像概述

Prometheus Satellite旨在解决Docker部署（尤其是非Swarm模式，如AWS ECS）中因容器端口非暴露或动态分配导致Prometheus难以抓取指标的问题。它通过动态检测Docker容器、抓取其指标数据，并将所有容器的统计信息通过单一指标端点暴露，方便Prometheus统一采集。

核心功能

• 动态检测Docker容器，自动发现监控目标
• 抓取容器内应用的指标数据
• 通过单一端点暴露所有容器的统计信息
• 支持配置文件或环境变量两种配置方式
• 可根据容器标签筛选需要监控的目标
• 自定义容器列表获取间隔和指标抓取间隔
• 支持缓存端点响应以平衡内存与CPU资源

使用场景

• AWS ECS等非Swarm模式的Docker部署场景
• 容器端口动态分配或未对外暴露的监控需求
• 需要统一监控多个Docker容器指标的场景
• 希望简化Prometheus对动态容器集群监控配置的场景

配置说明

配置文件为JSON格式，包含以下核心参数：

• port：服务绑定端口（默认8182）
• interface：服务绑定接口（默认localhost）
• dockerUrl：Docker API地址或Unix套接字路径（默认unix:/var/run/docker.sock）
• containerFetchInterval：容器列表获取间隔（秒，默认5）
• cacheServerResponse：是否缓存端点响应（默认true，可平衡内存与CPU）
• endpoints：需抓取的端点数组，每个端点包含：
  • name：端点名称（作为指标标签endpoint_name）
  • type：类型（目前仅支持docker）
  • interval：指标抓取间隔（秒，默认10）
  • metricsPath：容器内指标端点路径（默认/metrics）
  • port：容器内应用端口
  • labels：容器标签键值对，需全部匹配才会抓取

部署示例

方式一：使用配置文件部署

shell
docker run -d --name=prometheus-satellite --net=host -v /var/run/docker.sock:/var/run/docker.sock -v /my/sample/config.json:/config.json --rm docker.xuanyuan.run/okirmis/prometheus-satellite /config.json

方式二：使用环境变量部署

shell
SATELLITE_CONFIGURATION='{
  "port": 9101,
  "containerFetchInterval": 15,
  "cacheServerResponse": false,
  "endpoints": [
      {
          "name": "prometheus",
          "type": "docker",
          "port": 9090,
          "labels": {"sample.label": "sample-value"},
          "interval": 15
     }
  ]
}'
docker run -d --name=prometheus-satellite --net=host -v /var/run/docker.sock:/var/run/docker.sock -e SATELLITE_CONFIGURATION --rm docker.xuanyuan.run/okirmis/prometheus-satellite

示例配置

json
{
    "port": 9100,
    "interface": "0.0.0.0",
    "endpoints": [
        {
          "name": "backend",
          "port": 3000,
          "labels": {
            "my.label.appname": "backend-service"
          },
          "interval": 15
        },
        {
          "name": "frontend",
          "port": 80,
          "labels": {
            "my.label.rolename": "frontend"
          },
          "interval": 5
       }
    ]
}