This repository is not maintained anymore. It's stable and works as it is, it will not have new features or metrics.

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
• You can use the following IAM policy to grant required permissions:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "ecs:ListServices",
                "ecs:ListContainerInstances",
                "ecs:ListClusters",
                "ecs:DescribeServices",
                "ecs:DescribeContainerInstances",
                "ecs:DescribeClusters"
            ],
            "Resource": "*"
        }
    ]
}

Exported Metrics

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 slok/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 slok/ecs-exporter
docker run -d -p 9222:9222 slok/ecs-exporter -aws.region="eu-west-1"