Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Ambil data metrik () GetMetricData
GetMetricDataadalah API utama untuk mengambil titik data metrik Klasik secara terprogram. Ini mendukung kueri batch, ekspresi matematika, dan kueri dalam satu panggilan.
Penggunaan dasar
Ambil satu metrik:
aws cloudwatch get-metric-data \ --metric-data-queries '[ { "Id": "cpu", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{"Name": "InstanceId", "Value": "i-1234567890abcdef0"}] }, "Period": 300, "Stat": "Average" } } ]' \ --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \ --end-time $(date -u +%Y-%m-%dT%H:%M:%S) \ --output json
Kueri Batch
Ambil beberapa metrik dalam satu panggilan (hingga 500 kueri):
aws cloudwatch get-metric-data \ --metric-data-queries '[ {"Id": "cpu", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{"Name": "InstanceId", "Value": "i-abc"}]}, "Period": 300, "Stat": "Average"}}, {"Id": "mem", "MetricStat": {"Metric": {"Namespace": "CWAgent", "MetricName": "mem_used_percent", "Dimensions": [{"Name": "InstanceId", "Value": "i-abc"}]}, "Period": 300, "Stat": "Average"}} ]' \ --start-time 2024-01-01T00:00:00 \ --end-time 2024-01-01T01:00:00
Ekspresi matematika
Gabungkan metrik menggunakan aritmatika:
[ {"Id": "rx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkIn", "Dimensions": [{"Name": "InstanceId", "Value": "i-abc"}]}, "Period": 300, "Stat": "Sum"}}, {"Id": "tx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkOut", "Dimensions": [{"Name": "InstanceId", "Value": "i-abc"}]}, "Period": 300, "Stat": "Sum"}}, {"Id": "total", "Expression": "rx + tx", "Label": "TotalNetwork"} ]
GetMetricData vs GetMetricStatistics
GetMetricData |
GetMetricStatistics |
|
|---|---|---|
Dukungan Batch |
Hingga 500 kueri per panggilan |
Metrik tunggal per panggilan |
Ekspresi matematika |
Ya |
Tidak |
pertanyaan |
Ya |
Tidak |
Paginasi |
Ya (NextToken) |
Tidak |
Disarankan |
Ya - API utama |
Legacy — gunakan GetMetricData sebagai gantinya |
Harga
$0,01 per 1.000 metrik yang diminta melalui. GetMetricData
catatan
Untuk metrik OTel, gunakan API Prometheus-compatible kueri atau CloudWatch Query Studio dengan PromQL. GetMetricDatatidak menanyakan metrik OTel.