[[cluster-nodes-stats]]
=== Nodes stats API

++++
<titleabbrev>Nodes stats</titleabbrev>
++++

..New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-cluster[Cluster APIs].
--

Returns cluster nodes statistics.

[[cluster-nodes-stats-api-request]]
==== {api-request-title}

`GET /_nodes/stats` +

`GET /_nodes/<node_id>/stats` +

`GET /_nodes/stats/<metric>` +

`GET /_nodes/<node_id>/stats/<metric>` +

`GET /_nodes/stats/<metric>/<index_metric>` +

`GET /_nodes/<node_id>/stats/<metric>/<index_metric>`

[[cluster-nodes-stats-api-prereqs]]
==== {api-prereq-title}

* If the {es} {security-features} are enabled, you must have the `monitor` or
`manage` <<privileges-list-cluster,cluster privilege>> to use this API.

[[cluster-nodes-stats-api-desc]]
==== {api-description-title}

You can use the cluster nodes stats API to retrieve statistics for nodes in a cluster.

All the nodes selective options are explained <<cluster-nodes,here>>.

By default, all stats are returned.
You can limit the returned information by using metrics.

[[cluster-nodes-stats-api-path-params]]
==== {api-path-parms-title}

`<metric>`::
(Optional, string) Limits the information returned to the specific metrics.
A comma-separated list of the following options:
+
--
`adaptive_selection`::
Statistics about <<search-adaptive-replica,adaptive replica selection>>.

`allocations`::
Statistics about allocated shards

`breaker`::
Statistics about the field data circuit breaker.

`discovery`::
Statistics about the discovery.

`fs`::
File system information, data path, free disk space, read/write stats.

`http`::
HTTP connection information.

`indexing_pressure`::
Statistics about the node's indexing load and related rejections.

`indices`::
Indices stats about size, document count, indexing and deletion times, search times, field cache size, merges and flushes.

`ingest`::
Statistics about ingest preprocessing.

`jvm`::
JVM stats, memory pool information, garbage collection, buffer pools, number of loaded/unloaded classes.

`os`::
Operating system stats, load average, mem, swap.

`process`::
Process statistics, memory consumption, cpu usage, open file descriptors.

`repositories`::
Statistics about snapshot repositories.

`thread_pool`::
Statistics about each thread pool, including current size, queue and rejected tasks.

`transport`::
Transport statistics about sent and received bytes in cluster communication.
--

`<index_metric>`::
(Optional, string) Limit the information returned for `indices` metric to the specific index metrics.
It can be used only if `indices` (or `all`) metric is specified.
Supported metrics are:
+
--
* `bulk`
* `completion`
* `docs`
* `fielddata`
* `flush`
* `get`
* `indexing`
* `mappings`
* `merge`
* `query_cache`
* `recovery`
* `refresh`
* `request_cache`
* `search`
* `segments`
* `shard_stats`
* `store`
* `translog`
* `warmer`
* `dense_vector`
* `sparse_vector`
--

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=node-id]

[[cluster-nodes-stats-api-query-params]]
==== {api-query-parms-title}

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=completion-fields]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=fielddata-fields]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=fields]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=groups]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=level]

`types`::
(Optional, string) A comma-separated list of document types for the
`indexing` index metric.

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=timeout-nodes-request]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=include-segment-file-sizes]

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=include-unloaded-segments]

[role="child_attributes"]
[[cluster-nodes-stats-api-response-body]]
==== {api-response-body-title}

`_nodes`::
(object) Contains statistics about the number of nodes selected by the request.
+
.Properties of `_nodes`
[%collapsible%open]
====
`total`::
(integer) Total number of nodes selected by the request.

`successful`::
(integer) Number of nodes that responded successfully to the request.

`failed`::
(integer) Number of nodes that rejected the request or failed to respond.
If this value is not `0`, a reason for the rejection or failure is included in the response.

====

`cluster_name`::
(string) Name of the cluster.
Based on the <<cluster-name>> setting.

`nodes`::
(object) Contains statistics for the nodes selected by the request.
+
.Properties of `nodes`
[%collapsible%open]
====

`<node_id>`::
(object) Contains statistics for the node.
+
.Properties of `<node_id>`
[%collapsible%open]
=====
`timestamp`::
(integer) Time the node stats were collected for this response.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`name`::
(string) Human-readable identifier for the node.
Based on the <<node-name>> setting.

`transport_address`::
(string) Host and port for the <<transport-settings,transport layer>>, used for internal communication between nodes in a cluster.

`host`::
(string) Network host for the node, based on the <<network.host>> setting.

`ip`::
(string) IP address and port for the node.

`roles`::
(array of strings) Roles assigned to the node.
See <<modules-node>>.

`attributes`::
(object) Contains a list of attributes for the node.

[[cluster-nodes-stats-api-response-body-indices]]
`indices`::
(object) Contains statistics about indices with shards assigned to the node.
+
.Properties of `indices`
[%collapsible%open]
======
`docs`::
(object) Contains statistics about documents across all primary shards assigned to the node.
+
.Properties of `docs`
[%collapsible%open]
=======
`count`::
(integer)
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=docs-count]

`deleted`::
(integer)
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=docs-deleted]

=======

`store`::
(object) Contains statistics about the size of shards assigned to the node.
+
.Properties of `store`
[%collapsible%open]
=======

`size`::
(<<byte-units,byte value>>) Total size of all shards assigned to the node.

`size_in_bytes`::
(integer) Total size, in bytes, of all shards assigned to the node.

`total_data_set_size`::
(<<byte-units,byte value>>) Total data set size of all shards assigned to the node.
This includes the size of shards not stored fully on the node, such as the cache for <<partially-mounted,partially mounted indices>>.

`total_data_set_size_in_bytes`::
(integer) Total data set size, in bytes, of all shards assigned to the node.
This includes the size of shards not stored fully on the node, such as the cache for <<partially-mounted,partially mounted indices>>.

`reserved`::
(<<byte-units,byte value>>) A prediction of how much larger the shard stores on this node will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
A value of `-1b` indicates that this is not available.

`reserved_in_bytes`::
(integer) A prediction, in bytes, of how much larger the shard stores on this node will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
A value of `-1` indicates that this is not available.

=======

`indexing`::
(object) Contains statistics about indexing operations for the node.
+
.Properties of `indexing`
[%collapsible%open]
=======

`index_total`::
(integer) Total number of indexing operations.

`index_time`::
(<<time-units,time value>>) Total time spent performing indexing operations.

`index_time_in_millis`::
(integer) Total time in milliseconds spent performing indexing operations.

`index_current`::
(integer) Number of indexing operations currently running.

`index_failed`::
(integer) Number of failed indexing operations.

`delete_total`::
(integer) Total number of deletion operations.

`delete_time`::
(<<time-units,time value>>) Time spent performing deletion operations.

`delete_time_in_millis`::
(integer) Time in milliseconds spent performing deletion operations.

`delete_current`::
(integer) Number of deletion operations currently running.

`noop_update_total`::
(integer) Total number of noop operations.

`is_throttled`::
(Boolean) Number of times operations were throttled.

`throttle_time`::
(<<time-units,time value>>) Total time spent throttling operations.

`throttle_time_in_millis`::
(integer) Total time in milliseconds spent throttling operations.

`write_load`::
(double) Average number of write threads used while indexing documents.

=======

`get`::
(object) Contains statistics about get operations for the node.
+
.Properties of `get`
[%collapsible%open]
=======

`total`::
(integer) Total number of get operations.

`getTime`::
(<<time-units,time value>>) Time spent performing get operations.

`time_in_millis`::
(integer) Time in milliseconds spent performing get operations.

`exists_total`::
(integer) Total number of successful get operations.

`exists_time`::
(<<time-units,time value>>) Time spent performing successful get operations.

`exists_time_in_millis`::
(integer) Time in milliseconds spent performing successful get operations.

`missing_total`::
(integer) Total number of failed get operations.

`missing_time`::
(<<time-units,time value>>) Time spent performing failed get operations.

`missing_time_in_millis`::
(integer) Time in milliseconds spent performing failed get operations.

`current`::
(integer) Number of get operations currently running.

=======

`search`::
(object) Contains statistics about search operations for the node.
+
.Properties of `search`
[%collapsible%open]
=======

`open_contexts`::
(integer) Number of open search contexts.

`query_total`::
(integer) Total number of query operations.

`query_time`::
(<<time-units,time value>>) Time spent performing query operations.

