查询Prometheus实例下瞬时数据

功能介绍

该接口用于查询Prometheus实例中PromQL(Prometheus Query Language) 在特定时间点下的计算结果。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/{prometheus_instance}/aom/api/v1/query

请求参数

响应参数

状态码：200

状态码：400

状态码：403

状态码：422

状态码：503

请求示例

查询在1630381536时刻的aom_node_status指标（前topk个）。

https://{EndPoint}/v1/{project_id}/{prometheus_instance}/aom/api/v1/query?query=topk(2,aom_node_status)&time=1630381536

响应示例

状态码：200

OK 请求响应成功。

{
  "status" : "success",
  "data" : {
    "resultType" : "vector",
    "result" : [ {
      "metric" : {
        "__name__" : "amm_node_status",
        "clusterId" : "00000000-0000-0000-0000-00000000",
        "hostID" : "g947xcxh-2xcxc-xxx-xxcd-f6xxx85",
        "nameSpace" : "default",
        "nodeIP" : "1x6.1xx.0.xxx",
        "nodeName" : "sdxx-jxxxgksi-axx"
      },
      "value" : [ 16303810036, "0" ]
    }, {
      "metric" : {
        "__name__" : "amm_node_status",
        "clusterId" : "00000000-0000-0000-0000-00000000",
        "hostID" : "dc1xxxf7e-b095-4e77-bxx-914dhlxxxbf7",
        "nameSpace" : "default",
        "nodeIP" : "1xx.1xx.0.xxx",
        "nodeName" : "sds-jixxxsi-texxt"
      },
      "value" : [ 1630381536, "0" ]
    } ]
  }
}

状态码：400

BadRequest 非法请求。建议直接修改该请求，不要重试该请求。

{
  "status" : "error",
  "errorType" : "bad_data",
  "error" : "invalid parameter \"query\": 1:1: parse error: unexpected <op:*>"
}

状态码：403

Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

{
  "status" : "error",
  "errorType" : "auth",
  "error" : "auth project_id not pass."
}

状态码：422

Unprocessable 表达式无法执行。

{
  "status" : "error",
  "errorType" : "excution",
  "error" : "expression can't be executed."
}

状态码：503

ServiceUnavailable 被请求的服务无效。建议直接修改该请求，不要重试该请求。

{
  "status" : "error",
  "errorType" : "timeout",
  "error" : "query timed out in query execution."
}

状态码

错误码

请参见错误码。