Monitor Capacity Reservations usage with CloudWatch metrics
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 within the selected Region and account.
Dimension | Description |
---|---|
(No dimension) |
This dimension filters the specified metric for all Capacity Reservations. |
CapacityReservationId
|
This dimension filters the specified metric for the identified Capacity Reservation. |
InstanceType
|
This dimension filters the specified metric for the identified instance type. |
AvailabilityZone
|
This dimension filters the specified metric for the identified Availability Zone. |
InstanceMatchCriteria
|
This dimension filters the specified metric for the identified
instance match criteria ( |
InstancePlatform
|
This dimension filters the specified metric data for the identified platform. |
Tenancy
|
This dimension filters the specified metric for the identified tenancy. |
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 from the preceding metric dimensions Across All Capacity Reservations, By Capacity Reservation, By Instance Type, By Availability Zone, By Platform, By Instance Match Criteria or By Tenancy and metrics will be grouped by No dimension,
CapacityReservationId
,InstanceType
,AvailabilityZone
,Platform
,InstanceMatchCriteria
, andTenancy
respectively. -
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"