View a markdown version of this page

Ambil data metrik () GetMetricData - Amazon CloudWatch

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.