获取节点监控信息
功能介绍
主要包括节点CPU使用率、内存使用率、网络流量(上行、下行)、存储用量和磁盘读写
URI
POST /v1/{project_id}/node-provider/nodes/{node_id}/metrics
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID 最小长度:32 最大长度:32 |
| node_id | 是 | String | 节点ID 最小长度:36 最大长度:45 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token 最小长度:1 最大长度:65535 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| metric_names | 否 | Array of strings | 指标列表 取值范围 cpuUsage:CPU使用率 diskUsedRate:磁盘使用率 memUsedRate:物理内存使用率 sendBytesRate:上行Bps recvBytesRate:下行Bps cpuCoreLimit:CPU内核总量 cpuCoreUsed:CPU内核占用 totalMem:物理内存总量 freeMem:可用物理内存 diskCapacity:磁盘空间容量 diskAvailableCapacity:可用磁盘空间 默认值:前5项 数组长度:0 - 1000 |
| period | 是 | Integer | 监控数据粒度,取值范围(枚举):60(表示粒度为1分钟),300(表示粒度为5分钟) 最小值:0 最大值:86400 |
| timerange | 是 | String | 查询时间范围,-1.-1.60(表示最近60分钟) startTimeInMillis.endTimeInMillis.durationInMinutes 最小长度:0 最大长度:100 |
| statistics | 是 | Array of strings | 统计方式,取值范围 maximum,minimum,sum,average,sampleCount 数组长度:0 - 1000 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| metrics | Array of MetricItemResultAPI objects | 指标对象列表。 数组长度:0 - 1000 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| metric | MetricDemision object | 指标描述信息 |
| dataPoints | Array of MetricDataPoints objects | 监控数据信息 数组长度:0 - 1000 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| namespace | String | 命名空间 最小长度:1 最大长度:65535 |
| metricName | String | 指标名称 最小长度:1 最大长度:65535 |
| dimensions | Array of Dimension objects | 维度列表 数组长度:0 - 1000 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| timestamp | String | 时间戳。 最小长度:0 最大长度:100 |
| unit | String | 指标单位。 最小长度:1 最大长度:65535 |
| statistics | Array of StatisticValue objects | 统计方式。 数组长度:0 - 1000 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| statistic | String | 统计方式 最小长度:1 最大长度:65535 |
| value | Double | 统计结果。 最小值:0 最大值:2147483647 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
状态码: 401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
状态码: 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
请求示例
{
"metric_names" : [ "cpuUsage" ],
"period" : 300,
"timerange" : "-1.-1.60",
"statistics" : [ "maximum" ]
} 响应示例
状态码: 200
请求成功
{
"metrics" : [ {
"metric" : {
"namespace" : "123",
"metricName" : "cpuUsage",
"dimensions" : [ {
"name" : "nodeIP",
"value" : "192.168.0.1"
} ]
},
"dataPoints" : [ {
"timestamp" : 1686059700000,
"unit" : "Percent",
"statistics" : [ {
"statistic" : "average",
"value" : 20
} ]
} ]
} ]
} 状态码: 400
请求参数校验不通过
{
"code" : 400,
"error_code" : "BCS.03400001",
"error_msg" : "Invalid request.",
"message" : "unmarshal request data error"
} 状态码: 401
鉴权失败
{
"code" : 401,
"error_code" : "BCS.03401001",
"error_msg" : "Authorization failed.",
"message" : "request token is not valid"
} 状态码: 500
服务内部执行错误
{
"code" : 500,
"error_code" : "BCS.03500001",
"error_msg" : "Internal error.",
"message" : "project [xxx] node [xxx] get service bearer user token error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数校验不通过 |
| 401 | 鉴权失败 |
| 500 | 服务内部执行错误 |
错误码
请参见错误码。