主机指标¶
接口说明¶
- 功能: 获取用户主机性能指标
- 请求
URI:https://api.gpuez.com/zsc/open/api/v2/console/machine/metrics - 请求方法:
GET
鉴权
该接口需要通过 Basic 认证。请查看接口鉴权文档 接口鉴权
请求参数¶
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| machine_id | true | integer | 主机ID |
| metric_names | false | string | 查询指标，多个指标使用,分割，默认：cpu_usage_rate,mem_usage_rate,disk_usage_rate,gpu_usage_rate,gpu_mem_usage |
| start_at | false | string | 查询起始时间，默认1小时前，示例：2024-12-31T17:02:16.469+08:00 |
| end_at | false | string | 查询截止时间，默认当前时间，示例：2025-12-31T17:02:16.469+08:00 |
返回字段¶
| 返回字段 | 字段类型 | 说明 |
|---|---|---|
| code | integer | 错误码 |
| message | string | 返回信息 |
| trace | string | 请求ID |
| data.metrics | array | 详见指标说明 |
指标说明¶
CPU 使用率¶
指标参数 cpu_usage_rate，查询返回字段信息
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| metric.name | string | cpu_usage_rate |
指标名 |
| values[..].0 | integer | 1744191736 | 统计时间戳 |
| values[..].1 | string | "0.25" | CPU使用率，单位%，范围：0~100 |
内存使用率¶
指标参数 mem_usage_rate，查询返回字段信息
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| metric.name | string | mem_usage_rate |
指标名 |
| values[..].0 | integer | 1744191736 | 统计时间戳 |
| values[..].1 | string | "2.35" | 内存使用率，单位%，范围：0~100 |
磁盘使用率¶
指标参数 disk_usage_rate，查询返回字段信息
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| metric.name | string | disk_usage_rate |
指标名 |
| metric.device | string | /dev/nvme0n1p1 |
设备号 |
| metric.fstype | string | xfs |
文件系统类型 |
| metric.mountpoint | string | /zscloud/docker |
挂载路径 |
| values[..].0 | integer | 1744191736 | 统计时间戳 |
| values[..].1 | string | "35.32" | 磁盘使用率，单位%，范围：0~100 |
GPU 使用率¶
指标参数 gpu_usage_rate，查询返回字段信息
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| metric.name | string | gpu_usage_rate |
指标名 |
| metric.device | string | nvidia0 |
设备号 |
| metric.driver_version | string | 550.90.07 |
驱动版本 |
| metric.gpu | string | 0 |
GPU索引 |
| metric.model | string | NVIDIA Graphics Device |
设备类型 |
| values[..].0 | integer | 1744191736 | 统计时间戳 |
| values[..].1 | string | "0.32" | GPU使用率，单位%，范围：0~100 |
显存使用量¶
指标参数 gpu_mem_usage，查询返回字段信息
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| metric.name | string | gpu_mem_usage |
指标名 |
| metric.device | string | nvidia0 |
设备号 |
| metric.driver_version | string | 550.90.07 |
驱动版本 |
| metric.gpu | string | 0 |
GPU索引 |
| metric.model | string | NVIDIA Graphics Device |
设备类型 |
| values[..].0 | integer | 1744191736 | 统计时间戳 |
| values[..].1 | string | "3" | 显存使用率，单位MiB |
接口请求示例¶
请求示例：
curl --user 'ywpkds6mkks9whwwgqwbaxypqo03zklu:lchkswmht6evpk1csllxdntf6t9bzy0d' \
-X GET \
"https://api.gpuez.com/zsc/open/api/v2/console/machine/metrics?machine_id=10027&metric_names=cpu_usage_rate,mem_usage_rate,disk_usage_rate,gpu_usage_rate,gpu_mem_usage&start_at=2025-04-10T15:58:05.897%2B08:00&end_at=2025-04-10T16:58:05.897%2B08:00"
返回示例：
{
"code": 200,
"msg": "success",
"trace": "05e39fcb-af32-414d-97b0-9ada07966113",
"data": {
"metrics": [
{
"metric": {
"name": "cpu_usage_rate"
},
"values": [
[
1744191736,
"0.25"
],
[
1744197736,
"0.29"
],
[
1744203736,
"0.27"
],
[
1744209736,
"0.67"
],
[
1744215736,
"0.22"
],
[
1744221736,
"0.48"
],
[
1744227736,
"0.3"
],
[
1744233736,
"0.5"
],
[
1744239736,
"0.32"
],
[
1744245736,
"0.19"
],
[
1744251736,
"0.11"
],
[
1744257736,
"-0.04"
],
[
1744263736,
"0.46"
],
[
1744269736,
"0.22"
],
[
1744275736,
"0.27"
]
]
},
{
"metric": {
"device": "/dev/nvme0n1p1",
"fstype": "xfs",
"mountpoint": "/zscloud/docker",
"name": "disk_usage_rate"
},
"values": [
[
1744191736,
"36.41"
],
[
1744197736,
"36.41"
],
[
1744203736,
"36.41"
],
[
1744209736,
"36.41"
],
[
1744215736,
"36.41"
],
[
1744221736,
"36.41"
],
[
1744227736,
"36.41"
],
[
1744233736,
"36.41"
],
[
1744239736,
"36.41"
],
[
1744245736,
"36.41"
],
[
1744251736,
"36.41"
],
[
1744257736,
"36.41"
],
[
1744263736,
"36.41"
],
[
1744269736,
"36.41"
],
[
1744275736,
"36.41"
]
]
},
{
"metric": {
"device": "/dev/sda1",
"fstype": "vfat",
"mountpoint": "/boot/efi",
"name": "disk_usage_rate"
},
"values": [
[
1744191736,
"0.57"
],
[
1744197736,
"0.57"
],
[
1744203736,
"0.57"
],
[
1744209736,
"0.57"
],
[
1744215736,
"0.57"
],
[
1744221736,
"0.57"
],
[
1744227736,
"0.57"
],
[
1744233736,
"0.57"
],
[
1744239736,
"0.57"
],
[
1744245736,
"0.57"
],
[
1744251736,
"0.57"
],
[
1744257736,
"0.57"
],
[
1744263736,
"0.57"
],
[
1744269736,
"0.57"
],
[
1744275736,
"0.57"
]
]
},
{
"metric": {
"device": "/dev/sda2",
"fstype": "ext4",
"mountpoint": "/",
"name": "disk_usage_rate"
},
"values": [
[
1744191736,
"10.04"
],
[
1744197736,
"10.03"
],
[
1744203736,
"10.04"
],
[
1744209736,
"10.04"
],
[
1744215736,
"10.05"
],
[
1744221736,
"10.04"
],
[
1744227736,
"10.03"
],
[
1744233736,
"10.04"
],
[
1744239736,
"10.04"
],
[
1744245736,
"10.05"
],
[
1744251736,
"10.04"
],
[
1744257736,
"10.05"
],
[
1744263736,
"10.04"
],
[
1744269736,
"10.05"
],
[
1744275736,
"10.05"
]
]
},
{
"metric": {
"name": "mem_usage_rate"
},
"values": [
[
1744191736,
"2.13"
],
[
1744197736,
"2.13"
],
[
1744203736,
"2.14"
],
[
1744209736,
"2.14"
],
[
1744215736,
"2.14"
],
[
1744221736,
"2.13"
],
[
1744227736,
"2.14"
],
[
1744233736,
"2.14"
],
[
1744239736,
"2.14"
],
[
1744245736,
"2.14"
],
[
1744251736,
"2.11"
],
[
1744257736,
"2.14"
],
[
1744263736,
"2.12"
],
[
1744269736,
"2.12"
],
[
1744275736,
"2.11"
]
]
},
{
"metric": {
"device": "nvidia0",
"driver_version": "550.90.07",
"gpu": "0",
"model": "NVIDIA Graphics Device",
"name": "gpu_usage_rate"
},
"values": [
[
1744107736,
"0"
],
[
1744113736,
"0"
],
[
1744119736,
"0"
],
[
1744125736,
"0"
],
[
1744131736,
"0"
],
[
1744137736,
"0"
],
[
1744143736,
"0"
],
[
1744149736,
"0"
],
[
1744155736,
"0"
],
[
1744161736,
"0"
],
[
1744167736,
"0"
],
[
1744173736,
"0"
],
[
1744179736,
"0"
],
[
1744185736,
"0"
],
[
1744191736,
"0"
],
[
1744197736,
"0"
],
[
1744203736,
"0"
],
[
1744209736,
"0"
],
[
1744215736,
"0"
],
[
1744221736,
"0"
],
[
1744227736,
"0"
],
[
1744233736,
"0"
],
[
1744239736,
"0"
],
[
1744245736,
"0"
],
[
1744251736,
"0"
],
[
1744257736,
"0"
],
[
1744263736,
"0"
],
[
1744269736,
"0"
],
[
1744275736,
"0"
]
]
},
{
"metric": {
"device": "nvidia1",
"driver_version": "550.90.07",
"gpu": "1",
"model": "NVIDIA Graphics Device",
"name": "gpu_usage_rate"
},
"values": [
[
1744107736,
"0"
],
[
1744113736,
"0"
],
[
1744119736,
"0"
],
[
1744125736,
"0"
],
[
1744131736,
"0"
],
[
1744137736,
"0"
],
[
1744143736,
"0"
],
[
1744149736,
"0"
],
[
1744155736,
"0"
],
[
1744161736,
"0"
],
[
1744167736,
"0"
],
[
1744173736,
"0"
],
[
1744179736,
"0"
],
[
1744185736,
"0"
],
[
1744191736,
"0"
],
[
1744197736,
"0"
],
[
1744203736,
"0"
],
[
1744209736,
"0"
],
[
1744215736,
"0"
],
[
1744221736,
"0"
],
[
1744227736,
"0"
],
[
1744233736,
"0"
],
[
1744239736,
"0"
],
[
1744245736,
"0"
],
[
1744251736,
"0"
],
[
1744257736,
"0"
],
[
1744263736,
"0"
],
[
1744269736,
"0"
],
[
1744275736,
"0"
]
]
},
{
"metric": {
"device": "nvidia0",
"driver_version": "550.90.07",
"gpu": "0",
"model": "NVIDIA Graphics Device",
"name": "gpu_mem_usage"
},
"values": [
[
1744107736,
"3"
],
[
1744113736,
"3"
],
[
1744119736,
"3"
],
[
1744125736,
"3"
],
[
1744131736,
"3"
],
[
1744137736,
"3"
],
[
1744143736,
"3"
],
[
1744149736,
"3"
],
[
1744155736,
"3"
],
[
1744161736,
"3"
],
[
1744167736,
"3"
],
[
1744173736,
"3"
],
[
1744179736,
"3"
],
[
1744185736,
"3"
],
[
1744191736,
"3"
],
[
1744197736,
"3"
],
[
1744203736,
"3"
],
[
1744209736,
"3"
],
[
1744215736,
"3"
],
[
1744221736,
"3"
],
[
1744227736,
"3"
],
[
1744233736,
"3"
],
[
1744239736,
"3"
],
[
1744245736,
"3"
],
[
1744251736,
"3"
],
[
1744257736,
"3"
],
[
1744263736,
"3"
],
[
1744269736,
"3"
],
[
1744275736,
"3"
]
]
},
{
"metric": {
"device": "nvidia1",
"driver_version": "550.90.07",
"gpu": "1",
"model": "NVIDIA Graphics Device",
"name": "gpu_mem_usage"
},
"values": [
[
1744107736,
"3"
],
[
1744113736,
"3"
],
[
1744119736,
"3"
],
[
1744125736,
"3"
],
[
1744131736,
"3"
],
[
1744137736,
"3"
],
[
1744143736,
"3"
],
[
1744149736,
"3"
],
[
1744155736,
"3"
],
[
1744161736,
"3"
],
[
1744167736,
"3"
],
[
1744173736,
"3"
],
[
1744179736,
"3"
],
[
1744185736,
"3"
],
[
1744191736,
"3"
],
[
1744197736,
"3"
],
[
1744203736,
"3"
],
[
1744209736,
"3"
],
[
1744215736,
"3"
],
[
1744221736,
"3"
],
[
1744227736,
"3"
],
[
1744233736,
"3"
],
[
1744239736,
"3"
],
[
1744245736,
"3"
],
[
1744251736,
"3"
],
[
1744257736,
"3"
],
[
1744263736,
"3"
],
[
1744269736,
"3"
],
[
1744275736,
"3"
]
]
}
]
}
}