Acme Cloud

时序指标查询

GET/v2/monitor/metrics

按 PromQL 风格的指标名与标签查询时序数据点。

单次查询返回的最大点数为 10 800。时间跨度越大，建议提高 step（粒度），否则服务端会自动降采样并在响应头返回 X-Downsampled: true。

Bearer Token monitor:read 60 次 / 分钟 api.demo.acme-cloud.dev

请求参数

共 6 项
metric 必填 查询

string

指标名称

可选值cpu_usage_pctmemory_usage_pctdisk_io_bytesnet_in_bytesreq_latency_ms
resource_id 可选 查询

string

资源 ID，如实例 ID

from 必填 查询

string

起始时间，RFC 3339 或相对量（如 -1h）

to 可选 查询

string · 默认 now

结束时间，默认 now

step 可选 查询

string · 默认 60s

聚合粒度，如 30s / 5m / 1h

agg 可选 查询

string · 默认 avg

聚合函数

可选值avgmaxminsump95

响应

3 种状态

200 OK

响应示例
{
  "metric": "cpu_usage_pct",
  "resource_id": "ins_4f21b8",
  "step": "60s",
  "points": [
    {
      "t": "2026-10-16T07:00:00Z",
      "v": 31.2
    },
    {
      "t": "2026-10-16T07:01:00Z",
      "v": 34.8
    },
    {
      "t": "2026-10-16T07:02:00Z",
      "v": 37.4
    }
  ],
  "summary": {
    "avg": 34.47,
    "max": 37.4,
    "min": 31.2,
    "p95": 37
  }
}

代码示例

cURL
curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/monitor/metrics?metric=cpu_usage_pct&resource_id=ins_4f21b8&from=-1h&to=now&step=60s&agg=avg' \
  -H 'Accept: application/json'