You can use the GetMetricData API to retrieve as many as 500 different metrics in a single request, with a total of as many as 100,800 data points
You can use the get_metric_data
API to
retrieve as many as 500 different metrics in a single request, with a
total of as many as 100,800 data points. You can also optionally perform
math expressions on the values of the returned statistics, to create new
time series that represent new insights into your data. For example,
using Lambda metrics, you could divide the Errors metric by the
Invocations metric to get an error rate time series. For more
information about metric math expressions, see Metric Math Syntax and Functions
in the Amazon CloudWatch User Guide.
Calls to the get_metric_data
API have a
different pricing structure than calls to
get_metric_statistics
. For more
information about pricing, see Amazon CloudWatch Pricing.
Amazon CloudWatch retains metric data as follows:
Data points with a period of less than 60 seconds are available for
3 hours. These data points are high-resolution metrics and are
available only for custom metrics that have been defined with a
StorageResolution
of 1.
Data points with a period of 60 seconds (1-minute) are available for 15 days.
Data points with a period of 300 seconds (5-minute) are available for 63 days.
Data points with a period of 3600 seconds (1 hour) are available for 455 days (15 months).
Data points that are initially published with a shorter period are aggregated together for long-term storage. For example, if you collect data using a period of 1 minute, the data remains available for 15 days with 1-minute resolution. After 15 days, this data is still available, but is aggregated and retrievable only with a resolution of 5 minutes. After 63 days, the data is further aggregated and is available with a resolution of 1 hour.
If you omit Unit
in your request, 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.
cloudwatch_get_metric_data(MetricDataQueries, StartTime, EndTime, NextToken, ScanBy, MaxDatapoints)
MetricDataQueries |
[required] The metric queries to be returned. A single
|
StartTime |
[required] The time stamp indicating the earliest data to be returned. The value specified is inclusive; results include data points with the specified time stamp. CloudWatch rounds the specified time stamp as follows:
If you set For better performance, specify |
EndTime |
[required] The time stamp indicating the latest data to be returned. The value specified is exclusive; results include data points up to the specified time stamp. For better performance, specify |
NextToken |
Include this value, if it was returned by the previous
|
ScanBy |
The order in which data points should be returned. |
MaxDatapoints |
The maximum number of data points the request should return before paginating. If you omit this, the default of 100,800 is used. |
A list with the following syntax:
list( MetricDataResults = list( list( Id = "string", Label = "string", Timestamps = list( as.POSIXct( "2015-01-01" ) ), Values = list( 123.0 ), StatusCode = "Complete"|"InternalError"|"PartialData", Messages = list( list( Code = "string", Value = "string" ) ) ) ), NextToken = "string", Messages = list( list( Code = "string", Value = "string" ) ) )
svc$get_metric_data( MetricDataQueries = list( list( Id = "string", MetricStat = list( Metric = list( Namespace = "string", MetricName = "string", Dimensions = list( list( Name = "string", Value = "string" ) ) ), Period = 123, Stat = "string", Unit = "Seconds"|"Microseconds"|"Milliseconds"|"Bytes"|"Kilobytes"|"Megabytes"|"Gigabytes"|"Terabytes"|"Bits"|"Kilobits"|"Megabits"|"Gigabits"|"Terabits"|"Percent"|"Count"|"Bytes/Second"|"Kilobytes/Second"|"Megabytes/Second"|"Gigabytes/Second"|"Terabytes/Second"|"Bits/Second"|"Kilobits/Second"|"Megabits/Second"|"Gigabits/Second"|"Terabits/Second"|"Count/Second"|"None" ), Expression = "string", Label = "string", ReturnData = TRUE|FALSE, Period = 123 ) ), StartTime = as.POSIXct( "2015-01-01" ), EndTime = as.POSIXct( "2015-01-01" ), NextToken = "string", ScanBy = "TimestampDescending"|"TimestampAscending", MaxDatapoints = 123 )
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.