文档首页/图引擎服务 GES/API参考/业务面API/持久化版/运维监控API/查看监控指标
更新时间：2025-12-19 GMT+08:00
查看PDF
分享

查看监控指标

功能介绍

查看监控指标，支持节点指标和图实例性能监控指标。

URI

GET /ges/v1.0/{project_id}/graphs/{graph_name}/om/metrics?real_time=&with_performance_metrics=true

表1 路径参数

参数

是否必选

类型

说明

project_id

是

String

参数解释：

项目编号。获取方法，请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及。

graph_name

是

String

图名称。

表2 Query参数

参数

是否必选

参数类型

描述

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

性能指标。

表4 node_metrics参数说明

参数

类型

说明

overview

Object

节点总览。

disk_details

Array of objects

节点磁盘详情。

network_details

Array of objects

节点网络详情。

表5 overview参数说明

参数

类型

说明

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

节点名称。

表6 disk_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

磁盘写速率。

表7 network_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。

表8 performance_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"
}

错误码

请参见错误码。

父主题：运维监控API