CloudWatch metrics for On-Demand Capacity Reservations - Amazon Elastic Compute Cloud

CloudWatch metrics for On-Demand Capacity Reservations

With CloudWatch metrics, you can efficiently monitor your Capacity Reservations and identify unused capacity by setting CloudWatch alarms to notify you when usage thresholds are met. This can help you maintain a constant Capacity Reservation volume and achieve a higher level of utilization.

On-Demand Capacity Reservations send metric data to CloudWatch every five minutes. Metrics are not supported for Capacity Reservations that are active for less than five minutes.

For more information about viewing metrics in the CloudWatch console, see Using Amazon CloudWatch Metrics. For more information about creating alarms, see Creating Amazon CloudWatch Alarms.

Capacity Reservation usage metrics

The AWS/EC2CapacityReservations namespace includes the following usage metrics you can use to monitor and maintain on-demand capacity within thresholds you specify for your reservation.

Metric Description
UsedInstanceCount

The number of instances that are currently in use.

Unit: Count

AvailableInstanceCount

The number of instances that are available.

Unit: Count

TotalInstanceCount

The total number of instances you have reserved.

Unit: Count

InstanceUtilization

The percentage of reserved capacity instances that are currently in use.

Unit: Percent

Capacity Reservation metric dimensions

You can use the following dimensions to refine the metrics listed in the previous table.

Dimension Description
CapacityReservationId

This globally unique dimension filters the data you request for the identified capacity reservation only.

Viewing CloudWatch metrics for Capacity Reservations

Metrics are grouped first by the service namespace, and then by the supported dimensions. You can use the following procedures to view the metrics for your Capacity Reservations.

To view Capacity Reservation metrics using the CloudWatch console

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. If necessary, change the Region. From the navigation bar, select the Region where your Capacity Reservation resides. For more information, see Regions and Endpoints.

  3. In the navigation pane, choose Metrics.

  4. For All metrics, choose EC2 Capacity Reservations.

  5. Choose the metric dimension By Capacity Reservation. Metrics will be grouped by CapacityReservationId.

  6. To sort the metrics, use the column heading. To graph a metric, select the check box next to the metric.

To view Capacity Reservation metrics (AWS CLI)

Use the following list-metrics command:

aws cloudwatch list-metrics --namespace "AWS/EC2CapacityReservations"