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 查詢時間範圍，並在此類查詢必要時才可使用。

Duration (持續時間)

與 Prometheus 相容 API 的 duration，後續立即接著下列其中一個單位：

  • ms 毫秒

  • s 秒

  • m 分鐘

  • h 小時

  • d 天，假設一天總是 24 小時

  • w 週，假設一周總是 7 天

  • y 年，假設一年總是 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"
                ]
            }
        ]
    }
}