Collect Amazon Fargate app and usage metrics - Amazon EKS
Application metricsUsage metrics
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Help improve this page

Want to contribute to this user guide? Choose the Edit this page on GitHub link that is located in the right pane of every page. Your contributions will help make our user guide better for everyone.

Collect Amazon Fargate app and usage metrics

You can collect system metrics and CloudWatch usage metrics for Amazon Fargate.

Application metrics

For applications running on Amazon EKS and Amazon Fargate, you can use the Amazon Distro for OpenTelemetry (ADOT). ADOT allows you to collect system metrics and send them to CloudWatch Container Insights dashboards. To get started with ADOT for applications running on Fargate, see Using CloudWatch Container Insights with Amazon Distro for OpenTelemetry in the ADOT documentation.

Usage metrics

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

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

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

Metric Description

ResourceCount

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 Amazon Fargate.

Dimension Description

Service

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

Type

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

Resource

The type of resource that’s running.

Currently, Amazon Fargate returns information on your Fargate On-Demand usage. The resource value for Fargate On-Demand usage is OnDemand.

[NOTE] ====

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.

====

Class

The class of resource being tracked. Currently, Amazon Fargate doesn’t use the class dimension.

Creating a CloudWatch alarm to monitor Fargate resource usage metrics

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

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

  1. Open the Service Quotas console at https://console.aws.amazon.com/servicequotas/.

  2. In the left navigation pane, choose Amazon services.

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

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

  5. In the Amazon CloudWatch 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.