`query_time_in_millis`::
(integer) Time in milliseconds spent performing query operations.

`query_current`::
(integer) Number of query operations currently running.

`fetch_total`::
(integer) Total number of fetch operations.

`fetch_time`::
(<<time-units,time value>>) Time spent performing fetch operations.

`fetch_time_in_millis`::
(integer) Time in milliseconds spent performing fetch operations.

`fetch_current`::
(integer) Number of fetch operations currently running.

`scroll_total`::
(integer) Total number of scroll operations.

`scroll_time`::
(<<time-units,time value>>) Time spent performing scroll operations.

`scroll_time_in_millis`::
(integer) Time in milliseconds spent performing scroll operations.

`scroll_current`::
(integer) Number of scroll operations currently running.

`suggest_total`::
(integer) Total number of suggest operations.

`suggest_time`::
(<<time-units,time value>>) Time spent performing suggest operations.

`suggest_time_in_millis`::
(integer) Time in milliseconds spent performing suggest operations.

`suggest_current`::
(integer) Number of suggest operations currently running.

=======

`merges`::
(object) Contains statistics about merge operations for the node.
+
.Properties of `merges`
[%collapsible%open]
=======

`current`::
(integer) Number of merge operations currently running.

`current_docs`::
(integer) Number of document merges currently running.

`current_size`::
(<<byte-units,byte value>>) Memory used performing current document merges.

`current_size_in_bytes`::
(integer) Memory, in bytes, used performing current document merges.

`total`::
(integer) Total number of merge operations.

`total_time`::
(<<time-units,time value>>) Total time spent performing merge operations.

`total_time_in_millis`::
(integer) Total time in milliseconds spent performing merge operations.

`total_docs`::
(integer) Total number of merged documents.

`total_size`::
(<<byte-units,byte value>>) Total size of document merges.

`total_size_in_bytes`::
(integer) Total size of document merges in bytes.

`total_stopped_time`::
(<<time-units,time value>>) Total time spent stopping merge operations.

`total_stopped_time_in_millis`::
(integer) Total time in milliseconds spent stopping merge operations.

`total_throttled_time`::
(<<time-units,time value>>) Total time spent throttling merge operations.

`total_throttled_time_in_millis`::
(integer) Total time in milliseconds spent throttling merge operations.

`total_auto_throttle`::
(<<byte-units,byte value>>) Size of automatically throttled merge operations.

`total_auto_throttle_in_bytes`::
(integer) Size, in bytes, of automatically throttled merge operations.

=======

`refresh`::
(object) Contains statistics about refresh operations for the node.
+
.Properties of `refresh`
[%collapsible%open]
=======

`total`::
(integer) Total number of refresh operations.

`total_time`::
(<<time-units,time value>>) Total time spent performing refresh operations.

`total_time_in_millis`::
(integer) Total time in milliseconds spent performing refresh operations.

`external_total`::
(integer) Total number of external refresh operations.

`external_total_time`::
(<<time-units,time value>>) Total time spent performing external operations.

`external_total_time_in_millis`::
(integer) Total time in milliseconds spent performing external operations.

`listeners`::
(integer) Number of refresh listeners.

=======

`flush`::
(object) Contains statistics about flush operations for the node.
+
.Properties of `flush`
[%collapsible%open]
=======

`total`::
(integer) Number of flush operations.

`periodic`::
(integer) Number of flush periodic operations.

`total_time`::
(<<time-units,time value>>) Total time spent performing flush operations.

`total_time_in_millis`::
(integer) Total time in milliseconds spent performing flush operations.

=======

`warmer`::
(object) Contains statistics about index warming operations for the node.
+
.Properties of `warmer`
[%collapsible%open]
=======

`current`::
(integer) Number of active index warmers.

`total`::
(integer) Total number of index warmers.

`total_time`::
(<<time-units,time value>>) Total time spent performing index warming operations.

`total_time_in_millis`::
(integer) Total time in milliseconds spent performing index warming operations.

=======

`query_cache`::
(object) Contains statistics about the query cache across all shards assigned to the node.
+
.Properties of `query_cache`
[%collapsible%open]
=======

`memory_size`::
(<<byte-units,byte value>>) Total amount of memory used for the query cache across all shards assigned to the node.

`memory_size_in_bytes`::
(integer) Total amount of memory, in bytes, used for the query cache across all shards assigned to the node.

`total_count`::
(integer) Total count of hits, misses, and cached queries in the query cache.

`hit_count`::
(integer) Number of query cache hits.

`miss_count`::
(integer) Number of query cache misses.

`cache_size`::
(integer) Current number of cached queries.

`cache_count`::
(integer) Total number of all queries that have been cached.

`evictions`::
(integer) Number of query cache evictions.

=======

`fielddata`::
(object) Contains statistics about the field data cache across all shards assigned to the node.
+
.Properties of `fielddata`
[%collapsible%open]
=======

`memory_size`::
(<<byte-units,byte value>>) Total amount of memory used for the field data cache across all shards assigned to the node.

`memory_size_in_bytes`::
(integer) Total amount of memory, in bytes, used for the field data cache across all shards assigned to the node.

`evictions`::
(integer) Number of fielddata evictions.

=======

`completion`::
(object) Contains statistics about completions across all shards assigned to the node.
+
.Properties of `completion`
[%collapsible%open]
=======

`size`::
(<<byte-units,byte value>>) Total amount of memory used for completion across all shards assigned to the node.

`size_in_bytes`::
(integer) Total amount of memory, in bytes, used for completion across all shards assigned to the node.

=======

`segments`::
(object) Contains statistics about segments across all shards assigned to the node.
+
.Properties of `segments`
[%collapsible%open]
=======

`count`::
(integer) Number of segments.

`memory`::
(<<byte-units,byte value>>) Total amount of memory used for segments across all shards assigned to the node.

`memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for segments across all shards assigned to the node.

`terms_memory`::
(<<byte-units,byte value>>) Total amount of memory used for terms across all shards assigned to the node.

`terms_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for terms across all shards assigned to the node.

`stored_fields_memory`::
(<<byte-units,byte value>>) Total amount of memory used for stored fields across all shards assigned to the node.

`stored_fields_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for stored fields across all shards assigned to the node.

`term_vectors_memory`::
(<<byte-units,byte value>>) Total amount of memory used for term vectors across all shards assigned to the node.

`term_vectors_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for term vectors across all shards assigned to the node.

`norms_memory`::
(<<byte-units,byte value>>) Total amount of memory used for normalization factors across all shards assigned to the node.

`norms_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for normalization factors across all shards assigned to the node.

`points_memory`::
(<<byte-units,byte value>>) Total amount of memory used for points across all shards assigned to the node.

`points_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for points across all shards assigned to the node.

`doc_values_memory`::
(<<byte-units,byte value>>) Total amount of memory used for doc values across all shards assigned to the node.

`doc_values_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used for doc values across all shards assigned to the node.

`index_writer_memory`::
(<<byte-units,byte value>>) Total amount of memory used by all index writers across all shards assigned to the node.

`index_writer_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used by all index writers across all shards assigned to the node.

`version_map_memory`::
(<<byte-units,byte value>>) Total amount of memory used by all version maps across all shards assigned to the node.

