更新时间:2025-09-18 GMT+08:00
分享

密码资源指标监控

功能介绍

获取密码服务实例与虚拟密码机实例的指标(cpu使用率,内存使用率等指标)。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/dew/cpcs/vm-monitor

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

表2 Query参数

参数

是否必选

参数类型

描述

namespace

String

所属空间,分别从不同的来源获取监控数据,有:ECS,DHSM

metric_name

String

指标名称,有:mem_util,cpu_uttl,network_outgoing_bytes_rate_inband

instance_id

String

实例id,默认空字符串,默认查询所有实例。

vsm_id

String

虚拟机id

from

Long

查询时间范围的起始时间,毫秒时间戳,默认0,默认查询从三天前。

to

Long

查询时间范围的终止时间,毫秒时间戳,默认0,默认查询到当前时间。

period

Integer

统计数据周期,默认0,默认周期为5分钟

filter

String

统计值类型,默认min,默认查询最小值

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

iam鉴权Token

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

datapoints

Array of Datapoint objects

指标的时间序列

metric_name

String

指标名称,比如:cpu_util

max

Double

最大值,未计算默认为0

average

Double

平均值,未计算默认为0

表5 Datapoint

参数

参数类型

描述

max

Double

最大值,未计算默认为0

min

Double

最小值,未计算默认为0

average

Double

平均值,未计算默认为0

sum

Double

综合,未计算默认为0

variance

Double

方差,未计算默认为0

timestamp

Long

毫秒时间戳

unit

String

数据单位,比如%,个

请求示例

  • 获取其中一个instance

    /v1/{project_id}/dew/cpcs/vm-monitor?namespace=ECS&from=1736933523900&to=1737019923900&period=3600&metric_name="cpu_util"&instance_id=343486d6-ffae-4ac8-a51c-3d49a9d485af
  • 空数据的情况

    /v1/{project_id}/dew/cpcs/vm-monitor?namespace=ECS&from=1736933523900&to=1737019923900&period=3600&metric_name="cpu_util"&instance_id=

响应示例

状态码:200

正常返回

{
  "average" : 0,
  "max" : 0,
  "datapoints" : [ {
    "max" : 0,
    "min" : 80,
    "average" : 0,
    "sum" : 0,
    "variance" : 0,
    "timestamp" : 1736933523900,
    "unit" : "%"
  }, {
    "max" : 0,
    "min" : 0,
    "average" : 0,
    "sum" : 0,
    "variance" : 0,
    "timestamp" : 1736937123900,
    "unit" : "%"
  }, {
    "max" : 0,
    "min" : 0,
    "average" : 0,
    "sum" : 0,
    "variance" : 0,
    "timestamp" : 1737019923900,
    "unit" : "%"
  } ],
  "metric_name" : "cpu_util"
}

状态码

状态码

描述

200

正常返回

错误码

请参见错误码

相关文档