# 查看监控指标 #### 功能介绍 查看监控指标，支持节点指标和图实例性能监控指标。 #### URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/om/metrics?real_time=\&with_performance_metrics=true 表1路径参数 | 参数 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-ges/ges_03_0111.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值：** 不涉及。 | | graph_name | 是 | String | **参数解释：** 图名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | real_time | 否 | Boolean | 是否查询实时监控指标，取值为true或者false， 默认为false。 - false：会查询图实例2分钟内的指标。 - true：会查询实时监控指标，请求响应在3-5秒之间。 | | with_performance_metrics | 否 | Boolean | 是否查询性能指标，会返回图实例性能指标和各个节点的指标。取值为true或者false，默认为true，如果设置为false，只返回节点的指标，响应时间会减少1-2秒。 | #### 请求参数 无 #### 响应参数 表3响应Body参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | errorMessage | String | 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误信息。 | | errorCode | String | 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误码。 | | project_id | String | 项目ID。 | | id | String | 图ID。 | | name | String | 图名称。 | | timestamp | long | 当前时间戳。 | | node_metrics | Array of objects | 节点指标。 | | performance_metrics | Object | 性能指标。 | 表4node_metrics参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | overview | Object | 节点总览。 | | disk_details | Array of objects | 节点磁盘详情。 | | network_details | Array of objects | 节点网络详情。 | 表5overview参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | ges_instance_name | String | 节点名称。 | | instance_id | String | 节点ID。 | | work_ip | String | 节点ip。 | | role | String | 节点角色。 | | cpu_usage | Double | CPU使用率。 | | cpu_usage_usr | Double | CPU用户态使用率。 | | cpu_usage_sys | Double | CPU内核态使用率。 | | cpu_iowait | Double | CPU IO等待率。 | | cpu_idle | Double | CPU空闲率。 | | mem_total | Double | 内存总量，单位为GB。 | | mem_usage | Double | 内存使用量，单位为GB。 | | mem_free | Double | 内存可用量，单位为GB。 | | mem_cached | Double | 内存缓存量，单位为GB。 | | mem_buffer | Double | 内存缓冲量，单位为GB。 | | disk_total | Double | 磁盘总容量，单位为GB。 | | disk_usage_avg | Double | 磁盘平均使用率。 | | disk_used | Double | 磁盘使用量，单位为GB。 | | disk_available | Double | 可用磁盘总量，单位为GB。 | | disk_io_read | Double | 节点磁盘读速率，单位为KB/S。 | | disk_io_write | Double | 节点磁盘写速率，单位为KB/S。 | | disk_io | Double | 节点磁盘总读写速率。 | | swap_total | Double | 节点swap盘总量。 | | swap_free | Double | 节点swap盘剩余量。 | | network_io_rate | Double | 节点网络IO速率，单位为KB/S。 | | host_stat | String | 节点状态。 | | host_name | String | 节点名称。 | 表6disk_details参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | disk_name | String | 磁盘名称。 | | disk_type | String | 磁盘类型。 | | total | Double | 磁盘总量。 | | available | Double | 磁盘可用量。 | | used | Double | 磁盘使用量。 | | used_percentage | Double | 磁盘使用百分比。 | | svctm | Long | 磁盘IO服务时间，时间为ms。 | | await | Double | 磁盘IO等待时间，时间为ms。 | | util | Double | 磁盘IO使用率。 | | write_rate | Double | 磁盘读速率。 | | read_rate | Double | 磁盘写速率。 | 表7network_details参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | status | Integer | 网卡状态。 | | interface_name | String | 网卡名称。 | | packets_recv | Long | 接受包个数。 | | packets_send | Long | 发送包个数。 | | packets_drop | Long | 丢弃包个数。 | | send_rate | Double | 发送速率，单位为KB/S。 | | recv_rate | Double | 接收速率，单位为KB/S。 | 表8performance_metrics参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | cpu_usage | Double | CPU使用率。 | | memory_usage | Double | 内存使用率。 | | disk_usage | Double | 磁盘平均使用率。 | | disk_io_rate | Double | 磁盘IO速率。 | | network_io_rate | Double | 网络IO速率。 | | tomcat_connections_usage | Double | tomcat连接数使用率。 | | qps | Long | 每秒请求个数。 | | storage_usage | Double | 图存储使用率。 | | graph_name | String | 图实例名称。 | | jvm_heap_usage | Double | java堆内存使用率。 | #### 请求示例 ``` GET http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/om/metrics?real_time=true ``` #### 响应示例 **状态码： 200** 成功响应示例 ``` { "node_metrics": [ { "overview": { "network_io_rate": 8.51, "role": "ges-dispatch", "disk_io_write": 84.74, "mem_cached": 1.99, "cpu_usage_usr": 2.4, "cpu_usage_sys": 0.72, "disk_io_read": 3.99, "ges_instance_name": "ges_fdb_old-ges-dispatch-cn-1-1", "disk_used": 5.75, "swap_total": 0.0, "mem_buffer": 251.93, "disk_available": 244.15, "cpu_iowait": 0.04, "cpu_idle": 96.83, "disk_io": 88.73, "mem_total": 31.19, "instance_id": "e8d67304-6107-4935-9fe3-6cabf3d32adc", "mem_usage": 9.69, "disk_total": 249.9, "host_stat": "200", "mem_free": 25.94, "swap_free": 0.0, "cpu_usage": 3.12, "disk_usage_avg": 2.3, "work_ip": "172.16.29.231", "host_name": "ges_fdb_old-ges-dispatch-cn-1-1" }, "disk_details": [ { "svctm": 0.0, "total": 50.0, "util": 0.07, "write_rate": 65.59, "disk_name": "vda", "disk_type": "system", "used_percentage": 5.54, "available": 47.23, "await": 15.7, "read_rate": 3.84, "used": 2.77 }, { "svctm": 0.0, "total": 99.95, "util": 0.09, "write_rate": 18.14, "disk_name": "vdb", "disk_type": "data", "used_percentage": 2.79, "available": 97.17, "await": 40.31, "read_rate": 0.06, "used": 2.78 }, { "svctm": 0.0, "total": 99.95, "util": 0.11, "write_rate": 1.01, "disk_name": "vdc", "disk_type": "log", "used_percentage": 0.19, "available": 99.76, "await": 2.14, "read_rate": 0.09, "used": 0.19 } ], "network_details": [ { "send_rate": 0.08, "packets_drop": 0, "packets_recv": 698597, "packets_send": 108397, "interface_name": "eth0", "recv_rate": 0.06, "status": 1 }, { "send_rate": 0.0, "packets_drop": 0, "packets_recv": 25766, "packets_send": 21486, "interface_name": "eth1", "recv_rate": 0.0, "status": 1 }, { "send_rate": 5.33, "packets_drop": 0, "packets_recv": 2012566, "packets_send": 3091470, "interface_name": "eth2", "recv_rate": 3.04, "status": 1 } ] } ], "performance_metrics": { "tomcat_connections_usage": 0.14, "network_io_rate": 10847.12, "graph_name": "ges_fdb_old", "disk_io_rate": 115.34, "qps": 0, "storage_usage": 0.63, "disk_usage": 2.98, "memory_usage": 29.92, "cpu_usage": 5.75, "jvm_heap_usage": 68.31 }, "project_id": "3571fe9ff5dc415d99adef84b6488e3b", "name": "ges_fdb_old", "id": "3518bb16-74b3-4259-a1d0-f38c2836cd11", "timestamp": 1733880320828 } ``` **状态码： 400** 失败响应示例 ``` Http Status Code: 400 { "errorMessage": "graph ges_fdb is not exist.", "errorCode": "GES.8000" } ``` #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。