QueryMetrics - Amazon Managed Service for Prometheus

QueryMetrics

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"
                ]
            }
        ]
    }
}