`version_map_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used by all version maps across all shards assigned to the node.

`fixed_bit_set`::
(<<byte-units,byte value>>) Total amount of memory used by fixed bit sets across all shards assigned to the node.
+
Fixed bit sets are used for nested object field types and type filters for <<parent-join,join>> fields.

`fixed_bit_set_memory_in_bytes`::
(integer) Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to the node.
+
Fixed bit sets are used for nested object field types and type filters for <<parent-join,join>> fields.

`max_unsafe_auto_id_timestamp`::
(integer) Time of the most recently retried indexing request.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`file_sizes`::
(object) Contains statistics about the size of the segment file.
+
.Properties of `file_sizes`
[%collapsible%open]
========
`size`::
(<<byte-units,byte value>>) Size of the segment file.

`size_in_bytes`::
(integer) Size, in bytes, of the segment file.

`description`::
(string) Description of the segment file.

========
=======

`translog`::
(object) Contains statistics about transaction log operations for the node.
+
.Properties of `translog`
[%collapsible%open]
=======

`operations`::
(integer) Number of transaction log operations.

`size`::
(<<byte-units,byte value>>) Size of the transaction log.

`size_in_bytes`::
(integer) Size, in bytes, of the transaction log.

`uncommitted_operations`::
(integer) Number of uncommitted transaction log operations.

`uncommitted_size`::
(<<byte-units,byte value>>) Size of uncommitted transaction log operations.

`uncommitted_size_in_bytes`::
(integer) Size, in bytes, of uncommitted transaction log operations.

`earliest_last_modified_age`::
(integer) Earliest last modified age for the transaction log.

=======

`request_cache`::
(object) Contains statistics about the request cache across all shards assigned to the node.
+
.Properties of `request_cache`
[%collapsible%open]
=======

`memory_size`::
(<<byte-units,byte value>>) Memory used by the request cache.

`memory_size_in_bytes`::
(integer) Memory, in bytes, used by the request cache.

`evictions`::
(integer) Number of request cache operations.

`hit_count`::
(integer) Number of request cache hits.

`miss_count`::
(integer) Number of request cache misses.

=======

`recovery`::
(object) Contains statistics about recovery operations for the node.
+
.Properties of `recovery`
[%collapsible%open]
=======

`current_as_source`::
(integer) Number of recoveries that used an index shard as a source.

`current_as_target`::
(integer) Number of recoveries that used an index shard as a target.

`throttle_time`::
(<<time-units,time value>>) Time by which recovery operations were delayed due to throttling.

`throttle_time_in_millis`::
(integer) Time in milliseconds recovery operations were delayed due to throttling.

=======

`shard_stats`::
(object) Contains statistics about all shards assigned to the node.
+
.Properties of `shard_stats`
[%collapsible%open]
=======

`total_count`::
(integer) The total number of shards assigned to the node.

=======

`mappings`::
(object) Contains statistics about the mappings for the node.
This is not shown for the `shards` level, since mappings may be shared across the shards of an index on a node.
+
.Properties of `mappings`
[%collapsible%open]
=======

`total_count`::
(integer) Number of mappings, including <<runtime,runtime>> and <<object,object>> fields.

`total_estimated_overhead`::
(<<byte-units,byte value>>) Estimated heap overhead of mappings on this node, which allows for 1kiB of heap for every mapped field.

`total_estimated_overhead_in_bytes`::
(integer) Estimated heap overhead, in bytes, of mappings on this node, which allows for 1kiB of heap for every mapped field.

`total_segments`::
(integer) Estimated number of Lucene segments on this node

`total_segment_fields`::
(integer) Estimated number of fields at the segment level on this node

`average_fields_per_segment`::
(integer) Estimated average number of fields per segment on this node
=======

`dense_vector`::
(object) Contains statistics about dense_vector across all shards assigned to the node.
+
.Properties of `dense_vector`
[%collapsible%open]
=======

`value_count`::
(integer) Total number of dense vector indexed across all shards assigned to the node.

=======

`sparse_vector`::
(object) Contains statistics about sparse_vector across all shards assigned to the node.
+
.Properties of `sparse_vector`
[%collapsible%open]
=======

`value_count`::
(integer) Total number of sparse vector indexed across all shards assigned to the node.

=======

`shards`::
(object) When the `shards` level is requested, contains the aforementioned `indices` statistics for every shard (per
index, and then per shard ID), as well as the following shard-specific statistics (which are not shown when the
requested level is higher than `shards`):
+
.Additional shard-specific statistics for the `shards` level
[%collapsible%open]
=======

`routing`::
(object) Contains routing information about the shard.
+
.Properties of `routing`
[%collapsible%open]
========

`state`::
(string) State of the shard. Returned values are:
+
* `INITIALIZING`: The shard is initializing/recovering.
* `RELOCATING`: The shard is relocating.
* `STARTED`: The shard has started.
* `UNASSIGNED`: The shard is not assigned to any node.

`primary`::
(Boolean) Whether the shard is a primary shard or not.

`node`::
(string) ID of the node the shard is allocated to.

`relocating_node`::
(string) ID of the node the shard is either relocating to or relocating from, or null if shard is not relocating.

========

`commit`::
(object) Contains information regarding the last commit point of the shard.
+
.Properties of `commit`
[%collapsible%open]
========

`id`::
(string) Base64 version of the commit ID.

`generation`::
(integer) Lucene generation of the commit.

`user_data`::
(object) Contains additional technical information about the commit.

`num_docs`::
(integer) The number of docs in the commit.

========

`seq_no`::
(object) Contains information about <<optimistic-concurrency-control,sequence numbers>> and checkpoints for the shard.
+
.Properties of `seq_no`
[%collapsible%open]
========

`max_seq_no`::
(integer) The maximum sequence number issued so far.

`local_checkpoint`::
(integer) The current local checkpoint of the shard.

`global_checkpoint`::
(integer) The current global checkpoint of the shard.

========

`retention_leases`::
(object) Contains information about <<index-modules-history-retention,history retention leases>>.
+
.Properties of `retention_leases`
[%collapsible%open]
========

`primary_term`::
(integer) The primary term of this retention lease collection.

`version`::
(integer) The current version of the retention lease collection.

`leases`::
(array of objects) List of current leases for this shard.
+
.Properties of `leases`
[%collapsible%open]
=========

`id`::
(string) The ID of the lease.

`retaining_seq_no`::
(integer) The minimum sequence number to be retained by the lease.

`timestamp`::
(integer) The timestamp of when the lease was created or renewed.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`source`::
(string) The source of the lease.

=========
========

`shard_path`::
(object)
+
.Properties of `shard_path`
[%collapsible%open]
========

`state_path`::
(string) The state-path root, without the index name and the shard ID.

`data_path`::
(string) The data-path root, without the index name and the shard ID.

`is_custom_data_path`::
(boolean) Whether the data path is a custom data location and therefore outside of the nodes configured data paths.

========

`search_idle`::
(boolean) Whether the shard is <<dynamic-index-search-idle-after,search idle>> or not.

`search_idle_time`::
(integer) Time since previous searcher access.
Recorded in milliseconds.

=======
======

[[cluster-nodes-stats-api-response-body-os]]
`os`::
(object) Contains statistics about the operating system for the node.
+
.Properties of `os`
[%collapsible%open]
======

`timestamp`::
(integer) Last time the operating system statistics were refreshed.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`cpu`::
(object) Contains statistics about CPU usage for the node.
+
.Properties of `cpu`
[%collapsible%open]
=======

`percent`::
(integer) Recent CPU usage for the whole system, or `-1` if not supported.

`load_average`::
(object) Contains statistics about load averages on the system.
+
.Properties of `load_average`
[%collapsible%open]
========

`1m`::
(float) One-minute load average on the system (field is not present if one-minute load average is not available).

`5m`::
(float) Five-minute load average on the system (field is not present if five-minute load average is not available).

`15m`::
(float) Fifteen-minute load average on the system (field is not present if fifteen-minute load average is not available).

========
=======

`mem`::
(object) Contains statistics about memory usage for the node.
+
.Properties of `mem`
[%collapsible%open]
=======

`total`::
(<<byte-units,byte value>>) Total amount of physical memory.

`total_in_bytes`::
(integer) Total amount of physical memory in bytes.

`adjusted_total`::
(<<byte-units,byte value>>) If the amount of physical memory has been overridden using the `es.total_memory_bytes`
system property then this reports the overridden value.
Otherwise it reports the same value as `total`.

`adjusted_total_in_bytes`::
(integer) If the amount of physical memory has been overridden using the `es.total_memory_bytes`
system property then this reports the overridden value in bytes.
Otherwise it reports the same value as `total_in_bytes`.

`free`::
(<<byte-units,byte value>>) Amount of free physical memory.

`free_in_bytes`::
(integer) Amount of free physical memory in bytes.

`used`::
(<<byte-units,byte value>>) Amount of used physical memory.

`used_in_bytes`::
(integer) Amount of used physical memory in bytes.

`free_percent`::
(integer) Percentage of free memory.

`used_percent`::
(integer) Percentage of used memory.

=======

`swap`::
(object) Contains statistics about swap space for the node.
+
.Properties of `swap`
[%collapsible%open]
=======

`total`::
(<<byte-units,byte value>>) Total amount of swap space.

`total_in_bytes`::
(integer) Total amount of swap space in bytes.

`free`::
(<<byte-units,byte value>>) Amount of free swap space.

`free_in_bytes`::
(integer) Amount of free swap space in bytes.

`used`::
(<<byte-units,byte value>>) Amount of used swap space.

`used_in_bytes`::
(integer) Amount of used swap space in bytes.

=======

`cgroup` (Linux only)::
(object) Contains cgroup statistics for the node.
+
NOTE: For the cgroup stats to be visible, cgroups must be compiled into the kernel, the `cpu` and `cpuacct` cgroup subsystems must be configured and stats must be readable from `/sys/fs/cgroup/cpu` and `/sys/fs/cgroup/cpuacct`.
+
.Properties of `cgroup`
[%collapsible%open]
=======

`cpuacct` (Linux only)::
(object) Contains statistics about `cpuacct` control group for the node.
+
.Properties of `cpuacct`
[%collapsible%open]
========

`control_group` (Linux only)::
(string) The `cpuacct` control group to which the {es} process belongs.

`usage_nanos` (Linux only)::
(integer) The total CPU time (in nanoseconds) consumed by all tasks in the same cgroup as the {es} process.

========

`cpu` (Linux only)::
(object) Contains statistics about `cpu` control group for the node.
+
.Properties of `cpu`
[%collapsible%open]
========

`control_group` (Linux only)::
(string) The `cpu` control group to which the {es} process belongs.

`cfs_period_micros` (Linux only)::
(integer) The period of time (in microseconds) for how regularly all tasks in the same cgroup as the {es} process should have their access to CPU resources reallocated.

`cfs_quota_micros` (Linux only)::
(integer) The total amount of time (in microseconds) for which all tasks in the same cgroup as the {es} process can run during one period
`cfs_period_micros`.

`stat` (Linux only)::
(object) Contains CPU statistics for the node.
+
.Properties of `stat`
[%collapsible%open]
=========
`number_of_elapsed_periods` (Linux only)::
(integer) The number of reporting periods (as specified by
`cfs_period_micros`) that have elapsed.

`number_of_times_throttled` (Linux only)::
(integer) The number of times all tasks in the same cgroup as the {es} process have been throttled.

`time_throttled_nanos` (Linux only)::
(integer) The total amount of time (in nanoseconds) for which all tasks in the same cgroup as the {es} process have been throttled.

=========
========

`memory` (Linux only)::
(object) Contains statistics about the `memory` control group for the node.
+
.Properties of `memory`
[%collapsible%open]
========

`control_group` (Linux only)::
(string) The `memory` control group to which the {es} process belongs.

`limit_in_bytes` (Linux only)::
(string) The maximum amount of user memory (including file cache) allowed for all tasks in the same cgroup as the {es} process.
This value can be too big to store in a `long`, so is returned as a string so that the value returned can exactly match what the underlying operating system interface returns.
Any value that is too large to parse into a `long` almost certainly means no limit has been set for the cgroup.

`usage_in_bytes` (Linux only)::
(string) The total current memory usage by processes in the cgroup (in bytes) by all tasks in the same cgroup as the {es} process.
This value is stored as a string for consistency with `limit_in_bytes`.

========
=======
======

[[cluster-nodes-stats-api-response-body-process]]
`process`::
(object) Contains process statistics for the node.
+
.Properties of `process`
[%collapsible%open]
======

`timestamp`::
(integer) Last time the statistics were refreshed.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`open_file_descriptors`::
(integer) Number of opened file descriptors associated with the current or
`-1` if not supported.

`max_file_descriptors`::
(integer) Maximum number of file descriptors allowed on the system, or `-1` if not supported.

`cpu`::
(object) Contains CPU statistics for the node.
+
.Properties of `cpu`
[%collapsible%open]
=======

`percent`::
(integer) CPU usage in percent, or `-1` if not known at the time the stats are computed.

`total`::
(<<time-units,time value>>) CPU time used by the process on which the Java virtual machine is running.

`total_in_millis`::
(integer) CPU time (in milliseconds) used by the process on which the Java virtual machine is running, or `-1` if not supported.

=======

`mem`::
(object) Contains virtual memory statistics for the node.
+
.Properties of `mem`
[%collapsible%open]
=======

`total_virtual`::
(<<byte-units,byte value>>) Size of virtual memory that is guaranteed to be available to the running process.

`total_virtual_in_bytes`::
(integer) Size in bytes of virtual memory that is guaranteed to be available to the running process.

=======
======

[[cluster-nodes-stats-api-response-body-jvm]]
`jvm`::
(object) Contains Java Virtual Machine (JVM) statistics for the node.
+
.Properties of `jvm`
[%collapsible%open]
======

`timestamp`::
(integer) Last time JVM statistics were refreshed.

`uptime`::
(<<time-units,time value>>) Human-readable JVM uptime.
Only returned if the
<<_human_readable_output,`human`>> query parameter is `true`.

`uptime_in_millis`::
(integer) JVM uptime in milliseconds.

`mem`::
(object) Contains JVM memory usage statistics for the node.
+
.Properties of `mem`
[%collapsible%open]
=======

`heap_used`::
(<<byte-units,byte value>>) Memory currently in use by the heap.

`heap_used_in_bytes`::
(integer) Memory, in bytes, currently in use by the heap.

`heap_used_percent`::
(integer) Percentage of memory currently in use by the heap.

`heap_committed`::
(<<byte-units,byte value>>) Amount of memory available for use by the heap.

`heap_committed_in_bytes`::
(integer) Amount of memory, in bytes, available for use by the heap.

`heap_max`::
(<<byte-units,byte value>>) Maximum amount of memory available for use by the heap.

`heap_max_in_bytes`::
(integer) Maximum amount of memory, in bytes, available for use by the heap.

`non_heap_used`::
(<<byte-units,byte value>>) Non-heap memory used.

`non_heap_used_in_bytes`::
(integer) Non-heap memory used, in bytes.

`non_heap_committed`::
(<<byte-units,byte value>>) Amount of non-heap memory available.

`non_heap_committed_in_bytes`::
(integer) Amount of non-heap memory available, in bytes.

`pools`::
(object) Contains statistics about heap memory usage for the node.
+
.Properties of `pools`
[%collapsible%open]
========

`young`::
(object) Contains statistics about memory usage by the young generation heap for the node.
+
.Properties of `young`
[%collapsible%open]
=========

`used`::
(<<byte-units,byte value>>) Memory used by the young generation heap.

`used_in_bytes`::
(integer) Memory, in bytes, used by the young generation heap.

`max`::
(<<byte-units,byte value>>) Maximum amount of memory available for use by the young generation heap.

`max_in_bytes`::
(integer) Maximum amount of memory, in bytes, available for use by the young generation heap.

`peak_used`::
(<<byte-units,byte value>>) Largest amount of memory historically used by the young generation heap.

`peak_used_in_bytes`::
(integer) Largest amount of memory, in bytes, historically used by the young generation heap.

`peak_max`::
(<<byte-units,byte value>>) Largest amount of memory historically used by the young generation heap.

`peak_max_in_bytes`::
(integer) Largest amount of memory, in bytes, historically used by the young generation heap.

=========

`survivor`::
(object) Contains statistics about memory usage by the survivor space for the node.
+
.Properties of `survivor`
[%collapsible%open]
=========

`used`::
(<<byte-units,byte value>>) Memory used by the survivor space.

`used_in_bytes`::
(integer) Memory, in bytes, used by the survivor space.

`max`::
(<<byte-units,byte value>>) Maximum amount of memory available for use by the survivor space.

`max_in_bytes`::
(integer) Maximum amount of memory, in bytes, available for use by the survivor space.

`peak_used`::
(<<byte-units,byte value>>) Largest amount of memory historically used by the survivor space.

`peak_used_in_bytes`::
(integer) Largest amount of memory, in bytes, historically used by the survivor space.

`peak_max`::
(<<byte-units,byte value>>) Largest amount of memory historically used by the survivor space.

`peak_max_in_bytes`::
(integer) Largest amount of memory, in bytes, historically used by the survivor space.

=========

`old`::
(object) Contains statistics about memory usage by the old generation heap for the node.
+
.Properties of `old`
[%collapsible%open]
=========

`used`::
(<<byte-units,byte value>>) Memory used by the old generation heap.

`used_in_bytes`::
(integer) Memory, in bytes, used by the old generation heap.

`max`::
(<<byte-units,byte value>>) Maximum amount of memory available for use by the old generation heap.

`max_in_bytes`::
(integer) Maximum amount of memory, in bytes, available for use by the old generation heap.

`peak_used`::
(<<byte-units,byte value>>) Largest amount of memory historically used by the old generation heap.

`peak_used_in_bytes`::
(integer) Largest amount of memory, in bytes, historically used by the old generation heap.

`peak_max`::
(<<byte-units,byte value>>) Highest memory limit historically available for use by the old generation heap.

`peak_max_in_bytes`::
(integer) Highest memory limit, in bytes, historically available for use by the old generation heap.

=========
========
=======

`threads`::
(object) Contains statistics about JVM thread usage for the node.
+
.Properties of `threads`
[%collapsible%open]
=======

`count`::
(integer) Number of active threads in use by JVM.

`peak_count`::
(integer) Highest number of threads used by JVM.

=======

`gc`::
(object) Contains statistics about JVM garbage collectors for the node.
+
.Properties of `gc`
[%collapsible%open]
=======

`collectors`::
(object) Contains statistics about JVM garbage collectors for the node.
+
.Properties of `collectors`
[%collapsible%open]
========

`young`::
(object) Contains statistics about JVM garbage collectors that collect young generation objects for the node.
+
.Properties of `young`
[%collapsible%open]
=========

`collection_count`::
(integer) Number of JVM garbage collectors that collect young generation objects.

`collection_time`::
(<<time-units,time value>>) Total time spent by JVM collecting young generation objects.

`collection_time_in_millis`::
(integer) Total time in milliseconds spent by JVM collecting young generation objects.

=========

`old`::
(object) Contains statistics about JVM garbage collectors that collect old generation objects for the node.
+
.Properties of `old`
[%collapsible%open]
=========

`collection_count`::
(integer) Number of JVM garbage collectors that collect old generation objects.

`collection_time`::
(<<time-units,time value>>) Total time spent by JVM collecting old generation objects.

`collection_time_in_millis`::
(integer) Total time in milliseconds spent by JVM collecting old generation objects.

=========
========
=======

`buffer_pools`::
(object) Contains statistics about JVM buffer pools for the node.
+
.Properties of `buffer_pools`
[%collapsible%open]
=======

`mapped`::
(object) Contains statistics about mapped JVM buffer pools for the node.
+
.Properties of `mapped`
[%collapsible%open]
========

`count`::
(integer) Number of mapped buffer pools.

`used`::
(<<byte-units,byte value>>) Size of mapped buffer pools.

`used_in_bytes`::
(integer) Size, in bytes, of mapped buffer pools.

`total_capacity`::
(<<byte-units,byte value>>) Total capacity of mapped buffer pools.

`total_capacity_in_bytes`::
(integer) Total capacity, in bytes, of mapped buffer pools.

========

`direct`::
(object) Contains statistics about direct JVM buffer pools for the node.
+
.Properties of `direct`
[%collapsible%open]
========

`count`::
(integer) Number of direct buffer pools.

`used`::
(<<byte-units,byte value>>) Size of direct buffer pools.

`used_in_bytes`::
(integer) Size, in bytes, of direct buffer pools.

`total_capacity`::
(<<byte-units,byte value>>) Total capacity of direct buffer pools.

`total_capacity_in_bytes`::
(integer) Total capacity, in bytes, of direct buffer pools.

========
=======

`classes`::
(object) Contains statistics about classes loaded by JVM for the node.
+
.Properties of `classes`
[%collapsible%open]
=======

`current_loaded_count`::
(integer) Number of classes currently loaded by JVM.

`total_loaded_count`::
(integer) Total number of classes loaded since the JVM started.

`total_unloaded_count`::
(integer) Total number of classes unloaded since the JVM started.

=======
======

[[cluster-nodes-stats-api-response-body-repositories]]
`repositories`::
(object) Statistics about snapshot repositories.
+
.Properties of `repositories`
[%collapsible%open]
======

`<repository_name>`::
(object) Contains repository throttling statistics for the node.
+
.Properties of `<repository_name>`
[%collapsible%open]
=======

`total_read_throttled_time_nanos`::
(integer) Total number of nanos which node had to wait during recovery.

`total_write_throttled_time_nanos`::
(integer) Total number of nanos which node had to wait during snapshotting.

=======
======

[[cluster-nodes-stats-api-response-body-threadpool]]
`thread_pool`::
(object) Contains thread pool statistics for the node
+
.Properties of `thread_pool`
[%collapsible%open]
======

`<thread_pool_name>`::
(object) Contains statistics about the thread pool for the node.
+
.Properties of `<thread_pool_name>`
[%collapsible%open]
=======

`threads`::
(integer) Number of threads in the thread pool.

`queue`::
(integer) Number of tasks in queue for the thread pool.

`active`::
(integer) Number of active threads in the thread pool.

`rejected`::
(integer) Number of tasks rejected by the thread pool executor.

`largest`::
(integer) Highest number of active threads in the thread pool.

`completed`::
(integer) Number of tasks completed by the thread pool executor.

=======
======

[[cluster-nodes-stats-api-response-body-fs]]
`fs`::
(object) Contains file store statistics for the node.
+
.Properties of `fs`
[%collapsible%open]
======

`timestamp`::
(integer) Last time the file stores statistics were refreshed.
Recorded in milliseconds since the {wikipedia}/Unix_time[Unix Epoch].

`total`::
(object) Contains statistics for all file stores of the node.
+
.Properties of `total`
[%collapsible%open]
=======

`total`::
(<<byte-units,byte value>>) Total size of all file stores.

`total_in_bytes`::
(integer) Total size (in bytes) of all file stores.

`free`::
(<<byte-units,byte value>>) Total unallocated disk space in all file stores.

`free_in_bytes`::
(integer) Total number of unallocated bytes in all file stores.

`available`::
(<<byte-units,byte value>>) Total disk space available to this Java virtual machine on all file stores.
Depending on OS or process level restrictions (e.g. XFS quotas), this might appear less than `free`.
This is the actual amount of free disk space the {es} node can utilise.

`available_in_bytes`::
(integer) Total number of bytes available to this Java virtual machine on all file stores.
Depending on OS or process level restrictions (e.g. XFS quotas), this might appear less than `free_in_bytes`.
This is the actual amount of free disk space the {es} node can utilise.

=======

[[cluster-nodes-stats-fs-data]]
`data`::
(array of objects) List of all file stores.
+
.Properties of `data`
[%collapsible%open]
=======

`path`::
(string) Path to the file store.

`mount`::
(string) Mount point of the file store (ex: /dev/sda2).

`type`::
(string) Type of the file store (ex: ext4).

`total`::
(<<byte-units,byte value>>) Total size of the file store.

`total_in_bytes`::
(integer) Total size (in bytes) of the file store.

`free`::
(<<byte-units,byte value>>) Total amount of unallocated disk space in the file store.

`free_in_bytes`::
(integer) Total number of unallocated bytes in the file store.

`available`::
(<<byte-units,byte value>>) Total amount of disk space available to this Java virtual machine on this file store.

`available_in_bytes`::
(integer) Total number of bytes available to this Java virtual machine on this file store.

`low_watermark_free_space`::
(<<byte-units,byte value>>) The effective low disk watermark for this data path on this node: when a node has less free space than this value for at least one data path, its disk usage has exceeded the low watermark.
See <<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

`low_watermark_free_space_in_bytes`::
(integer) The effective low disk watermark, in bytes, for this data path on this node:
when a node has less free space than this value for at least one data path, its disk usage has exceeded the low watermark.
See <<disk-based-shard-allocation>>
for more information about disk watermarks and their effects on shard allocation.

`high_watermark_free_space`::
(<<byte-units,byte value>>) The effective high disk watermark for this data path on this node: when a node has less free space than this value for at least one data path, its disk usage has exceeded the high watermark.
See <<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

`high_watermark_free_space_in_bytes`::
(integer) The effective high disk watermark, in bytes, for this data path on this node:
when a node has less free space than this value for at least one data path, its disk usage has exceeded the high watermark.
See <<disk-based-shard-allocation>>
for more information about disk watermarks and their effects on shard allocation.

`flood_stage_free_space`::
(<<byte-units,byte value>>) The effective flood stage disk watermark for this data path on this node: when a node has less free space than this value for at least one data path, its disk usage has exceeded the flood stage watermark.
See
<<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

`flood_stage_free_space_in_bytes`::
(integer) The effective flood stage disk watermark, in bytes, for this data path on this node: when a node has less free space than this value for at least one data path, its disk usage has exceeded the flood stage watermark.
See
<<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

`frozen_flood_stage_free_space`::
(<<byte-units,byte value>>) The effective flood stage disk watermark for this data path on a dedicated frozen node: when a dedicated frozen node has less free space than this value for at least one data path, its disk usage has exceeded the flood stage watermark.
See <<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

`frozen_flood_stage_free_space_in_bytes`::
(integer) The effective flood stage disk watermark, in bytes, for this data path on a dedicated frozen node: when a dedicated frozen node has less free space than this value for at least one data path, its disk usage has exceeded the flood stage watermark.
See <<disk-based-shard-allocation>> for more information about disk watermarks and their effects on shard allocation.

=======

`io_stats` (Linux only)::
(objects) Contains I/O statistics for the node.

NOTE: These statistics are derived from the `/proc/diskstats` kernel interface.
This interface accounts for IO performed by all processes on the system, even
if you are running {es} within a container.
+
.Properties of `io_stats`
[%collapsible%open]
=======

`devices` (Linux only)::
(array) Array of disk metrics for each device that is backing an {es} data path.
These disk metrics are probed periodically and averages between the last probe and the current probe are computed.
+
.Properties of `devices`
[%collapsible%open]
========

`device_name` (Linux only)::
(string) The Linux device name.

`operations` (Linux only)::
(integer) The total number of read and write operations for the device completed since starting {es}.

`read_operations` (Linux only)::
(integer) The total number of read operations for the device completed since starting
{es}.

`write_operations` (Linux only)::
(integer) The total number of write operations for the device completed since starting
{es}.

`read_kilobytes` (Linux only)::
(integer) The total number of kilobytes read for the device since starting {es}.

`write_kilobytes` (Linux only)::
(integer) The total number of kilobytes written for the device since starting {es}.

`io_time_in_millis` (Linux only)::
(integer) The total time in milliseconds spent performing I/O operations for the device since starting {es}.

========

`total` (Linux only)::
(object) The sum of the disk metrics for all devices that back an {es} data path.
+
.Properties of `total`
[%collapsible%open]
========

`operations` (Linux only)::
(integer) The total number of read and write operations across all devices used by
{es} completed since starting {es}.

`read_operations` (Linux only)::
(integer) The total number of read operations for across all devices used by {es}
completed since starting {es}.

`write_operations` (Linux only)::
(integer) The total number of write operations across all devices used by {es}
completed since starting {es}.

`read_kilobytes` (Linux only)::
(integer) The total number of kilobytes read across all devices used by {es} since starting {es}.

`write_kilobytes` (Linux only)::
(integer) The total number of kilobytes written across all devices used by {es} since starting {es}.

`io_time_in_millis` (Linux only)::
(integer) The total time in milliseconds spent performing I/O operations across all devices used by {es} since starting {es}.

========

=======
======

[[cluster-nodes-stats-api-response-body-transport]]
`transport`::
(object) Contains transport statistics for the node.
+
.Properties of `transport`
[%collapsible%open]
======

`server_open`::
(integer) Current number of inbound TCP connections used for internal communication between nodes.

`total_outbound_connections`::
(integer) The cumulative number of outbound transport connections that this node has opened since it started.
Each transport connection may comprise multiple TCP connections but is only counted once in this statistic.
Transport connections are typically <<long-lived-connections,long-lived>> so this statistic should remain constant in a stable cluster.

`rx_count`::
(integer) Total number of RX (receive) packets received by the node during internal cluster communication.

`rx_size`::
(<<byte-units,byte value>>) Size of RX packets received by the node during internal cluster communication.

`rx_size_in_bytes`::
(integer) Size, in bytes, of RX packets received by the node during internal cluster communication.

`tx_count`::
(integer) Total number of TX (transmit) packets sent by the node during internal cluster communication.

`tx_size`::
(<<byte-units,byte value>>) Size of TX packets sent by the node during internal cluster communication.

`tx_size_in_bytes`::
(integer) Size, in bytes, of TX packets sent by the node during internal cluster communication.

`inbound_handling_time_histogram`::
(array) The distribution of the time spent handling each inbound message on a transport thread, represented as a histogram.
+
.Properties of `inbound_handling_time_histogram`
[%collapsible]
=======

`ge`::
(string) The inclusive lower bound of the bucket as a human-readable string.
May be omitted on the first bucket if this bucket has no lower bound.

`ge_millis`::
(integer) The inclusive lower bound of the bucket in milliseconds.
May be omitted on the first bucket if this bucket has no lower bound.

`lt`::
(string) The exclusive upper bound of the bucket as a human-readable string.
May be omitted on the last bucket if this bucket has no upper bound.

`lt_millis`::
(integer) The exclusive upper bound of the bucket in milliseconds.
May be omitted on the last bucket if this bucket has no upper bound.

`count`::
(integer) The number of times a transport thread took a period of time within the bounds of this bucket to handle an inbound message.

=======

`outbound_handling_time_histogram`::
(array) The distribution of the time spent sending each outbound transport message on a transport thread, represented as a histogram.
+
.Properties of `outbound_handling_time_histogram`
[%collapsible]
=======

`ge`::
(string) The inclusive lower bound of the bucket as a human-readable string.
May be omitted on the first bucket if this bucket has no lower bound.

`ge_millis`::
(integer) The inclusive lower bound of the bucket in milliseconds.
May be omitted on the first bucket if this bucket has no lower bound.

`lt`::
(string) The exclusive upper bound of the bucket as a human-readable string.
May be omitted on the last bucket if this bucket has no upper bound.

`lt_millis`::
(integer) The exclusive upper bound of the bucket in milliseconds.
May be omitted on the last bucket if this bucket has no upper bound.

`count`::
(integer) The number of times a transport thread took a period of time within the bounds of this bucket to send a transport message.

=======

`actions`::
(object) An action-by-action breakdown of the transport traffic handled by this node, showing the total amount of traffic and a histogram of message sizes for incoming requests and outgoing responses.
+
.Properties of `actions.*.requests` and `actions.*.responses`
[%collapsible]
=======

`count`::
(integer) The total number of requests received, or responses sent, for the current action.

`total_size`::
(<<byte-units,byte value>>) The total size (as a human-readable string) of all requests received, or responses sent, for the current action.

`total_size_in_bytes`::
(integer) The total size in bytes of all requests received, or responses sent, for the current action.

`histogram`::
(array) A breakdown of the distribution of sizes of requests received, or responses sent, for the current action.
+
.Properties of `histogram`
[%collapsible]
========

`ge`::
(<<byte-units,byte value>>) The inclusive lower bound of the bucket as a human-readable string.
May be omitted on the first bucket if this bucket has no lower bound.

`ge_bytes`::
(integer) The inclusive lower bound of the bucket in bytes.
May be omitted on the first bucket if this bucket has no lower bound.

`lt`::
(<<byte-units,byte value>>) The exclusive upper bound of the bucket as a human-readable string.
May be omitted on the last bucket if this bucket has no upper bound.

`lt_bytes`::
(integer) The exclusive upper bound of the bucket in bytes.
May be omitted on the last bucket if this bucket has no upper bound.

`count`::
(integer) The number of times a request was received, or a response sent, with a size within the bounds of this bucket.

========
=======

======

[[cluster-nodes-stats-api-response-body-http]]
`http`::
(object) Contains http statistics for the node.
+
.Properties of `http`
[%collapsible%open]
======

`current_open`::
(integer) Current number of open HTTP connections for the node.

`total_opened`::
(integer) Total number of HTTP connections opened for the node.

`clients`::
(array of objects) Information on current and recently-closed HTTP client connections.
Clients that have been closed longer than the <<http-settings,http.client_stats.closed_channels.max_age>>
setting will not be represented here.
+
.Properties of `clients`
[%collapsible%open]
=======

`id`::
(integer) Unique ID for the HTTP client.

`agent`::
(string) Reported agent for the HTTP client.
If unavailable, this property is not included in the response.

`local_address`::
(string) Local address for the HTTP connection.

`remote_address`::
(string) Remote address for the HTTP connection.

`last_uri`::
(string) The URI of the client's most recent request.

`x_forwarded_for`::
(string) Value from the client's `x-forwarded-for` HTTP header.
If unavailable, this property is not included in the response.

`x_opaque_id`::
(string) Value from the client's `x-opaque-id` HTTP header.
If unavailable, this property is not included in the response.

`opened_time_millis`::
(integer) Time at which the client opened the connection.

`closed_time_millis`::
(integer) Time at which the client closed the connection if the connection is closed.

`last_request_time_millis`::
(integer) Time of the most recent request from this client.

`request_count`::
(integer) Number of requests from this client.

`request_size_bytes`::
(integer) Cumulative size in bytes of all requests from this client.

=======
======

[[cluster-nodes-stats-api-response-body-breakers]]
`breakers`::
(object) Contains circuit breaker statistics for the node.
+
.Properties of `breakers`
[%collapsible%open]
======

`<circuit_breaker_name>`::
(object) Contains statistics for the circuit breaker.
+
.Properties of `<circuit_breaker_name>`
[%collapsible%open]
=======

`limit_size_in_bytes`::
(integer) Memory limit, in bytes, for the circuit breaker.

`limit_size`::
(<<byte-units,byte value>>) Memory limit for the circuit breaker.

`estimated_size_in_bytes`::
(integer) Estimated memory used, in bytes, for the operation.

`estimated_size`::
(<<byte-units,byte value>>) Estimated memory used for the operation.

`overhead`::
(float) A constant that all estimates for the circuit breaker are multiplied with to calculate a final estimate.

`tripped`::
(integer) Total number of times the circuit breaker has been triggered and prevented an out of memory error.

=======
======

[[cluster-nodes-stats-api-response-body-script]]
`script`::
(object) Contains script statistics for the node.
+
.Properties of `script`
[%collapsible%open]
======

`compilations`::
(integer) Total number of inline script compilations performed by the node.

`compilations_history`::
(object) Contains this recent history of script compilations

.Properties of `compilations_history`
[%collapsible%open]
=======

`5m`::
(long) The number of script compilations in the last five minutes.
`15m`::
(long) The number of script compilations in the last fifteen minutes.
`24h`::
(long) The number of script compilations in the last twenty-four hours.

=======

`cache_evictions`::
(integer) Total number of times the script cache has evicted old data.


`cache_evictions_history`::
(object) Contains this recent history of script cache evictions

.Properties of `cache_evictions`
[%collapsible%open]
=======
`5m`::
(long) The number of script cache evictions in the last five minutes.
`15m`::
(long) The number of script cache evictions in the last fifteen minutes.
`24h`::
(long) The number of script cache evictions in the last twenty-four hours.
=======

`compilation_limit_triggered`::
(integer) Total number of times the <<script-compilation-circuit-breaker,script compilation>> circuit breaker has limited inline script compilations.

======

[[cluster-nodes-stats-api-response-body-discovery]]
`discovery`::
(object) Contains node discovery statistics for the node.
+
.Properties of `discovery`
[%collapsible%open]
======

`cluster_state_queue`::
(object) Contains statistics for the cluster state queue of the node.
+
.Properties of `cluster_state_queue`
[%collapsible%open]
=======
`total`::
(integer) Total number of cluster states in queue.

`pending`::
(integer) Number of pending cluster states in queue.

`committed`::
(integer) Number of committed cluster states in queue.

=======

`published_cluster_states`::
(object) Contains statistics for the published cluster states of the node.
+
.Properties of `published_cluster_states`
[%collapsible%open]
=======

`full_states`::
(integer) Number of published cluster states.

`incompatible_diffs`::
(integer) Number of incompatible differences between published cluster states.

`compatible_diffs`::
(integer) Number of compatible differences between published cluster states.

=======

`cluster_state_update`::
(object) Contains low-level statistics about how long various activities took during cluster state updates while the node was the elected master.
Omitted if the node is not master-eligible.
Every field whose name ends in `_time` within this object is also represented as a raw number of milliseconds in a field whose name ends in `_time_millis`.
The human-readable fields with a `_time` suffix are only returned if requested with the `?human=true` query parameter.
+
.Properties of `cluster_state_update`
[%collapsible]
=======

`unchanged`::
(object) Contains statistics about cluster state update attempts that did not change the cluster state.
+
.Properties of `unchanged`
[%collapsible]
========

`count`::
(long) The number of cluster state update attempts that did not change the cluster state since the node started.

`computation_time`::
(<<time-units,time value>>) The cumulative amount of time spent computing no-op cluster state updates since the node started.

`notification_time`::
(<<time-units,time value>>) The cumulative amount of time spent notifying listeners of a no-op cluster state update since the node started.

========

`success`::
(object) Contains statistics about cluster state update attempts that successfully changed the cluster state.
+
.Properties of `success`
[%collapsible]
========

`count`::
(long) The number of cluster state update attempts that successfully changed the cluster state since the node started.

`computation_time`::
(<<time-units,time value>>) The cumulative amount of time spent computing cluster state updates that were ultimately successful since the node started.

`publication_time`::
(<<time-units,time value>>) The cumulative amount of time spent publishing cluster state updates which ultimately succeeded, which includes everything from the start of the publication (i.e. just after the computation of the new cluster state) until the publication has finished and the master node is ready to start processing the next state update.
This includes the time measured by
`context_construction_time`, `commit_time`, `completion_time` and
`master_apply_time`.

`context_construction_time`::
(<<time-units,time value>>) The cumulative amount of time spent constructing a _publication context_ since the node started for publications that ultimately succeeded.
This statistic includes the time spent computing the difference between the current and new cluster state preparing a serialized representation of this difference.

`commit_time`::
(<<time-units,time value>>) The cumulative amount of time spent waiting for a successful cluster state update to _commit_, which measures the time from the start of each publication until a majority of the master-eligible nodes have written the state to disk and confirmed the write to the elected master.

`completion_time`::
(<<time-units,time value>>) The cumulative amount of time spent waiting for a successful cluster state update to _complete_, which measures the time from the start of each publication until all the other nodes have notified the elected master that they have applied the cluster state.

`master_apply_time`::
(<<time-units,time value>>) The cumulative amount of time spent successfully applying cluster state updates on the elected master since the node started.

`notification_time`::
(<<time-units,time value>>) The cumulative amount of time spent notifying listeners of a successful cluster state update since the node started.

========

`failure`::
(object) Contains statistics about cluster state update attempts that did not successfully change the cluster state, typically because a new master node was elected before completion.
+
.Properties of `failure`
[%collapsible]
========

`count`::
(long) The number of cluster state update attempts that failed to change the cluster state since the node started.

`computation_time`::
(<<time-units,time value>>) The cumulative amount of time spent computing cluster state updates that were ultimately unsuccessful since the node started.

`publication_time`::
(<<time-units,time value>>) The cumulative amount of time spent publishing cluster state updates which ultimately failed, which includes everything from the start of the publication (i.e. just after the computation of the new cluster state) until the publication has finished and the master node is ready to start processing the next state update.
This includes the time measured by
`context_construction_time`, `commit_time`, `completion_time` and
`master_apply_time`.

`context_construction_time`::
(<<time-units,time value>>) The cumulative amount of time spent constructing a _publication context_ since the node started for publications that ultimately failed.
This statistic includes the time spent computing the difference between the current and new cluster state preparing a serialized representation of this difference.

`commit_time`::
(<<time-units,time value>>) The cumulative amount of time spent waiting for an unsuccessful cluster state update to _commit_, which measures the time from the start of each publication until a majority of the master-eligible nodes have written the state to disk and confirmed the write to the elected master.

`completion_time`::
(<<time-units,time value>>) The cumulative amount of time spent waiting for an unsuccessful cluster state update to _complete_, which measures the time from the start of each publication until all the other nodes have notified the elected master that they have applied the cluster state.

`master_apply_time`::
(<<time-units,time value>>) The cumulative amount of time spent unsuccessfully applying cluster state updates on the elected master since the node started.

`notification_time`::
(<<time-units,time value>>) The cumulative amount of time spent notifying listeners of a failed cluster state update since the node started.

========
=======
======

[[cluster-nodes-stats-api-response-body-ingest]]
`ingest`::
(object) Contains ingest statistics for the node.
+
.Properties of `ingest`
[%collapsible%open]
======

`total`::
(object) Contains statistics about ingest operations for the node.
+
.Properties of `total`
[%collapsible%open]
=======

`count`::
(integer) Total number of documents ingested during the lifetime of this node.

`time`::
(<<time-units,time value>>) Total time spent preprocessing ingest documents during the lifetime of this node.

`time_in_millis`::
(integer) Total time, in milliseconds, spent preprocessing ingest documents during the lifetime of this node.

`current`::
(integer) Total number of documents currently being ingested.

`failed`::
(integer) Total number of failed ingest operations during the lifetime of this node.

=======

`pipelines`::
(object) Contains statistics about ingest pipelines for the node.
+
.Properties of `pipelines`
[%collapsible%open]
=======

`<pipeline_id>`::
(object) Contains statistics about the ingest pipeline.
+
.Properties of `<pipeline_id>`
[%collapsible%open]
========

`count`::
(integer) Number of documents preprocessed by the ingest pipeline.

`time`::
(<<time-units,time value>>) Total time spent preprocessing documents in the ingest pipeline.

`time_in_millis`::
(integer) Total time, in milliseconds, spent preprocessing documents in the ingest pipeline.

`failed`::
(integer) Total number of failed operations for the ingest pipeline.

`ingested_as_first_pipeline`::
(<<byte-units,byte value>>)
Total ingested size of all documents which were first processed by this pipeline.
A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline
run after a reroute processor, or is within a pipeline processor.
Instead, the document size is added to the stat value of the pipeline which initially ingested the document.

`ingested_as_first_pipeline_in_bytes`::
(integer)
Total ingested size, in bytes, of all documents which were first processed by this pipeline.
A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline
run after a reroute processor, or is within a pipeline processor.
Instead, the document size is added to the stat value of the pipeline which initially ingested the document.

`produced_as_first_pipeline`::
(<<byte-units,byte value>>)
Total produced size of all documents which were first processed by this pipeline.
A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline
run after a reroute processor, or is within a pipeline processor.
Instead, the document size is added to the stat value of the pipeline which initially ingested the document.

`produced_as_first_pipeline_in_bytes`::
(integer)
Total produced size, in bytes, of all documents which were first processed by this pipeline.
A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline
run after a reroute processor, or is within a pipeline processor.
Instead, the document size is added to the stat value of the pipeline which initially ingested the document.

`processors`::
(array of objects) Contains statistics for the ingest processors for the ingest pipeline.
+
.Properties of `processors`
[%collapsible%open]
=========

`<processor>`::
(object) Contains statistics for the ingest processor.
+
.Properties of `<processor>`
[%collapsible%open]
==========
`count`::
(integer) Number of documents transformed by the processor.

`time`::
(<<time-units,time value>>) Time spent by the processor transforming documents.

`time_in_millis`::
(integer) Time, in milliseconds, spent by the processor transforming documents.

`current`::
(integer) Number of documents currently being transformed by the processor.

`failed`::
(integer) Number of failed operations for the processor.

==========
=========
========
=======
======

[[cluster-nodes-stats-api-response-body-indexing-pressure]]
`indexing_pressure`::
(object) Contains <<index-modules-indexing-pressure,indexing pressure>> statistics for the node.
+
.Properties of `indexing_pressure`
[%collapsible%open]
======

`memory`::
(object) Contains statistics for memory consumption from indexing load.
+
.Properties of `<memory>`
[%collapsible%open]
=======

`current`::
(object) Contains statistics for current indexing load.
+
.Properties of `<current>`
[%collapsible%open]
========

`combined_coordinating_and_primary`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating or primary stage.
This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally.

`combined_coordinating_and_primary_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating or primary stage.
This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally.

