volume tierstats

Retrieves statistics on the offload and recall operation.

Permissions Required

The user running the command must have one of the following:

  • Full control (fc) on the cluster or volume
  • Volume edit permissions

Syntax

CLI
maprcli volume tierstats
            [ -cluster cluster_name ]
            -name <volume_name>
REST
Request Type GET
Request URL
http[s]://<host>:<port>/rest/volume/tierstats?<parameters>

Parameters

Parameter

Description

cluster The name of the cluster on which to run the command.
name The name of the volume.

Output

The command returns the following:

offloadThroughput The amount of data (in MB) offloaded per second.
totalTierDataSize The total size of tiered data (in MB).
totalTierReclaimableSize The size of deleted data (in MB) that is under the compaction operation threshold.
recallThroughput The amount of data (in MB) recalled per second.

Example

Retrieve statistics for a volume specified by name:

# /opt/mapr/bin/maprcli volume tierstats -name sampleVol -json
{
	"timestamp":1520275614872,
	"timeofday":"2018-03-05 06:46:54.872 GMT+0000",
	"status":"OK",
	"total":1,
	"data":[
		{
			"totalTierDataSize":"404.323 MB",
			"offloadThroughput":"17.063 MB/s",
			"recallThroughput":"14.071 MB/s"
		}
	]
}
curl -X GET 'https://server.sj.us:8443/rest/volume/tierstats?name=sampleVol' --user <username>:<password>
{"timestamp":1520275614872,"timeofday":"2018-03-05 06:46:54.872 GMT+0000","status":"OK","total":1,"data":[{"totalTierDataSize":"404.323 MB","offloadThroughput":"17.063 MB/s","recallThroughput":"14.071 MB/s"}]}

Retrieve statistics for a volume after a compaction operation:

# maprcli volume tierstats -name test1 -json
{
    	"timestamp":1527048672887,
    	"timeofday":"2018-05-23 04:11:12.887 GMT+0000 AM",
    	"status":"OK",
    	"total":1,
    	"data":[
            	{
                    	"totalTierDataSize":"3001.926 MB",
                    	"totalTierReclaimableSize":"100 MB",
                    	"offloadThroughput":"31.064 MB/s"
            	}
    	]
}
curl -X GET 'https://server.sj.us:8443/rest/volume/tierstatus?name=test1' --user <username>:<password>
{"timestamp":1527048672887,"timeofday":"2018-05-23 04:11:12.887 GMT+0000 AM","status":"OK","total":1,"data":[{"totalTierDataSize":"3001.926 MB","totalTierReclaimableSize":"100 MB","offloadThroughput":"31.064 MB/s"}]}