AWS Fargate usage metrics - Amazon ECS

AWS Fargate usage metrics

You can use CloudWatch usage metrics to provide visibility into your accounts usage of resources. Use these metrics to visualize your current service usage on CloudWatch graphs and dashboards.

AWS Fargate usage metrics correspond to AWS service quotas. You can configure alarms that alert you when your usage approaches a service quota. For more information about Fargate service quotas, see AWS Fargate service quotas.

AWS Fargate publishes the following metrics in the AWS/Usage namespace.




The total number of the specified resource running on your account. The resource is defined by the dimensions associated with the metric.

The following dimensions are used to refine the usage metrics that are published by AWS Fargate.




The name of the AWS service containing the resource. For AWS Fargate usage metrics, the value for this dimension is Fargate.


The type of entity that is being reported. Currently, the only valid value for AWS Fargate usage metrics is Resource.


The type of resource that is running.

Currently, AWS Fargate returns information on your Fargate On-Demand and Fargate Spot usage. The resource value for Fargate On-Demand usage is OnDemand and for Fargate Spot it is Spot.


Fargate On-Demand usage combines Amazon EKS pods using Fargate, Amazon ECS tasks using the Fargate launch type and Amazon ECS tasks using the FARGATE capacity provider.


The class of resource being tracked. Currently, AWS Fargate does not use the class dimension.

Creating a CloudWatch alarm to monitor Fargate resource usage metrics

AWS Fargate provides CloudWatch usage metrics that correspond to the AWS service quotas for Fargate On-Demand and Fargate Spot resource usage. In the Service Quotas console, you can visualize your usage on a graph and configure alarms that alert you when your usage approaches a service quota. For more information, see AWS Fargate usage metrics.

Use the following steps to create a CloudWatch alarm based on one of the Fargate resource usage metrics.

To create an alarm based on your Fargate usage quotas (AWS Management Console)

  1. Open the Service Quotas console at

  2. In the navigation pane, choose AWS services.

  3. From the AWS services list, search for and select AWS Fargate.

  4. In the Service quotas list, select the Fargate usage quota you want to create an alarm for.

  5. In the Amazon CloudWatch Events alarms section, choose Create.

  6. For Alarm threshold, choose the percentage of your applied quota value that you want to set as the alarm value.

  7. For Alarm name, enter a name for the alarm and then choose Create.