clusterLoad

URI

<serverStatus uri>/clusterload[.<format>]

支持的方法

GET、HEAD

父资源

serverStatus

子资源

clusterMemberLoad

介绍

clusterLoad 为集群负载监控资源，通过它可以对集群状态进行监控，包括集群内各个子节点的运行状况与并发请求访问量。通过子节点的监控，可以查看集群体系中各个子节点的当前并发访问量，也可以查看各个子节点平均的访问量。而服务器监控的内容包括指定服务组件的访问量、指定服务实例的访问量。

支持的方法：

GET：获取集群系统并发请求信息，包括集群内各个子节点的运行状况与并发请求访问量等。
HEAD：检查 clusterLoad 资源是否存在，或权限是否可以访问 clusterLoad 资源。

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/manager/serverstatus/clusterload.rjson

GET 请求

获取集群系统并发请求信息，包括集群内各个子节点的运行状况与并发请求访问量等。

请求参数

对 clusterLoad 资源执行 GET 请求，可以在 URI 中包含相关参数，参数如下所示：

名称	类型	含义
componentName	String	服务组件名称，该参数可以单独使用。
interfaceName	String	服务接口名称，该参数不等单独使用，必须和 componentName 参数一起使用。

响应结构

对 clusterLoad 资源执行 GET 请求，返回的是整个集群系统并发请求详细信息，其中单个子节点的表述结构如下：

字段	类型	说明
averageTime	int	服务器平均响应时间，单位为秒。
currentCount	int	服务器当前并发数。
historicalAccessCounts	int[]	记录了从当前时刻起，前 5 分钟内服务器的并发数。
interval	int	服务访问统计时间间隔，默认为 1 秒。
ip	String	服务器的 ip 地址。
memberId	String	子节点的 ID 。
port	int	服务器的端口号。

响应示例

对 clusterLoad 资源 http://localhost:8090/iserver/manager/serverstatus/clusterload.rjson 执行 GET 请求，返回 rjson 格式的响应结果如下：

[ { "averageTime": 0, "currentCount": 0, "historicalAccessCounts": null, "interval": 1, "ip": "192.168.17.182", "memberId": "f4a5f3f05619478caad7c8b51000827d", "port": 8090 }, { "averageTime": 0, "currentCount": 0, "historicalAccessCounts": [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 5, 1, 3, 5, 7, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 4, 3, 2, 2, 3, 1, 1, 0, 0, 1, 0 ], "interval": 1, "ip": "192.168.17.16", "memberId": "7db62a86361e48b3aba3a8797468efe3", "port": 8091 }, { "averageTime": 0, "currentCount": 0, "historicalAccessCounts": [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 2, 4, 6, 6, 6, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 3, 4, 1, 4, 2, 1, 1, 3, 1, 0, 1, 4 ], "interval": 1, "ip": "192.168.17.16", "memberId": "20b012afb12640ab968df28a67cfd69e", "port": 8090 } ]

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 clusterLoad 资源是否存在，或者客户端是否有权限访问 clusterLoad 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 clusterLoad 资源是否支持<format>格式的表述。