기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# QueryMetrics
<a name="AMP-APIReference-QueryMetrics"></a>

`QueryMetrics` 작업은 단일 시점 또는 일정 기간 동안 인스턴트 쿼리를 평가합니다.

유효한 HTTP 동사:  
`GET`, `POST`

유효한 URI:  
`/workspaces/{{workspaceId}}/api/v1/query` 이 URI는 단일 시점의 인스턴트 쿼리를 평가합니다.  
`/workspaces/{{workspaceId}}/api/v1/query_range` 이 URI는 일정 기간 동안의 인스턴트 쿼리를 평가합니다.

URL 쿼리 파라미터:  
`query=<string>` Prometheus 표현식 쿼리 문자열입니다. `query` 및 `query_range` 둘 다에 사용됩니다.  
`time=<rfc3339 | unix_timestamp>` (선택 사항) 단일 시점에서 인스턴트 쿼리에 `query`를 사용하는 경우 평가 타임스탬프입니다.  
`timeout=<duration>` (선택 사항) 평가 시간 초과입니다. 기본값은 `-query.timeout` 플래그 값으로 제한됩니다. `query` 및 `query_range` 둘 다에 사용됩니다.  
`start=<rfc3339 | unix_timestamp>` `query_range`를 사용하여 기간에 대해 쿼리하는 경우 시작 타임스탬프입니다.  
`end=<rfc3339 | unix_timestamp>` `query_range`를 사용하여 기간에 대해 쿼리하는 경우 종료 타임스탬프입니다.  
`step=<duration | float>` `duration` 형식 또는 `float`초 단위로 나타내는 쿼리 해결 단계 폭입니다. `query_range`를 사용하여 일정 기간 동안 쿼리하는 경우에만 사용하며, 해당 쿼리에 필요합니다.  
`max_samples_processed_warning_threshold=<integer>` (선택 사항) 처리된 쿼리 샘플(QSP)에 대한 경고 임계값을 설정합니다. 쿼리가 이 임계값에 도달하면 API 응답에 경고 메시지가 반환됩니다.  
`max_samples_processed_error_threshold=<integer>>` (선택 사항) 처리된 쿼리 샘플(QSP)에 대한 오류 임계값을 설정합니다. 이 기준을 초과하는 쿼리는 오류와 함께 거부되어 요금이 부과되지 않습니다. 과도한 쿼리 비용을 방지하는 데 사용됩니다.

**지속 시간**

Prometheus 호환 API의 `duration`은 숫자이며, 그 뒤에 바로 다음 단위 중 하나가 따라옵니다.
+ `ms`밀리초
+ `s`초
+ `m`분
+ `h`시간
+ `d`일(항상 하루를 24시간으로 가정)
+ `w`주(항상 한 주를 7일로 가정)
+ `y`년(항상 1년을 365일로 가정)

**샘플 요청**

```
POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0
```

**샘플 응답**

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1634937046.322,
                    "252590622.81000024"
                ]
            }
        ]
    }
}
```