sigcorp/ecs_monitor

ECS容器内存指标CloudWatch推送工具镜像

镜像概述

本Docker镜像提供了一种无需启用ContainerInsights即可将ECS容器内存指标推送至Amazon CloudWatch的解决方案。通过直接采集容器运行时内存数据并通过CloudWatch API提交，帮助用户在不依赖AWS ContainerInsights服务的情况下实现ECS容器内存监控。

核心功能与特性

• 轻量级部署：独立容器化部署，无需修改现有ECS任务定义
• 内存指标采集：实时收集容器内存使用率、已用内存、总内存等核心指标
• CloudWatch集成：原生支持AWS CloudWatch API，自动创建指标命名空间和维度
• 低资源占用：优化的采集逻辑，对宿主资源消耗低
• 配置灵活：支持自定义指标推送间隔、命名空间及AWS区域

使用场景

• ECS环境中需要监控容器内存但不想启用ContainerInsights的场景
• 对监控成本敏感，希望减少ContainerInsights相关费用的用户
• 需要自定义内存指标收集逻辑或频率的场景
• 混合云环境中需要统一通过CloudWatch监控ECS容器的场景

使用方法

环境变量配置

Docker Run命令示例

bash
docker run -d \
  --name ecs-memory-metrics \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-east-1 \
  -e ECS_CLUSTER=your-ecs-cluster \
  -e METRIC_NAMESPACE=Custom/ECS/Memory \
  -e PUSH_INTERVAL=30 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/your-image-name:latest

Docker Compose配置示例

yaml
version: '3'
services:
  ecs-memory-metrics:
    image: docker.xuanyuan.run/your-image-name:latest
    container_name: ecs-memory-metrics
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
      - AWS_REGION=us-east-1
      - ECS_CLUSTER=your-ecs-cluster
      - METRIC_NAMESPACE=Custom/ECS/Memory
      - PUSH_INTERVAL=30
      - LOG_LEVEL=INFO
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always

注意事项

1. 容器需要挂载/var/run/docker.sock以获取容器运行时信息
2. AWS访问密钥需具备cloudwatch:PutMetricData权限
3. 确保ECS集群与运行本容器的主机网络可达
4. 对于ECS Fargate环境，需确保任务执行角色具备相应权限

指标说明

推送至CloudWatch的指标包含以下维度和指标项：

维度

• ClusterName: ECS集群名称
• ContainerName: 容器名称
• TaskId: ECS任务ID

指标项

• MemoryUsage: 容器已使用内存(字节)
• MemoryUtilization: 内存使用率(百分比)
• MemoryLimit: 容器内存限制(字节)