currtis1/prometheus-ecs-discovery

Prometheus ECS Discovery 镜像

概述

Prometheus ECS Discovery镜像(tkgregory/prometheus-ecs-discovery)是一个用于Prometheus监控系统的服务发现工具，专门设计用于自动发现和监控Amazon ECS(Elastic Container Service)集群中的容器服务。它解决了ECS环境中动态变化的容器实例的监控问题，确保Prometheus能够自动识别和收集新部署的容器服务指标。

核心功能和特性

• 自动发现ECS集群中的服务和任务
• 动态更新Prometheus的目标配置
• 支持ECS任务元数据和标签过滤
• 与Prometheus无缝集成
• 轻量级设计，资源占用低
• 支持AWS IAM角色认证

使用场景和适用范围

• 监控运行在Amazon ECS上的微服务架构
• 需要动态发现容器实例的云原生环境
• 希望自动化Prometheus监控配置的DevOps流程
• 管理大规模动态变化的容器集群
• 需要基于ECS标签进行精细化监控的场景

使用方法和配置说明

前提条件

• 已部署Prometheus服务器
• 具有适当权限的AWS凭证
• 可访问ECS集群的网络环境

Docker Run 示例

bash
docker run -d \
  --name prometheus-ecs-discovery \
  -e AWS_REGION=us-west-2 \
  -e ECS_CLUSTER=my-ecs-cluster \
  -e PROMETHEUS_CONFIG_PATH=/etc/prometheus/prometheus.yml \
  -v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
  tkgregory/prometheus-ecs-discovery

Docker Compose 示例

yaml
version: '3'
services:
  prometheus-ecs-discovery:
    image: tkgregory/prometheus-ecs-discovery
    container_name: prometheus-ecs-discovery
    environment:
      - AWS_REGION=us-west-2
      - ECS_CLUSTER=my-ecs-cluster
      - PROMETHEUS_CONFIG_PATH=/etc/prometheus/prometheus.yml
      - REFRESH_INTERVAL=60
    volumes:
      - /path/to/prometheus.yml:/etc/prometheus/prometheus.yml
    restart: unless-stopped

环境变量配置

集成Prometheus

在Prometheus配置文件中添加以下内容：

yaml
scrape_configs:
  - job_name: 'ecs-services'
    file_sd_configs:
      - files:
        - /etc/prometheus/ecs_sd_targets.json

注意事项

• 确保容器具有访问ECS API和Prometheus配置文件的权限
• 在生产环境中建议使用IAM角色而非访问密钥
• 根据集群规模调整刷新间隔，平衡性能和实时性
• 可通过标签过滤功能只监控特定服务

参考链接

• 原始镜像仓库: https://hub.docker.com/r/tkgregory/prometheus-ecs-discovery