Builder
Properties
The dimensions. If the metric contains multiple dimensions, you must include a value for each dimension. CloudWatch treats each unique combination of dimensions as a separate metric. If a specific combination of dimensions was not published, you can't retrieve statistics for it. You must specify the same dimensions that were used when the metrics were created. For an example, see Dimension Combinations in the Amazon CloudWatch User Guide. For more information about specifying dimensions, see Publishing Metrics in the Amazon CloudWatch User Guide.
The percentile statistics. Specify values between p0.0 and p100. When calling GetMetricStatistics
, you must specify either Statistics
or ExtendedStatistics
, but not both. Percentile statistics are not available for metrics when any of the metric values are negative numbers.
The name of the metric, with or without spaces.
The granularity, in seconds, of the returned data points. For metrics with regular resolution, a period can be as short as one minute (60 seconds) and must be a multiple of 60. For high-resolution metrics that are collected at intervals of less than one minute, the period can be 1, 5, 10, 20, 30, 60, or any multiple of 60. High-resolution metrics are those metrics stored by a PutMetricData
call that includes a StorageResolution
of 1 second.
The metric statistics, other than percentile. For percentile statistics, use ExtendedStatistics
. When calling GetMetricStatistics
, you must specify either Statistics
or ExtendedStatistics
, but not both.
The unit for a given metric. If you omit Unit
, all data that was collected with any unit is returned, along with the corresponding units that were specified when the data was reported to CloudWatch. If you specify a unit, the operation returns only data that was collected with that unit specified. If you specify a unit that does not match the data collected, the results of the operation are null. CloudWatch does not perform unit conversions.