# 성능 개선 도우미의 시계열 지표 조회
<a name="USER_PerfInsights.API.TimeSeries"></a>

`GetResourceMetrics` 연산은 성능 개선 도우미 데이터에서 시계열 지표를 하나 이상 조회합니다. `GetResourceMetrics`에는 지표 및 기간이 필요하고 데이터 포이트 목록이 포함된 응답을 반환합니다.

예를 들어 AWS Management Console에서 `GetResourceMetrics`는 다음 이미지에 표시된 것과 같이 [**카운터 지표(Counter Metrics)**] 차트와 [**데이터베이스 로드(Database Load)**] 차트를 채우는 데 사용됩니다.

![\[카운터 지표 및 데이터베이스 로드 차트\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


`GetResourceMetrics`에서 반환하는 지표는 `db.load`를 제외하고 모두 표준 시계열 지표입니다. 이 지표는 **Database Load(데이터베이스 로드)** 차트에 표시됩니다. `db.load` 지표는 *차원*이라는 하위 구성 요소로 구분할 수 있다는 점에서 다른 시계열 지표와 다릅니다. 앞의 이미지에서 `db.load`는 `db.load`를 구성하는 대기 상태에 따라 구분되고 그룹화됩니다.

**참고**  
`GetResourceMetrics`에서는 `db.sampleload`도 반환할 수 있지만 `db.load` 지표는 대부분의 경우 적절합니다.

`GetResourceMetrics`에서 반환하는 카운터 지표에 대한 자세한 내용은 [성능 개선 도우미 카운터](USER_PerfInsights_Counters.md)를 참조하십시오.

지표에 대해서는 다음 계산이 지원됩니다:
+ 평균 – 일정 기간 동안 지표의 평균 값입니다. `.avg`를 지표 이름에 추가합니다.
+ 최소 – 일정 기간 동안 지표의 최소 값입니다. `.min`를 지표 이름에 추가합니다.
+ 최대 – 일정 기간 동안 지표의 최대 값입니다. `.max`를 지표 이름에 추가합니다.
+ 합계 – 일정 기간 동안 지표 값의 합계입니다. `.sum`를 지표 이름에 추가합니다.
+ 샘플 수 – 일정 기간 동안 지표가 수집된 횟수입니다. `.sample_count`를 지표 이름에 추가합니다.

예를 들어 지표를 300초 (5분) 동안 분당 1회씩 수집한다고 가정합시다. 각 분의 값은 1, 2, 3, 4, 5입니다. 이 경우 다음과 같은 계산 결과가 반환됩니다:
+ 평균 – 3
+ 최소 – 1
+ 최대 – 5
+ 합계 – 15
+ 샘플 수 – 5

`get-resource-metrics` AWS CLI 명령 사용에 대한 자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) 섹션을 참조하세요.

`--metric-queries` 옵션의 경우 결과를 얻고자 하는 쿼리를 한 개 이상 지정하십시오. 각 쿼리는 필수인 `Metric`과 선택 사항인 `GroupBy` 및 `Filter` 파라미터로 구성됩니다. 다음은 `--metric-queries` 옵션 사양을 보여주는 예입니다.

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```