The nodes
command shows the cluster topology. For example
GET /_cat/nodes?v
Might look like:
ip heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name 127.0.0.1 65 99 42 3.07 mdi * mJw06l1
The first few columns (ip
, heap.percent
, ram.percent
, cpu
, load_*
) tell
you where your nodes live and give a quick picture of performance stats.
The last (node.role
, master
, and name
) columns provide ancillary
information that can often be useful when looking at the cluster as a whole,
particularly large ones. How many master-eligible nodes do I have?
The nodes
API accepts an additional URL parameter full_id
accepting true
or false
. The purpose of this parameter is to format the ID field (if
requested with id
or nodeId
) in its full length or in abbreviated form (the
default).
Below is an exhaustive list of the existing headers that can be
passed to nodes?h=
to retrieve the relevant details in ordered
columns. If no headers are specified, then those marked to Appear
by Default will appear. If any header is specified, then the defaults
are not used.
Aliases can be used in place of the full header name for brevity.
Columns appear in the order that they are listed below unless a
different order is specified (e.g., h=pid,id
versus h=id,pid
).
When specifying headers, the headers are not placed in the output
by default. To have the headers appear in the output, use verbose
mode (v
). The header name will match the supplied value (e.g.,
pid
versus p
). For example:
GET /_cat/nodes?v&h=id,ip,port,v,m
Might look like:
id ip port v m veJR 127.0.0.1 59938 7.0.1 *
Header | Alias | Appear by Default | Description | Example |
---|---|---|---|---|
|
| No | Unique node ID | k0zy |
|
| No | Process ID | 13061 |
|
| Yes | IP address | 127.0.1.1 |
|
| No | Bound transport port | 9300 |
|
| No | Bound http address | 127.0.0.1:9200 |
|
| No | Elasticsearch version | 7.0.1 |
|
| No | Elasticsearch Build hash | 5c03844 |
|
| No | Running Java version | 1.8.0 |
|
| No | Total disk space | 458.3gb |
|
| No | Used disk space | 259.8gb |
|
| No | Available disk space | 198.4gb |
|
| No | Used disk space percentage | 56.71 |
|
| No | Used heap | 311.2mb |
|
| Yes | Used heap percentage | 7 |
|
| No | Maximum configured heap | 1015.6mb |
|
| No | Used total memory | 513.4mb |
|
| Yes | Used total memory percentage | 47 |
|
| No | Total memory | 2.9gb |
|
| No | Used file descriptors | 123 |
|
| Yes | Used file descriptors percentage | 1 |
|
| No | Maximum number of file descriptors | 1024 |
| No | Recent system CPU usage as percent | 12 | |
|
| No | Most recent load average | 0.22 |
|
| No | Load average for the last five minutes | 0.78 |
|
| No | Load average for the last fifteen minutes | 1.24 |
|
| No | Node uptime | 17.3m |
|
| Yes | Master eligible node (m); Data node (d); Ingest node (i); Coordinating node only (-) | mdi |
|
| Yes | Elected master (*); Not elected master (-) | * |
|
| Yes | Node name | I8hydUG |
|
| No | Size of completion | 0b |
|
| No | Used fielddata cache memory | 0b |
|
| No | Fielddata cache evictions | 0 |
|
| No | Used query cache memory | 0b |
|
| No | Query cache evictions | 0 |
|
| No | Used request cache memory | 0b |
|
| No | Request cache evictions | 0 |
|
| No | Request cache hit count | 0 |
|
| No | Request cache miss count | 0 |
|
| No | Number of flushes | 1 |
|
| No | Time spent in flush | 1 |
|
| No | Number of current get operations | 0 |
|
| No | Time spent in get | 14ms |
|
| No | Number of get operations | 2 |
|
| No | Time spent in successful gets | 14ms |
|
| No | Number of successful get operations | 2 |
|
| No | Time spent in failed gets | 0s |
|
| No | Number of failed get operations | 1 |
|
| No | Number of current deletion operations | 0 |
|
| No | Time spent in deletions | 2ms |
|
| No | Number of deletion operations | 2 |
|
| No | Number of current indexing operations | 0 |
|
| No | Time spent in indexing | 134ms |
|
| No | Number of indexing operations | 1 |
|
| No | Number of failed indexing operations | 0 |
|
| No | Number of current merge operations | 0 |
|
| No | Number of current merging documents | 0 |
|
| No | Size of current merges | 0b |
|
| No | Number of completed merge operations | 0 |
|
| No | Number of merged documents | 0 |
|
| No | Size of current merges | 0b |
|
| No | Time spent merging documents | 0s |
|
| No | Number of refreshes | 16 |
|
| No | Time spent in refreshes | 91ms |
|
| No | Total script compilations | 17 |
|
| No | Total compiled scripts evicted from cache | 6 |
|
| No | Current fetch phase operations | 0 |
|
| No | Time spent in fetch phase | 37ms |
|
| No | Number of fetch operations | 7 |
|
| No | Open search contexts | 0 |
|
| No | Current query phase operations | 0 |
|
| No | Time spent in query phase | 43ms |
|
| No | Number of query operations | 9 |
|
| No | Open scroll contexts | 2 |
|
| No | Time scroll contexts held open | 2m |
|
| No | Completed scroll contexts | 1 |
|
| No | Number of segments | 4 |
|
| No | Memory used by segments | 1.4kb |
|
| No | Memory used by index writer | 18mb |
|
| No | Memory used by version map | 1.0kb |
|
| No | Memory used by fixed bit sets for nested object field types and type filters for types referred in | 1.0kb |
|
| No | Number of current suggest operations | 0 |
|
| No | Time spent in suggest | 0 |
|
| No | Number of suggest operations | 0 |