Get statistics for a metric (GetMetricStatistics) - Amazon CloudWatch
UsageWhen to use this API
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

Get statistics for a metric (GetMetricStatistics)

GetMetricStatistics is the legacy single-metric API. For new code, use Retrieve metric data (GetMetricData) instead — it supports batch queries and math expressions.

Usage

aws cloudwatch get-metric-statistics \
  --namespace "AWS/EC2" \
  --metric-name "CPUUtilization" \
  --dimensions Name=InstanceId,Value=i-1234567890abcdef0 \
  --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \
  --end-time $(date -u +%Y-%m-%dT%H:%M:%S) \
  --period 300 \
  --statistics Average Maximum

When to use this API

  • Legacy applications that already depend on it

  • Simple single-metric retrievals where batch isn't needed

For everything else, use Retrieve metric data (GetMetricData).