ecs-exporter

README

ECS exporter

Export AWS ECS cluster metrics to Prometheus

make
./bin/ecs-exporter --aws.region="${AWS_REGION}"

Notes:

• This exporter will listen by default on the port 9222
• Requires AWS credentials or permission from an EC2 instance

Exported Metrics

Metric	Meaning	Labels
ecs_up	Was the last query of ecs successful	region
ecs_clusters	The total number of clusters	region
ecs_services	The total number of services	region, cluster
ecs_clusters_memory_utilization	CPU utilization of instance.	region, cluster
ecs_clusters_cpu_utilization	CPU utilization of instance.	region, cluster
ecs_service_desired_tasks	The desired number of instantiations of the task definition to keep running regarding a service	region, cluster, service
ecs_service_pending_tasks	The number of tasks in the cluster that are in the PENDING state regarding a service	region, cluster, service
ecs_service_running_tasks	The number of tasks in the cluster that are in the RUNNING state regarding a service	region, cluster, service
ecs_container_instances	The total number of container instances	region, cluster
ecs_container_instance_agent_connected	The connected state of the container instance agent	region, cluster, instance
ecs_container_instance_active	The status of the container instance in ACTIVE state, indicates that the container instance can accept tasks.	region, cluster, instance
ecs_container_instance_pending_tasks	The number of tasks on the container instance that are in the PENDING status.	region, cluster, instance

Flags

• aws.region: The AWS region to get metrics from
• aws.cluster-filter: Regex used to filter the cluster names, if doesn't match the cluster is ignored (default ".*")
• debug: Run exporter in debug mode
• web.listen-address: Address to listen on (default ":9222")
• web.telemetry-path: The path where metrics will be exposed (default "/metrics")
• metrics.disable-cinstances: Disable clusters container instances metrics gathering

Docker

You can deploy this exporter using the coveo/ecs-exporter Docker image.

Note: Requires AWS credentials or permission from an EC2 instance, for example you can pass the env vars using -e AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} -e AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} options

For example:

docker pull coveo/ecs-exporter
docker run -d -p 9222:9222 coveo/ecs-exporter -aws.region="eu-west-1"