`coordinating`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating stage.

`coordinating_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating stage.

`primary`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the primary stage.

`primary_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the primary stage.

`replica`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the replica stage.

`replica_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the replica stage.

`all`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating, primary, or replica stage.

`all_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage.

========
`total`::
(object) Contains statistics for the cumulative indexing load since the node started.
+
.Properties of `<total>`
[%collapsible%open]
========

`combined_coordinating_and_primary`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating or primary stage.
This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally.

`combined_coordinating_and_primary_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating or primary stage.
This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally.

`coordinating`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating stage.

`coordinating_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating stage.

`primary`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the primary stage.

`primary_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the primary stage.

`replica`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the replica stage.

`replica_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the replica stage.

`all`::
(<<byte-units,byte value>>) Memory consumed by indexing requests in the coordinating, primary, or replica stage.

`all_in_bytes`::
(integer) Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage.

`coordinating_rejections`::
(integer) Number of indexing requests rejected in the coordinating stage.

`primary_rejections`::
(integer) Number of indexing requests rejected in the primary stage.

`replica_rejections`::
(integer) Number of indexing requests rejected in the replica stage.

========
`limit`::
(<<byte-units,byte value>>) Configured memory limit for the indexing requests.
Replica requests have an automatic limit that is 1.5x this value.

