# 지표 데이터 검색(GetMetricData)
<a name="metrics-classic-getdata"></a>

`GetMetricData`는 Classic 지표 데이터 포인트를 프로그래밍 방식으로 검색하기 위한 기본 API입니다. 단일 호출에서 배치 쿼리, 수학 표현식 및 쿼리를 지원합니다.

## 기본 사용법
<a name="metrics-classic-getdata-basic"></a>

단일 지표 검색:

```
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
```

## 배치 쿼리
<a name="metrics-classic-getdata-batch"></a>

단일 호출에서 여러 지표를 검색합니다(최대 500개의 쿼리).

```
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
```

## 수학 표현식
<a name="metrics-classic-getdata-math"></a>

산술을 사용하여 지표 결합:

```
[
  {"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와 GetMetricStatistics 비교
<a name="metrics-classic-getdata-comparison"></a>


|  | **GetMetricData** | **GetMetricStatistics** | 
| --- | --- | --- | 
| 배치 지원 | 호출당 최대 500개의 쿼리 | 호출당 단일 지표 | 
| 수학 표현식 | 예 | 아니요 | 
|  쿼리 | 예 | 아니요 | 
| 페이지 매김 | 예(NextToken) | 아니요 | 
| 권장 | 예 - 기본 API | 레거시 - 대신 GetMetricData 사용 | 

## 가격 책정
<a name="metrics-classic-getdata-pricing"></a>

`GetMetricData`를 통해 요청된 지표 1,000개당 $0.01입니다.

**참고**  
OTel 지표의 경우 Prometheus 호환 쿼리 API 또는 PromQL과 함께 CloudWatch Query Studio를 사용합니다. `GetMetricData`는 OTel 지표를 쿼리하지 않습니다.