dashboard info
Displays a summary of information about the cluster.
Syntax
- CLI
-
maprcli dashboard info [ -cluster cluster name ] [ -zkconnect ZooKeeper Connect String: 'host:port,host:port,host:port,...' ] [ -version true|false. default: false ] [ -multi_cluster_info true|false. default: false ] -json
NOTEThe-json
option is required. - REST
-
Request Type GET Request URL http[s]://<host>:<port>/rest/dashboard/info[?<parameters>]
Parameters
Parameter |
Description |
---|---|
cluster |
(Optional) The cluster on which to run the command. By default, the cluster is the one on which this command is run. |
multi_cluster_info |
(Optional) Specifies whether to display cluster information from
multiple clusters. Values: |
version |
(Optional) Specifies whether to display ONLY the version
of the HPE Ezmeral Data Fabric. Values: true or
false . Default: false . |
zkconnect |
(Optional) Common Parameters |
json |
(Required) Formats the output. |
Output
The following table summarizes information about the services, volumes, MapReduce applications, health, and utilization of the cluster.
Output Fields
Field |
Description |
---|---|
timestamp |
The time at which the |
timeofday | The local time and date of the query. |
status |
The success status of the |
total |
The number of clusters for which data is queried in the |
version |
The data-fabric software version running on the cluster. |
cluster |
Determines the following information about the cluster:
|
volumes |
The number and size (in GiB) of volumes that are:
|
mirrors | Indicates whether this cluster is a mirror or is mirrored, and the details of the mirrors, if any. |
utilization |
The following summarizes utilization information:
|
clusterReplication |
The following cluster replication information:
|
streamThroughput |
The following stream throughput information:
|
label_stats | Information about the labels registered and assigned. |
services |
The number of active, stopped, failed, and total installed services on the cluster, for example:
|
Understanding how physical, logicalUsed, ecOffloaded data usage is calculated
Data usage calculations for physical, logicalUsed, and ecOffloaded can be calculated as shown in the following uncompressed and compressed scenarios.
Scenario:
- Vol3x is 3x replicated in the hot tier that uses 10+2 erasure coding
- Vol6x is 6x replicated in the hot tier that uses 4+2 erasure coding
If you write a 100GiB file uncompressed to each volume, for the two volumes: | |
logicalUsed = 200 | 100GiB+100GiB=200GiB |
replicatedLogicalUsed = 900 | 3*100GiB + 6*100GiB = 900GiB |
replicatedTotalUsed = 900 |
For 3x replicated volume: 3*(100/1)=300GiB For 6x replicated volume: 6*(100/1)=600GiB |
ecOffloaded = 0 | Nothing is offloaded to the warm tier. |
ecTotalUsed = 0 | Nothing is offloaded to the warm tier. |
If you offload both volumes to the warm tier: | |
logicalUsed = 200 | 200GiB |
replicatedLogicalUsed = 900 | Note that file data no longer resides on the hot tier, and physical disk space is not consumed. After it is offloaded, this number reflects the metadata of files that previously resided on the hot tier. |
replicatedTotalUsed = 900 | Note that file data no longer resides on the hot tier, and physical disk space is not consumed. After it is offloaded, this number reflects the metadata of files that previously resided on the hot tier. |
ecOffloaded = 200 | 100GiB+100GiB=200GiB |
ecTotalUsed = 270 | [100GiB * (10+2)/10] + [100GiB * (4+2)/4] = 120GiB + 150GiB = 270GiB |
If the 100GiB of logical data in Vol3x and Vol6x is compressed by a factor of 4:1 and writes a100GiB file to each volume: | |
logicalUsed = 200 | 100GiB+100GiB=200GiB |
replicatedLogicalUsed = 900 | (3*100GiB) + (6*100GiB)=900GiB |
replicatedTotalUsed = 225 |
For 3x replicated volume: 3*(100/4)=75GiB For 6x replicated volume: 6(100/4)=150GiB |
ecOffloaded = 0 | Nothing is offloaded to the warm tier. |
ecTotalUsed = 0 | Nothing is offloaded to the warm tier. |
If you offload both volumes to the warm tier: | |
logicalUsed equals | 200GiB |
replicatedLogicalUsed = 900 | Note that file data no longer resides on the hot tier, and physical disk space is not consumed. After it is offloaded, this number reflects the metadata of files that previously resided on the hot tier. |
replicatedTotalUsed = 900 | Note that file data no longer resides on the hot tier, and physical disk space is not consumed. After it is offloaded, this number reflects the metadata of files that previously resided on the hot tier. |
ecOffloaded = 50 | (100GiB+100GiB)/4=50GiB |
ecTotalUsed = 68 | (100GiB/4) * ((10+2)/10) + (100GiB/4) * ((4+2)/4) = 30GiB+37.5GiB = 67.5GiB |
Examples
Display dashboard information:
- CLI
-
maprcli dashboard info -json { "timestamp":1599138960056, "timeofday":"2020-09-03 06:16:00.056 GMT-0700 AM", "status":"OK", "total":1, "data":[ { "version":"6.2.0.0.20200823204949.GA", "cluster":{ "name":"my.cluster.com", "secure":true, "dare":false, "globalPolicyMaster":true, "ip":"10.163.167.212", "id":"2812007637544940359", "nodesUsed":1, "totalNodesAllowed":-1 }, "volumes":{ "mounted":{ "total":17, "size":6605 }, "unmounted":{ "total":2, "size":1 } }, "mirrors":{ "num jobs":0, "active containers":0, "resync containers":0, "mirrored datasize mb":0, "remaining datasize mb":0, "completion pcnt":0 }, "utilization":{ "cpu":{ "util":21, "total":8, "active":1 }, "memory":{ "total":23911, "active":23075 }, "disk_space":{ "total":287, "active":6 }, "compression":{ "compressed":6, "uncompressed":6 }, "tiering":{ "logicalUsed":0, "replicatedLogicalUsed":0, "replicatedTotalUsed":0, "metaDBUsedMB":0, "replicatedMetaDBUsedMB":0, "offloaded":0, "recalled":0, "cvTotalUsed":0, "replicatedCvTotalUsed":0, "ecOffloaded":0, "ecRecalled":0, "ecTotalUsed":0 } }, "clusterReplication":{ "bytesReceived":0, "bytesSend":0 }, "streamThroughput":{ "bytesProduced":46746456005, "bytesConsumed":46748653475 }, "labels_stats":[ { "label":"ssd", "label_id":0, "total_size":294465, "used":7045, "num_sps":1, "num_volumes":19 }, { "label":"anywhere", "label_id":2147483647, "total_size":0, "used":0, "num_sps":0, "num_volumes":0 } ], "services":{ "hbaserest":{ "active":1, "stopped":0, "failed":0, "total":1 }, "hbasethrift":{ "active":1, "standby":0, "stopped":0, "failed":0, "total":1 }, "fileserver":{ "active":1, "stopped":0, "failed":0, "total":1 }, "grafana":{ "active":1, "stopped":0, "failed":0, "total":1 }, "cldb":{ "active":1, "stopped":0, "failed":0, "total":1 }, "mastgateway":{ "active":1, "stopped":0, "failed":0, "total":1 }, "opentsdb":{ "active":1, "stopped":0, "failed":0, "total":1 }, "gateway":{ "active":1, "stopped":0, "failed":0, "total":1 }, "hoststats":{ "active":1, "stopped":0, "failed":0, "total":1 }, "collectd":{ "active":1, "stopped":0, "failed":0, "total":1 }, "apiserver":{ "active":1, "stopped":0, "failed":0, "total":1 } } } ] }
- REST
-
curl -u <username> -X GET https://server.sj.us:8443/rest/dashboard/info
View the master security policy cluster:
- CLI
-
maprcli dashboard info -json | grep globalPolicyMaster { "globalPolicyMaster":true }