`limit_in_bytes`::
(integer) Configured memory limit, in bytes, for the indexing requests.
Replica requests have an automatic limit that is 1.5x this value.

=======
======

[[cluster-nodes-stats-api-response-body-adaptive-selection]]
`adaptive_selection`::
(object) Contains adaptive selection statistics for the node.
+
.Properties of `adaptive_selection`
[%collapsible%open]
======

`outgoing_searches`::
(integer) The number of outstanding search requests from the node these stats are for to the keyed node.

`avg_queue_size`::
(integer) The exponentially weighted moving average queue size of search requests on the keyed node.

`avg_service_time`::
(<<time-units,time value>>) The exponentially weighted moving average service time of search requests on the keyed node.

`avg_service_time_ns`::
(integer) The exponentially weighted moving average service time, in nanoseconds, of search requests on the keyed node.

`avg_response_time`::
(<<time-units,time value>>) The exponentially weighted moving average response time of search requests on the keyed node.

`avg_response_time_ns`::
(integer) The exponentially weighted moving average response time, in nanoseconds, of search requests on the keyed node.

`rank`::
(string) The rank of this node; used for shard selection when routing search requests.

======

[[cluster-nodes-stats-api-response-body-allocations]]
`allocations`::
(object) Contains allocations statistics for the node.
+
.Properties of `allocations`
[%collapsible%open]
======

