基本信息

Action

GetMonitorDataByPeriod

Path

/iaas

Method

GET、POST

请求参数

参数名 类型 描述 是否必须

user_id

String

用户 ID

No

region

String

区域 ID

Yes

namespace

String

目前可获取监控数据的云资源类型，可参考附录内容填写。

Yes

start_time

String

开始时间

Yes

end_time

String

结束时间

Yes

resource_id

String

资源 ID

Yes

metrics

Array

监控指标，可参考附录内容填写。

Yes

tags

String

tags 字段 like 匹配

No

tags_condition

Object[]

tags 聚合条件

No

tags_condition.tags_method

String

匹配方式。可取值为 like、in、and、group，默认值为 like。

No

tags_condition.tags

String

匹配值。

step

Integer

步长，单位 s，不填写时，则由后台计算。

No

version

String

集群版本号

No

role

返回数据

此接口除以下返回参数外，还包含公共响应头。关于公共响应头的更多信息，请参见前文内容。

参数名 类型 描述

ret_code

integer

结果

total_count

integer

总数

data

object []

监控数据集。

  • 云服务器的 cpu，memory 的监控值显示的是使⽤的百分⽐。

  • 磁盘监控数据:

    • 磁盘吞吐量的监控数据单位是 B/s。

    • 磁盘 IOPS 的监控数据单位就是 IOPS。

    • ⽹络带宽的监控数据单位是 Bps。

-monitor_data

object []

-start_time

string

开始时间

-end_time

string

结束时间

-min_value

float

最小值

-max_value

float

最大值

-avg_value

float

平均值

-sum_value

float

总和值

-metric_name

string

指标名称

-metric_cn_name

string

指标中文名称

-metric_unit

string

指标单位

-create_time

string

创建时间

-user_id

string

用户 ID

-description

string

指标描述

-step

int

步长

请求示例

{
  "action": "api/qa1/v1/custom/GetMonitorDataByPeriod",
  "region": "qa1",
  "user_id": "usr-f5swzYIu",
  "method": "POST",
  "namespace": "namespace-cloudsat-instance",
  "resource_id": "i-xzqea5k8",
  "metrics": [
    "cpu",
    "memory"
  ],
  "start_time": "2025-10-16T02:23:45.971Z",
  "end_time": "2025-10-16T03:23:45.971Z"

}

返回示例

{
  "total_count": 2,
  "data": [
    {
      "user_id": "usr-f5swzYIu",
      "metric_name": "cpu",
      "resource_id": "i-xzqea5k8",
      "tags": "",
      "metric_cn_name": "CPU 使用率",
      "step": 10,
      "metric_unit": "%",
      "create_time": "2025-05-19T18:33:48.379399Z",
      "monitor_data": [
        {
          "avg_value": 0.1,
          "max_value": 0.1,
          "start_time": "2025-10-16 10:23:40",
          "min_value": 0.1,
          "sum_value": 0.1,
          "end_time": "2025-10-16 10:23:50"
        },
        {
          "avg_value": 0.1,
          "max_value": 0.1,
          "start_time": "2025-10-16 10:23:50",
          "min_value": 0.1,
          "sum_value": 0.1,
          "end_time": "2025-10-16 10:24:00"
        }
      ],
      "description": "CPU 使用率"
    },
    {
      "user_id": "usr-f5swzYIu",
      "metric_name": "memory",
      "resource_id": "i-xzqea5k8",
      "tags": "",
      "metric_cn_name": "内存使用率",
      "step": 10,
      "metric_unit": "%",
      "create_time": "2025-05-19T18:33:48.381566Z",
      "monitor_data": [
        {
          "avg_value": 14.9,
          "max_value": 14.9,
          "start_time": "2025-10-16 10:23:40",
          "min_value": 14.9,
          "sum_value": 14.9,
          "end_time": "2025-10-16 10:23:50",
          "total": "1024"
        },
        {
          "avg_value": 14.9,
          "max_value": 14.9,
          "start_time": "2025-10-16 10:23:50",
          "min_value": 14.9,
          "sum_value": 14.9,
          "end_time": "2025-10-16 10:24:00",
          "total": "1024"
        }
      ],
      "description": "内存使用率"
    }
  ],
  "trace_id": "kPnA84nM9Nxr",
  "ret_code": 0

}

附录

namespace 填写说明

