CloudWatch metrics for AWS Outposts
AWS Outposts publishes data points to Amazon CloudWatch for your Outposts. CloudWatch enables you to retrieve statistics about those data points as an ordered set of time series data, known as metrics. Think of a metric as a variable to monitor, and the data points as the values of that variable over time. For example, you can monitor the instance capacity available to your Outpost over a specified time period. Each data point has an associated timestamp and an optional unit of measurement.
You can use metrics to verify that your system is performing as expected. For example,
you
can create a CloudWatch alarm to monitor the ConnectedStatus
metric. If the average
metric is less than 1
, CloudWatch can initiate an action, such as sending a
notification to an email address. You can then investigate potential on-premises or
uplink
networking issues that might be impacting the operations of your Outpost. Common issues
include recent on-premises network configuration changes to firewall and NAT rules,
or
internet connection issues. For ConnectedStatus
issues, we recommend verifying
connectivity to the AWS Region from within your on-premises network, and contacting
AWS
Support if the problem persists.
For more information about creating a CloudWatch alarm, see Using Amazon CloudWatch Alarms in the Amazon CloudWatch User Guide. For more information about CloudWatch, see the Amazon CloudWatch User Guide.
Outpost metrics
The AWS/Outposts
namespace includes the following metrics.
Metric | Description |
---|---|
ConnectedStatus |
The status of an Outpost's service link connection. If
the average statistic is less than Unit: Count Maximum resolution: 1 minute Statistics: The most useful statistic is
Dimensions
|
CapacityExceptions |
The number of insufficient capacity errors for instance launches. Unit: Count Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
InstanceFamilyCapacityAvailability |
The percentage of instance capacity available. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
InstanceFamilyCapacityUtilization |
The percentage of instance capacity in use. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
InstanceTypeCapacityAvailability |
The percentage of instance capacity available. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
InstanceTypeCapacityUtilization |
The percentage of instance capacity in use. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
UsedInstanceType_Count |
The number of instance types that are currently in use. Unit: Count Maximum resolution: 5 minutes Dimensions
|
AvailableInstanceType_Count |
The number of available instance types. Unit: Count Maximum resolution: 5 minutes Dimensions
|
EBSVolumeTypeCapacityUtilization |
The percentage of EBS volume type capacity in use. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
EBSVolumeTypeCapacityAvailability |
The percentage of EBS volume type capacity available. Unit: Percent Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
EBSVolumeTypeCapacityUtilizationGB |
The number of gigabytes in use for the EBS volume type. Unit: Gigabyte Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
EBSVolumeTypeCapacityAvailabilityGB |
The number of gigabytes of available capacity for the EBS volume type. Unit: Gigabyte Maximum resolution: 5 minutes Statistics: The most useful statistics are
Dimensions
|
Outpost metric dimensions
To filter the metrics for your Outpost, use the following dimensions.
Dimension | Description |
---|---|
InstanceFamily |
The instance family. |
InstanceType |
The instance type. |
OutpostId |
The ID of the Outpost. |
VolumeType |
The EBS volume type. |
View CloudWatch metrics for your outpost
You can view the CloudWatch metrics for your load balancers using the CloudWatch console.
To view metrics using the CloudWatch console
-
Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/
. -
In the navigation pane, choose Metrics.
-
Select the Outposts namespace.
-
(Optional) To view a metric across all dimensions, enter its name in the search box.
To view metrics using the AWS CLI
Use the following list-metrics command to list the available metrics.
aws cloudwatch list-metrics --namespace AWS/Outposts
To get the statistics for a metric using the AWS CLI
Use the following get-metric-statistics command to get statistics for the specified metric and dimension. CloudWatch treats each unique combination of dimensions as a separate metric. You can't retrieve statistics using combinations of dimensions that were not specially published. You must specify the same dimensions that were used when the metrics were created.
aws cloudwatch get-metric-statistics --namespace AWS/Outposts \ --metric-name InstanceTypeCapacityUtilization --statistics Average --period 3600 \ --dimensions Name=OutpostId,Value=op-01234567890abcdef \ Name=InstanceType,Value=c5.xlarge \ --start-time 2019-12-01T00:00:00Z --end-time 2019-12-08T00:00:00Z