raags/ecs-container-exporter

ecs-container-exporter 镜像文档

概述

ecs-container-exporter 是一个 AWS ECS 边车（sidecar）容器，主要功能是将容器级指标导出到 Prometheus 监控系统。该镜像旨在帮助用户在 AWS ECS 环境中收集和暴露容器级别的监控指标，以便通过 Prometheus 进行进一步的监控和分析。更多详细信息请参见 https://github.com/Spaced-Out/ecs-container-exporter%E3%80%82

核心功能与特性

• 边车部署模式：作为 ECS 任务的边车容器运行，与主应用容器共存于同一任务中
• 容器级指标收集：收集运行中容器的详细指标（如 CPU、内存、网络等）
• Prometheus 兼容：以 Prometheus 可识别的格式暴露指标，支持 Prometheus 抓取

使用场景与适用范围

• AWS ECS 集群中需要监控容器级指标的场景
• 需要将 ECS 容器指标集成到 Prometheus 监控体系的环境
• 适用于 ECS Fargate 或 ECS EC2 启动类型的任务

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d --name ecs-container-exporter \
  --network host \
  docker.xuanyuan.run/spaced-out/ecs-container-exporter:latest

ECS 任务定义集成

在 ECS 任务定义中，将该镜像作为边车容器添加到任务中：

json
{
  "containerDefinitions": [
    {
      "name": "main-app",
      "image": "your-main-app-image",
      ...
    },
    {
      "name": "ecs-container-exporter",
      "image": "spaced-out/ecs-container-exporter:latest",
      "portMappings": [
        {
          "containerPort": 9273,
          "hostPort": 9273,
          "protocol": "tcp"
        }
      ],
      "essential": true
    }
  ],
  ...
}

指标访问

默认情况下，指标通过容器的 9273 端口暴露，可通过 http://<container-ip>:9273/metrics 访问。

配置参数

详细的配置参数和环境变量说明请参考 https://github.com/Spaced-Out/ecs-container-exporter%E3%80%82