dump balancermetrics

Returns a cumulative count of container moves and MB of data moved between storage pools.

The maprcli dump balancermetrics command returns a cumulative count of container moves and MB of data moved between storage pools. You can run this command periodically to determine how much data has been moved by the disk space balancer between two intervals. Use the -json option when running dump balancermetrics from the command line for best results.

The disk space balancer is a tool that balances disk space usage on a cluster by moving containers between storage pools. Whenever a storage pool is over 70% full (or it reaches a threshold defined by the cldb.balancer.disk.threshold.percentage parameter), the disk space balancer distributes containers to other storage pools that have lower utilization than the average for that cluster. The disk space balancer aims to ensure that the percentage of space used on all the disks in the node is similar. For more information, see Disk Space Balancer.

Syntax

CLI
maprcli dump balancermetrics
    [-cluster <cluster name>]
REST
Request Type GET
Request URL
http[s]://<host>:<port>/rest/dump/balancermetrics?<parameters> 

Parameters

Parameter

Description

cluster

(Optional) The cluster on which to run the command. If you omit this parameter, the command uses the cluster on which it runs. In multi-cluster contexts, you can use this parameter to specify a different cluster to run the command.

Output

The maprcli dump balancermetrics command returns a cumulative count of container moves and MB of data moved between storage pools since the current CLDB became the master CLDB.

# maprcli dump balancermetrics -json
{
    "timestamp":1337770325979,
    "status":"OK",
    "total":1,
    "data":[
        {
            "numContainersMoved":10090,
            "numMBMoved":3147147,
            "timeOfLastMove": "Wed May 23 03:51:44 PDT 2012"
        }
    ]
}

Output fields

Field

Description

numContainersMoved

The number of containers moved between storage pools by the disk space balancer.

numMBMoved

The total MB of data moved between storage pools on the cluster.

timeOfLastMove

The date and time of most recent container move.

Example

CLI
maprcli dump balancermetrics -cluster 10.10.82.23 -json
REST
NOTE
When using a self-signed certificate, pass the -k option to curl to avoid the certificate check.
curl -k -u <username> -X GET https://abc.sj.us:8443/rest/dump/balancermetrics?cluster=10.10.82.23"