This is documentation for MapR Version 5.0. You can also refer to MapR documentation for the latest release.

Skip to end of metadata
Go to start of metadata

Retrieves metrics information for nodes in a cluster.



This command retrieves and displays various metrics related to the operation of nodes. The data displayed comes from the files that each node updates periodically that are stored in the node local volume on each node in the cluster.

Syntax

CLI

maprcli node metrics
	 -nodes <hostname>
	 -start <start time>
	 -end <end time>
	[ -json ]
	[ -interval <interval timestamp> ]
	[ -events ]
	[ -columns <column names> ]
	[ -cluster <cluster name> ] 

Parameters



Parameter

Description

nodes

A space-separated list of host names. The host name must be either the specific hostname (use the maprcli node list -columns hostname command to obtain the hostname value) or the name "hostname" if using the command line on the actual node. The IP address and "localhost" can not be used.

start

The start of the time range. Can be a UTC timestamp (in this case, a Java millisecond timestamp) or a UTC date in MM/DD/YY or MM/DD/YYYY format.

end

The end of the time range. Can be a UTC timestamp (in this case, a Java millisecond timestamp) or a UTC date in MM/DD/YY or MM/DD/YYYY format.

json

Specify this flag to return data as a JSON object.

interval

Data measurement interval in seconds. The minimum value is 10 seconds.

events

Specify TRUE to return node events only. The default value of this parameter is FALSE.

columns

Comma-separated list of column names to return.

cluster

Cluster name.

Column Name Parameters

The node metrics API always returns the NODE (node name) and TIMESTAMP (integer timestamp) columns. Use the -columns flag to specify a comma-separated list of column names to return.

Icon

The CPUNICE, CPUUSER, and CPUSYSTEM parameters return information in jiffies. This unit measures one tick of the system timer interrupt and is usually equivalent to 10 milliseconds, but may vary depending on your particular node configuration. The reporting interval is the maximum possible value. In addition, the CPU* parameters accumulate and do not reset from report to report. Call sysconf(_SC_CLK_TCK) to determine the exact value for your node.

Parameter

Description

Notes

CPUNICE

Amount of CPU time used by processes with a positive nice value.

 

CPUUSER

Amount of CPU time used by user processes.

 

CPUSYSTEM

Amount of CPU time used by system processes.

 

LOAD5PERCENT

Percentage of time this node spent at load 5 or below

 

LOAD1PERCENT

Percentage of time this node spent at load 1 or below

 

MEMORYCACHED

Memory cache size in bytes

 

MEMORYSHARED

Shared memory size in bytes

 

MEMORYBUFFERS

Memory buffer size in bytes

 

MEMORYUSED

Memory used in megabytes

 

PROCRUN

Number of processes running

 

RPCCOUNT

Number of MapR RPC calls

 

RPCINBYTES

Number of bytes passed in by MapR RPC calls

 

RPCOUTBYTES

Number of bytes passed out by MapR RPC calls

 

SERVAVAILSIZEMB

Server storage available in megabytes

 

SERVUSEDSIZEMB

Server storage used in megabytes

 

SWAPFREE

Free swap space in bytes

 

TTMAPUSED

Number of TaskTracker slots used for map tasks

 

TTREDUCEUSED

Number of TaskTracker slots used for reduce tasks

 

Three column name parameters return data that is too granular to display in a standard table. Use the -json option to return this information as a JSON object.

Parameter

Description

Metrics Returned

CPUS

Activity on this node's CPUs. Each CPU on the node is numbered from zero, cpu0 to cpuN. Metrics returned are for each CPU.

CPUIDLE: Amount of CPU time spent idle. Reported as jiffies.
CPUIOWAIT: Amount of CPU time spent waiting for I/O operations. Reported as jiffies.
CPUTOTAL: Total amount of CPU time. Reported as jiffies.

DISKS

Activity on this node's disks. Metrics returned are for each partition.

READOPS: Number of read operations.
READKB: Number of kilobytes read.
WRITEOPS: Number of write operations.
WRITEKB: Number of kilobytes written.

NETWORK

Activity on this node's network interfaces. Metrics returned are for each interface.

BYTESIN: Number of bytes received.
BYTESOUT: Number of bytes sent.
PKTSIN: Number of packets received.
PKTSOUT: Number of packets sent.

Examples

Retrieving the percentage of time that a node spent at the 1 and 5 load levels between dates

Sample Output

Retrieving time percentage at load 1 and 5 levels and CPU usage between timestamps

 

Sample JSON output

 

Retrieving data at the 1 and 5 load levels to the last even hour

Sample Output

  • No labels