平台中心
首页 / API 文档 / 运维中心 / 监控指标 / 查看多个指标在某一时间点的监控数据

*查看多个指标在某一时间点的监控数据

请求信息

请求行

POST /v2/metrics/{cluster}/query

查询指定集群下多个指标在某一时间点的监控数据。通过请求体可配置待查询指标及查询时间等，指标名称、监控指标变量等参数可通过 GET /v2/metrics/{cluster}/indicators 接口获取。

请求行参数

名称 类型 是否必填项 描述
cluster string 是集群的名称。

请求体

Content-Type application/json

请求体示例

查询请求体。

{
   "queries": [
     {
       "id": "cpu_usage_rate_top5",
       "indicator": "platform.node.cpu.utilization.topk",
       "variables": {
         "top": "5"
       }
     }
   ],
   "time": 1640674801
 }

请求体说明

名称 类型 是否必填项 描述
queries array 是 执行的查询的入参信息。
字段路径：queries
queries[] object 是 查询项。
字段路径：queries[]
queries[].id string 是 用于区分查询的 id，用户可自定义。例如：有多个查询时，可通过该 ID 来识别每个查询。
字段路径：queries[].id
queries[].indicator string 是 指标名称。可通过 GET /v2/metrics/{cluster}/indicators 接口获取。
字段路径：queries[].indicator
queries[].variables object 是 监控指标的变量（键/值对）。可通过 GET /v2/metrics/{cluster}/indicators 接口获取。
字段路径：queries[].variables
time number 是 查询时间的 Unix 时间戳，以秒为单位。
字段路径：time

返回信息

Content-Type application/json

状态码: 200

OK

返回体示例

Prometheus 返回的查询结果数据。字段说明请参考：https://prometheus.io/docs/concepts/jobs_instances/#jobs-and-instances

[
   {
     "id": "cpu_usage_rate_top5",
     "result": [
       {
         "metric": {
           "cluster": "global",
           "node": "192.168.130.169"
         },
         "value": [
           1640674801,
           "43.64428816141409"
         ]
       },
       {
         "metric": {
           "cluster": "global",
           "node": "192.168.130.193"
         },
         "value": [
           1640674801,
           "43.10089975981735"
         ]
       },
       {
         "metric": {
           "cluster": "global",
           "node": "192.168.130.187"
         },
         "value": [
           1640674801,
           "36.711805555597586"
         ]
       }
     ],
     "resultType": "vector"
   }
 ]

返回体说明

名称 类型 描述
[] object Prometheus 返回的查询结果数据。
字段路径：[]
[].id string 查询 id，唯一标识一次查询。
字段路径：[].id
[].result array 从 Prometheus 中查询到的结果中的值。
字段路径：[].result
[].resultType string Prometheus 表达式数据类型。详细信息请参考：https://prometheus.io/docs/prometheus/latest/querying/basics/#expression-language-data-types
字段路径：[].resultType
[].result[] object 查询结果的值。
字段路径：[].result[]
result[].metric object 从 Prometheus 中查询到的结果中的指标。
字段路径：[].result[].metric

其他状态码