Get node information
Get information about the nodes in a cluster. IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
Query parameters
-
bytes string
The unit used to display byte values.
Values are
b
,kb
,mb
,gb
,tb
, orpb
. -
full_id boolean | string
If
true
, return the full node ID. Iffalse
, return the shortened node ID. -
include_unloaded_segments boolean
If true, the response includes information from segments that are not loaded into memory.
-
master_timeout string
Period to wait for a connection to the master node.
-
time string
Unit used to display time values.
Values are
nanos
,micros
,ms
,s
,m
,h
, ord
.
GET
/_cat/nodes
curl \
-X GET http://api.example.com/_cat/nodes
Response examples (200)
[
{
"id": "string",
"pid": "string",
"ip": "string",
"port": "string",
"http_address": "string",
"version": "string",
"flavor": "string",
"type": "string",
"build": "string",
"jdk": "string",
"": "string",
"heap.current": "string",
"heap.max": "string",
"ram.current": "string",
"ram.max": "string",
"file_desc.current": "string",
"file_desc.max": "string",
"cpu": "string",
"load_1m": "string",
"load_5m": "string",
"load_15m": "string",
"uptime": "string",
"node.role": "string",
"master": "string",
"name": "string",
"completion.size": "string",
"fielddata.memory_size": "string",
"fielddata.evictions": "string",
"query_cache.memory_size": "string",
"query_cache.evictions": "string",
"query_cache.hit_count": "string",
"query_cache.miss_count": "string",
"request_cache.memory_size": "string",
"request_cache.evictions": "string",
"request_cache.hit_count": "string",
"request_cache.miss_count": "string",
"flush.total": "string",
"flush.total_time": "string",
"get.current": "string",
"get.time": "string",
"get.total": "string",
"get.exists_time": "string",
"get.exists_total": "string",
"get.missing_time": "string",
"get.missing_total": "string",
"indexing.delete_current": "string",
"indexing.delete_time": "string",
"indexing.delete_total": "string",
"indexing.index_current": "string",
"indexing.index_time": "string",
"indexing.index_total": "string",
"indexing.index_failed": "string",
"merges.current": "string",
"merges.current_docs": "string",
"merges.current_size": "string",
"merges.total": "string",
"merges.total_docs": "string",
"merges.total_size": "string",
"merges.total_time": "string",
"refresh.total": "string",
"refresh.time": "string",
"refresh.external_total": "string",
"refresh.external_time": "string",
"refresh.listeners": "string",
"script.compilations": "string",
"script.cache_evictions": "string",
"script.compilation_limit_triggered": "string",
"search.fetch_current": "string",
"search.fetch_time": "string",
"search.fetch_total": "string",
"search.open_contexts": "string",
"search.query_current": "string",
"search.query_time": "string",
"search.query_total": "string",
"search.scroll_current": "string",
"search.scroll_time": "string",
"search.scroll_total": "string",
"segments.count": "string",
"segments.memory": "string",
"segments.index_writer_memory": "string",
"segments.version_map_memory": "string",
"segments.fixed_bitset_memory": "string",
"suggest.current": "string",
"suggest.time": "string",
"suggest.total": "string",
"bulk.total_operations": "string",
"bulk.total_time": "string",
"bulk.total_size_in_bytes": "string",
"bulk.avg_time": "string",
"bulk.avg_size_in_bytes": "string"
}
]
Response examples (200)
Default columns
A successful response from `GET /_cat/nodes?v=true`. The `ip`, `heap.percent`, `ram.percent`, `cpu`, and `load_*` columns provide the IP addresses and performance information of each node. The `node.role`, `master`, and `name` columns provide information useful for monitoring an entire cluster, particularly large ones.
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 dim * mJw06l1
A successful response from `GET /_cat/nodes?v=true&h=id,ip,port,v,m`. It returns the `id`, `ip`, `port`, `v` (version), and `m` (master) columns.
id ip port v m
veJR 127.0.0.1 59938 8.17.0 *