`shards`::
(integer) The number of shards currently allocated to this node

`undesired_shards`::
(integer) The amount of shards that are scheduled to be moved elsewhere in the cluster if desired balance allocator is used or -1 if any other allocator is used.

`forecasted_ingest_load`::
(double) Total forecasted ingest load of all shards assigned to this node

`forecasted_disk_usage`::
(<<byte-units,byte value>>) Forecasted size of all shards assigned to the node

`forecasted_disk_usage_bytes`::
(integer) Forecasted size, in bytes, of all shards assigned to the node

`current_disk_usage`::
(<<byte-units,byte value>>) Current size of all shards assigned to the node

`current_disk_usage_bytes`::
(integer) Current size, in bytes, of all shards assigned to the node

======
=====
====

[[cluster-nodes-stats-api-example]]
==== {api-examples-title}

[source,console,id=nodes-stats-limit]
----
# return just indices
GET /_nodes/stats/indices

# return just os and process
GET /_nodes/stats/os,process

# return just process for node with IP address 10.0.0.1
GET /_nodes/10.0.0.1/stats/process
----

All stats can be explicitly requested via `/_nodes/stats/_all` or
`/_nodes/stats?metric=_all`.

You can get information about indices stats on `node`, `indices`, or `shards`
level.

[source,console,id=nodes-stats-indices]
----
# Fielddata summarized by node
GET /_nodes/stats/indices/fielddata?fields=field1,field2

