prometheuscommunity/ecs-exporter

ecs_exporter

镜像概述和主要用途

这是Prometheus社区提供的Amazon Elastic Container Service (ECS)导出器，用于收集ECS任务的基础设施指标（源自ECS任务元数据API v4），并以Prometheus exposition格式暴露，便于Prometheus监控。该导出器通常作为sidecar容器运行在ECS任务中，补充任务级别的监控指标，可参考AWS相关博客中描述的监控场景进行集成。

核心功能和特性

• 从ECS任务元数据API（如/task/stats端点）收集任务基础设施指标（CPU、内存、网络等）
• 默认在:9779/metrics路径暴露Prometheus文本格式指标
• 支持作为sidecar容器无缝集成到现有ECS任务定义
• 提供容器级和网络级指标，并包含相关标签（如container_name、interface）

使用场景和适用范围

适用于需要监控ECS任务（包括Fargate和EC2启动类型）基础设施指标的场景，特别是作为AWS托管Prometheus服务监控方案的补充，用于获取任务级别的详细运行指标，满足Prometheus生态的监控需求。

使用方法和配置说明

基本使用

运行以下容器作为ECS任务的sidecar：

bash
quay.io/prometheuscommunity/ecs-exporter:v0.4.0

建议使用https://github.com/prometheus-community/ecs_exporter/releases%E7%9A%84%E6%A0%87%E7%AD%BE%E3%80%82

添加到现有ECS任务定义

1. 进入ECS任务定义页面
2. 点击“创建新修订版”
3. 滚动至“容器定义”，点击“添加容器”
4. 设置容器名称为“ecs-exporter”
5. 复制上述容器镜像URL（使用最新发布标签）
6. 添加端口映射：tcp/9779
7. 点击“添加”返回任务定义页面
8. 点击“创建”完成新修订版创建

默认配置

• 指标暴露地址：:9779/metrics
• 无需额外配置，自动从ECS任务元数据API获取指标

兼容性说明

所有指标均依赖ECS任务元数据API。AWS可能对该API进行未宣布的破坏性变更（尤其是/task/stats端点的容器级统计数据），可能导致导出器指标异常。因此，该导出器暂未计划发布1.0版本，必要时会在次要版本中包含破坏性变更，详细变更将记录在https://github.com/prometheus-community/ecs_exporter/releases%E4%B8%AD%E3%80%82

指标标签说明

• 任务级指标：无默认标签，可通过PromQL与ecs_task_metadata_info指标关联以添加任务元数据（如任务ARN）
• 容器级指标：包含container_name标签，对应ECS任务定义中的容器名称
• 网络级指标：包含interface标签，对应网络接口设备

示例输出

可参考https://github.com/prometheus-community/ecs_exporter/tree/main/ecscollector/testdata/snapshots%E6%9F%A5%E7%9C%8B%60/metrics%60%E7%AB%AF%E7%82%B9%E7%9A%84%E9%A2%84%E6%9C%9FPrometheus%E6%96%87%E6%9C%AC%E6%A0%BC%E5%BC%8F%E6%8C%87%E6%A0%87%E3%80%82%E6%B3%A8%E6%84%8F%EF%BC%9A%E5%BF%AB%E7%85%A7%E4%B8%AD%E4%B8%8D%E5%8C%85%E5%90%AB%E6%A0%87%E5%87%86client_golang%E6%8C%87%E6%A0%87%EF%BC%88%E5%A6%82go_*%E3%80%81process_*%EF%BC%89%EF%BC%8C%E7%9B%B8%E5%BD%93%E4%BA%8E%E8%BF%90%E8%A1%8C%E6%97%B6%E6%B7%BB%E5%8A%A0%E4%BA%86%60--web.disable-exporter-metrics%60%E5%8F%82%E6%95%B0%E3%80%82