资源类型 namespace

云服务器

namespace-cloudsat-instance

负载均衡器节点

namespace-cloudsat-loadbalancer

负载均衡器监听器(http/https)

namespace-cloudsat-loadbalancer-listener

负载均衡器监听器(tcp/udp/ssl)

namespace-cloudsat-loadbalancer-listener-tcp

负载均衡器监听器后端(http/https)

namespace-cloudsat-loadbalancer-backend-tcp

负载均衡器监听器后端(tcp/udp/ssl)

namespace-cloudsat-loadbalancer-listener-tcp

VPC 网络

namespace-cloudsat-vpc

私有网络

namespace-cloudsat-vxnet

公网 IP

namespace-cloudsat-eip

硬盘

namespace-cloudsat-vol

网卡

namespace-cloudsat-nic

NAT 网关

namespace-cloudsat-nat

文件存储 vNAS

namespace-cloudsat-s2

集群

填写具体集群对应的 appid。

metrics 填写说明

  • 云服务器

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    iowait

    CPU 等待率，单位 %。

    disk_ri

    磁盘读次数，单位 次。

    disk_wi

    磁盘写次数，单位 次。

    disk_rd

    磁盘读，单位 byte/s。

    disk_wr

    磁盘写，单位 byte/s。

    disk_rl

    磁盘读延迟，单位 ms。

    disk_wl

    磁盘写延迟，单位 ms。

    disk_us

    磁盘使用量，单位 %。

    disk_inode

    磁盘 Inode，单位 %。

    if_rx

    入网络带宽，单位 byte。

    if_tx

    出网络带宽，单位 byte。

    if_rp

    入包转发率，单位 pps。

    if_tp

    出包转发率，单位 pps。

    if_rd

    入网络丢包率，单位 %。

    if_td

    出网络丢包率，单位 %。

    if_re

    入网络错误包率，单位 %。

    if_te

    出网络错误包率，单位 %。

  • 负载均衡器节点

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    f_rx

    外网进流量，单位 byte。

    f_tx

    外网出流量，单位 byte。

    rx

    外网进带宽，单位 byte。

    tx

    外网出带宽，单位 byte。

    p_rx

    入包转发率，单位 pps。

    p_tx

    出包转发率，单位 pps。

    d_rx

    入错误包，单位 个。

    d_tx

    出错误包，单位 个。

  • 负载均衡器监听器(http/https)

    指标 说明

    req_c

    请求数，单位 次。

    lat_avg

    平均响应延迟时间，单位 ms。

    lat_max

    最大响应延迟时间，单位 ms。

    lat_min

    最小响应延迟时间，单位 ms。

    s_avg

    并发连接数，单位 次。

    s_max

    并发连接数最大值，单位 个。

    s_lim

    并发连接数上限值，单位 个。

    l_rsp_4xx

    监听器 4xx 响应数，单位 次。

    l_rsp_5xx

    监听器 5xx 响应数，单位 次。

    b_rsp_1xx

    后端 HTTP 1xx 响应数，单位 次。

    b_rsp_2xx

    后端 HTTP 2xx 响应数，单位 次。

    b_rsp_3xx

    后端 HTTP 3xx 响应数，单位 次。

    b_rsp_4xx

    后端 HTTP 4xx 响应数，单位 次。

    b_rsp_5xx

    后端 HTTP 5xx 响应数，单位 次。

    healthy

    后端服务器可用个数，单位 个。

    unhealthy

    后端服务器不可用个数，单位 个。

  • 负载均衡器监听器(tcp/udp/ssl)

    指标 说明

    l_s_c

    累计连接数，单位 次。

    s_avg

    并发连接数，单位 次。

    healthy

    后端服务器可用个数，单位 个。

    unhealthy

    后端服务器不可用个数，单位 个。

  • 负载均衡器监听器后端(http/https)

    指标 说明

    lat_avg

    平均响应延迟时间，单位 ms。

    lat_max

    最大响应延迟时间，单位 ms。

    lat_min

    最小响应延迟时间，单位 ms。

    status

    服务状态，0 正常，1 异常。

    rsp_1xx

    HTTP 1xx 响应数，单位 次。

    rsp_2xx

    HTTP 2xx 响应数，单位 次。

    rsp_3xx

    HTTP 3xx 响应数，单位 次。

    rsp_4xx

    HTTP 4xx 响应数，单位 次。

    rsp_5xx

    HTTP 5xx 响应数，单位 次。

  • 负载均衡器监听器后端(tcp/udp/ssl)

    指标 说明

    l_s_c

    累计连接数，单位 个。

    status

    服务状态，0 正常，1 异常。

  • VPC 网络

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    if_rx

    入网络带宽，单位 byte。

    if_tx

    出网络带宽，单位 byte。

    if_rp

    入包转发率，单位 pps。

    if_tp

    出包转发率，单位 pps。

    if_rd

    入网络丢包率，单位 %。

    if_td

    出网络丢包率，单位 %。

    if_re

    入网络错误包率，单位 %。

    if_te

    出网络错误包率，单位 %。

  • 私有网络

    指标 说明

    if_rx

    入网络带宽，单位 byte。

    if_tx

    出网络带宽，单位 byte。

    if_rp

    入包转发率，单位 pps。

    if_tp

    出包转发率，单位 pps。

    if_rd

    入网络丢包率，单位 %。

    if_td

    出网络丢包率，单位 %。

    if_re

    入网络错误包率，单位 %。

    if_te

    出网络错误包率，单位 %。

  • 公网 IP

    指标 说明

    rx

    入网络带宽，单位 byte。

    tx

    出网络带宽，单位 byte。

    f_rx

    进流量，单位 byte。

    f_tx

    出流量，单位 byte。

    p_rx

    入包转发率，单位 pps。

    p_tx

    出包转发率，单位 pps。

  • 硬盘

    指标 说明

    disk_ri

    磁盘读次数，单位 次。

    disk_wi

    磁盘写次数，单位 次。

    disk_rd

    磁盘读，单位 byte/s。

    disk_wr

    磁盘写，单位 byte/s。

    disk_rl

    磁盘读延迟，单位 ms。

    disk_wl

    磁盘写延迟，单位 ms。

    disk_us

    磁盘使用量，单位 %。

    disk_inode

    磁盘 Inode，单位 %。

  • 网卡

    指标 说明

    if_rx

    入网络带宽，单位 byte。

    if_tx

    出网络带宽，单位 byte。

    if_rp

    入包转发率，单位 pps。

    if_tp

    出包转发率，单位 pps。

  • NAT 网关

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    snat_connection

    连接数，单位 个。

    snat_connection_rate

    连接率，单位 %。

    snat_hit_count

    命中数，单位 次。

    rx

    入网络带宽，单位 byte。

    tx

    出网络带宽，单位 byte。

    p_rx

    入包转发率，单位 pps。

    p_tx

    出包转发率，单位 pps。

    f_rx

    进流量，单位 byte。

    f_tx

    出流量，单位 byte。

  • 文件存储 vNAS

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    iowait

    CPU 使用率，单位 %。

    disk_ri

    磁盘读次数，单位 次。

    disk_wi

    磁盘写次数，单位 次。

    disk_rd

    磁盘读，单位 byte/s。

    disk_wr

    磁盘写，单位 byte/s。

    disk_rl

    磁盘读延迟，单位 ms。

    disk_wl

    磁盘写延迟，单位 ms。

    disk_us

    磁盘使用量，单位 %。

    disk_inode

    磁盘 Inode，单位 %。

    if_rx

    入网络带宽，单位 byte。

    if_tx

    出网络带宽，单位 byte。

    if_rp

    入包转发率，单位 pps。

    if_tp

    出包转发率，单位 pps。

    if_rd

    入网络丢包率，单位 %。

    if_td

    出网络丢包率，单位 %。

    if_re

    入网络错误包率，单位 %。

    if_te

    出网络错误包率，单位 %。

  • 集群

    指标 说明

    cpu

    CPU 使用率，单位 %。

    memory

    内存使用率，单位 %。

    disk_ri

    磁盘读次数，单位 次。

    disk_wi

    磁盘写次数，单位 次。

    disk_rd

    磁盘读，单位 byte/s。

    disk_wr

    磁盘写，单位 byte/s。

    disk_rl

    磁盘读延迟，单位 ms。

    disk_wl

    磁盘写延迟，单位 ms。

    disk_us

    磁盘使用量，单位 %。

    disk_inode

    磁盘 Inode，单位 %。

    cln_healthy

    节点健康状态

    其他

    每个集群各自的监控指标项