# Fielddata summarized by node and index
GET /_nodes/stats/indices/fielddata?level=indices&fields=field1,field2

# Fielddata summarized by node, index, and shard
GET /_nodes/stats/indices/fielddata?level=shards&fields=field1,field2

# You can use wildcards for field names
GET /_nodes/stats/indices/fielddata?fields=field*
----

You can get statistics about search groups for searches executed on this node.

[source,console,id=nodes-stats-groups]
----
# All groups with all stats
GET /_nodes/stats?groups=_all

# Some groups from just the indices stats
GET /_nodes/stats/indices?groups=foo,bar
----

[[cluster-nodes-stats-ingest-ex]]
===== Retrieve ingest statistics only

To return only ingest-related node statistics, set the `<metric>` path parameter to `ingest` and use the
<<common-options-response-filtering,`filter_path`>> query parameter.

[source,console,id=nodes-stats-filter-path]
----
GET /_nodes/stats/ingest?filter_path=nodes.*.ingest
----

You can use the `metric` and `filter_path` query parameters to get the same response.

[source,console,id=nodes-stats-metric-filter-path]
----
GET /_nodes/stats?metric=ingest&filter_path=nodes.*.ingest
----

To further refine the response, change the `filter_path` value.
For example, the following request only returns ingest pipeline statistics.

[source,console,id=nodes-stats-metric-filter-path-refined]
----
GET /_nodes/stats?metric=ingest&filter_path=nodes.*.ingest.pipelines
----