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.
Contents
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. |
View 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
Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/
. -
If necessary, change the Region. From the navigation bar, select the Region where your Capacity Reservation resides. For more information, see Regions and Endpoints.
-
In the navigation pane, choose Metrics.
-
For All metrics, choose EC2 Capacity Reservations.
-
Choose the metric dimension By Capacity Reservation. Metrics will be grouped by
CapacityReservationId. -
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"
