Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Ambil data metrik () GetMetricData
<a name="metrics-classic-getdata"></a>

`GetMetricData`adalah API utama untuk mengambil titik data metrik Klasik secara terprogram. Ini mendukung kueri batch, ekspresi matematika, dan kueri dalam satu panggilan.

## Penggunaan dasar
<a name="metrics-classic-getdata-basic"></a>

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
<a name="metrics-classic-getdata-batch"></a>

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
<a name="metrics-classic-getdata-math"></a>

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
<a name="metrics-classic-getdata-comparison"></a>


|  | **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
<a name="metrics-classic-getdata-pricing"></a>

$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. `GetMetricData`tidak menanyakan metrik OTel.