node heatmap

Displays a heatmap for the specified nodes.

Syntax

CLI 
maprcli node heatmap
    [ -cluster <cluster> ]
    [ -filter <filter> ]
    [ -view <view> ]
    -json | -long
REST
Request Type GET
Request URL 
http[s]://<host>:<port>/rest/node/heatmap[?<parameters>]

Parameters

Parameter

Description

cluster

The cluster on which to run the command.

filter

A filter specifying snapshots to preserve. See Filters for more information.

view

Name of the heatmap view to show:

  • status = Node status (the default view):
    • 0 = Healthy
    • 1 = Needs attention
    • 2 = Degraded
    • 3 = Maintenance
    • 4 = Critical
  • cpu = CPU utilization, as a percent from 0-100.
  • memory = Memory utilization, as a percent from 0-100.
  • diskspace = MapR filesystem disk space utilization, as a percent from 0-100.
  • NODE_* = Status of various alarms: 0 if clear, 1 if raised. For example: NODE_ALARM_DISK_FAILURE or NODE_ALARM_SERVICE_CLDB_DOWN. You can return a complete list of supported alarm parameters by running:

    maprcli node heatmap -view

    See the lists of parameters below this table.
-json | -long This command returns multiple levels of data. You must specify either JSON format or "long" format to see the full output.

Alarm Parameters

You can view the status of a number of different alarms, including the status of alarms for services down and alarms for other conditions on the cluster.

Service Down Alarms

NODE_ALARM_SERVICE_CLDB_DOWN NODE_ALARM_SERVICE_FILESERVER_DOWN NODE_ALARM_SERVICE_JT_DOWN NODE_ALARM_SERVICE_TT_DOWN NODE_ALARM_SERVICE_HBMASTER_DOWN NODE_ALARM_SERVICE_HBREGION_DOWN NODE_ALARM_SERVICE_WEBSERVER_DOWN NODE_ALARM_SERVICE_NFS_DOWN NODE_ALARM_SERVICE_HOSTSTATS_DOWN NODE_ALARM_SERVICE_OOZIE_DOWN NODE_ALARM_SERVICE_HUE_DOWN NODE_ALARM_SERVICE_HTTPFS_DOWN NODE_ALARM_SERVICE_BEESWAX_DOWN NODE_ALARM_SERVICE_HIVEMETA_DOWN NODE_ALARM_SERVICE_HS2_DOWN

Other Alarms

NODE_ALARM_DEBUG_LOGGING NODE_ALARM_DISK_FAILURE NODE_ALARM_VERSION_MISMATCH NODE_ALARM_TIME_SKEW NODE_ALARM_ROOT_PARTITION_FULL NODE_ALARM_OPT_MAPR_FULL NODE_ALARM_CORE_PRESENT NODE_ALARM_HIGH_MFS_MEMORY NODE_ALARM_PAM_MISCONFIGURED NODE_ALARM_TT_LOCALDIR_FULL NODE_ALARM_NO_HEARTBEAT NODE_ALARM_MAPRUSER_MISMATCH NODE_ALARM_DUPLICATE_HOSTID NODE_ALARM_METRICS_WRITE_PROBLEM NODE_ALARM_TOO_MANY_CONTAINERS

Output

In general, the heatmap output looks like this (in JSON format).

{
            status:"OK",
            data: [{
            "{{rackTopology}}" : {
            "{{nodeName}}" : {{heatmapValue}},
            "{{nodeName}}" : {{heatmapValue}},
            "{{nodeName}}" : {{heatmapValue}},
            ...
            },
            "{{rackTopology}}" : {
            "{{nodeName}}" : {{heatmapValue}},
            "{{nodeName}}" : {{heatmapValue}},
            "{{nodeName}}" : {{heatmapValue}},
            ...
            },
            ...
            }]
            }
Table 1. Output Fields

Field

Description

rackTopology

The topology for a particular rack.

nodeName

The name of the node in question.

heatmapValue

The value of the metric specified in the view parameter for this node, as an integer.

Examples

Display a heat map with the node status (default view) for the default rack:

maprcli node heatmap -json
            {
            "timestamp":1422567293873,
            "timeofday":"2015-01-29 01:34:53.873 GMT-0800",
            "status":"OK",
            "total":1,
            "data":[
            {"/data/default-rack":{
            "centos24":2}
            }]
            }

The equivalent REST API command would be:

https://r1n1.sj.us:8443/rest/node/heatmap

Display memory usage for the default rack:

maprcli node heatmap -view memory -json
            {
            "timestamp":1422585976631,
            "timeofday":"2015-01-29 06:46:16.631 GMT-0800",
            "status":"OK",
            "total":1,
            "data":[
            {"/data/default-rack":{
            "centos24":71}
            }]
            }

The equivalent REST API command would be:

https://r1n1.sj.us:8443/rest/node/heatmap?view=memory

Display the value of NODE_ALARM_DISK_FAILURE for the default rack:

maprcli node heatmap -view NODE_ALARM_DISK_FAILURE -long
            /data/default-rack  
            {"centos24":0}