Cluster stats API

Returns cluster statistics.

Request

GET /_cluster/stats

GET /_cluster/stats/nodes/<node_filter>

Description

The Cluster Stats API allows to retrieve statistics from a cluster wide perspective. The API returns basic index metrics (shard numbers, store size, memory usage) and information about the current nodes that form the cluster (number, roles, os, jvm versions, memory usage, cpu and installed plugins).

Path parameters

<node_filter>

(Optional, string) Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.

Query parameters

flat_settings

(Optional, boolean) If true, returns settings in flat format. Defaults to false.

master_timeout

(Optional, time units) Specifies the period of time to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. Defaults to 30s.

timeout

(Optional, time units) Specifies the period of time to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. Defaults to 30s.

Response body

_nodes

(object) Contains statistics about the number of nodes selected by the request’s node filters.

Properties of _nodes

  • 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.

cluster_uuid

(string) Unique identifier for the cluster.

timestamp

(integer) Unix timestamp, in milliseconds, of the last time the cluster statistics were refreshed.

status

(string) Health status of the cluster, based on the state of its primary and replica shards. Statuses are:

  • green

    All shards are assigned.

    yellow

    All primary shards are assigned, but one or more replica shards are unassigned. If a node in the cluster fails, some data could be unavailable until that node is repaired.

    red

    One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.

See Cluster health.

indices

(object) Contains statistics about indices with shards assigned to selected nodes.

Properties of indices

  • count

    (integer) Total number of indices with shards assigned to selected nodes.

    shards

    (object) Contains statistics about shards assigned to selected nodes.

    Properties of shards

    • total

      (integer) Total number of shards assigned to selected nodes.

      primaries

      (integer) Number of primary shards assigned to selected nodes.

      replication

      (float) Ratio of replica shards to primary shards across all selected nodes.

      index

      (object) Contains statistics about shards assigned to selected nodes.

      Properties of index

      shards

      (object) Contains statistics about the number of shards assigned to selected nodes.

      Properties of shards

      min

      (integer) Minimum number of shards in an index, counting only shards assigned to selected nodes.

      max

      (integer) Maximum number of shards in an index, counting only shards assigned to selected nodes.

      avg

      (float) Mean number of shards in an index, counting only shards assigned to selected nodes.

      primaries

      (object) Contains statistics about the number of primary shards assigned to selected nodes.

      Properties of primaries

      min

      (integer) Minimum number of primary shards in an index, counting only shards assigned to selected nodes.

      max

      (integer) Maximum number of primary shards in an index, counting only shards assigned to selected nodes.

      avg

      (float) Mean number of primary shards in an index, counting only shards assigned to selected nodes.

      replication

      (object) Contains statistics about the number of replication shards assigned to selected nodes.

      Properties of replication

      min

      (float) Minimum replication factor in an index, counting only shards assigned to selected nodes.

      max

      (float) Maximum replication factor in an index, counting only shards assigned to selected nodes.

      avg

      (float) Mean replication factor in an index, counting only shards assigned to selected nodes.

  1. `docs`
  3. (object) Contains counts for documents in selected nodes.
  5. Properties of `docs`
  7. -   `count`
  9.     (integer) Total number of non-deleted documents across all primary shards assigned to selected nodes.
  11.     This number is based on documents in Lucene segments and may include documents from nested fields.
  13.     `deleted`
  15.     (integer) Total number of deleted documents across all primary shards assigned to selected nodes.
  17.     This number is based on documents in Lucene segments. Elasticsearch reclaims the disk space of deleted Lucene documents when a segment is merged.
  20. `store`
  22. (object) Contains statistics about the size of shards assigned to selected nodes.
  24. Properties of `store`
  26. -   `size`
  28.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total size of all shards assigned to selected nodes.
  30.     `size_in_bytes`
  32.     (integer) Total size, in bytes, of all shards assigned to selected nodes.
  34.     `reserved`
  36.     ([byte value]($a397f9b7db759452.md#byte-units "Byte size units")) A prediction of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
  38.     `reserved_in_bytes`
  40.     (integer) A prediction, in bytes, of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
  43. `fielddata`
  45. (object) Contains statistics about the field data cache of selected nodes.
  47. Properties of `fielddata`
  49. -   `memory_size`
  51.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for the field data cache across all shards assigned to selected nodes.
  53.     `memory_size_in_bytes`
  55.     (integer) Total amount, in bytes, of memory used for the field data cache across all shards assigned to selected nodes.
  57.     `evictions`
  59.     (integer) Total number of evictions from the field data cache across all shards assigned to selected nodes.
  62. `query_cache`
  64. (object) Contains statistics about the query cache of selected nodes.
  66. Properties of `query_cache`
  68. -   `memory_size`
  70.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for the query cache across all shards assigned to selected nodes.
  72.     `memory_size_in_bytes`
  74.     (integer) Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes.
  76.     `total_count`
  78.     (integer) Total count of hits and misses in the query cache across all shards assigned to selected nodes.
  80.     `hit_count`
  82.     (integer) Total count of query cache hits across all shards assigned to selected nodes.
  84.     `miss_count`
  86.     (integer) Total count of query cache misses across all shards assigned to selected nodes.
  88.     `cache_size`
  90.     (integer) Total number of entries currently in the query cache across all shards assigned to selected nodes.
  92.     `cache_count`
  94.     (integer) Total number of entries added to the query cache across all shards assigned to selected nodes. This number includes current and evicted entries.
  96.     `evictions`
  98.     (integer) Total number of query cache evictions across all shards assigned to selected nodes.
  101. `completion`
  103. (object) Contains statistics about memory used for completion in selected nodes.
  105. Properties of `completion`
  107. -   `size`
  109.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for completion across all shards assigned to selected nodes.
  111.     `size_in_bytes`
  113.     (integer) Total amount, in bytes, of memory used for completion across all shards assigned to selected nodes.
  116. `segments`
  118. (object) Contains statistics about segments in selected nodes.
  120. Properties of `segments`
  122. -   `count`
  124.     (integer) Total number of segments across all shards assigned to selected nodes.
  126.     `memory`
  128.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for segments across all shards assigned to selected nodes.
  130.     `memory_in_bytes`
  132.     (integer) Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes.
  134.     `terms_memory`
  136.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for terms across all shards assigned to selected nodes.
  138.     `terms_memory_in_bytes`
  140.     (integer) Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes.
  142.     `stored_fields_memory`
  144.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for stored fields across all shards assigned to selected nodes.
  146.     `stored_fields_memory_in_bytes`
  148.     (integer) Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes.
  150.     `term_vectors_memory`
  152.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for term vectors across all shards assigned to selected nodes.
  154.     `term_vectors_memory_in_bytes`
  156.     (integer) Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes.
  158.     `norms_memory`
  160.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for normalization factors across all shards assigned to selected nodes.
  162.     `norms_memory_in_bytes`
  164.     (integer) Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes.
  166.     `points_memory`
  168.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for points across all shards assigned to selected nodes.
  170.     `points_memory_in_bytes`
  172.     (integer) Total amount, in bytes, of memory used for points across all shards assigned to selected nodes.
  174.     `doc_values_memory`
  176.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used for doc values across all shards assigned to selected nodes.
  178.     `doc_values_memory_in_bytes`
  180.     (integer) Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes.
  182.     `index_writer_memory`
  184.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used by all index writers across all shards assigned to selected nodes.
  186.     `index_writer_memory_in_bytes`
  188.     (integer) Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes.
  190.     `version_map_memory`
  192.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used by all version maps across all shards assigned to selected nodes.
  194.     `version_map_memory_in_bytes`
  196.     (integer) Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes.
  198.     `fixed_bit_set`
  200.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of memory used by fixed bit sets across all shards assigned to selected nodes.
  202.     Fixed bit sets are used for nested object field types and type filters for [join]($1a8d6a6a8ffe737a.md "Join field type") fields.
  204.     `fixed_bit_set_memory_in_bytes`
  206.     (integer) Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes.
  208.     `max_unsafe_auto_id_timestamp`
  210.     (integer) [Unix timestamp](https://en.wikipedia.org/wiki/Unix_time), in milliseconds, of the most recently retried indexing request.
  212.     `file_sizes`
  214.     (object) This object is not populated by the cluster stats API.
  216.     To get information on segment files, use the [node stats API]($b347631483fdb07e.md "Nodes stats API").
  219. `mappings`
  221. (object) Contains statistics about [field mappings]($e690e01ae99d7d0f.md "Mapping") in selected nodes.
  223. Properties of `mappings`
  225. -   `field_types`
  227.     (array of objects) Contains statistics about [field data types]($193bd3c80a2449f9.md "Field data types") used in selected nodes.
  229.     Properties of `field_types` objects
  231.     `name`
  233.     (string) Field data type used in selected nodes.
  235.     `count`
  237.     (integer) Number of fields mapped to the field data type in selected nodes.
  239.     `index_count`
  241.     (integer) Number of indices containing a mapping of the field data type in selected nodes.
  244. `analysis`
  246. (object) Contains statistics about [analyzers and analyzer components]($c9d42adcf15ae1bc.md "Anatomy of an analyzer") used in selected nodes.
  248. Properties of `analysis`
  250. -   `char_filter_types`
  252.     (array of objects) Contains statistics about [character filter]($58912166bab2bf53.md "Character filters reference") types used in selected nodes.
  254.     Properties of `char_filter_types` objects
  256.     `name`
  258.     (string) Character filter type used in selected nodes.
  260.     `count`
  262.     (integer) Number of analyzers or normalizers using the character filter type in selected nodes.
  264.     `index_count`
  266.     (integer) Number of indices the character filter type in selected nodes.
  268.     `tokenizer_types`
  270.     (array of objects) Contains statistics about [tokenizer]($e0dd0e153cabb387.md "Tokenizer reference") types used in selected nodes.
  272.     Properties of `tokenizer_types` objects
  274.     `name`
  276.     (string) Tokenizer type used in selected nodes.
  278.     `count`
  280.     (integer) Number of analyzers or normalizers using the tokenizer type in selected nodes.
  282.     `index_count`
  284.     (integer) Number of indices using the tokenizer type in selected nodes.
  286.     `filter_types`
  288.     (array of objects) Contains statistics about [token filter]($8f4145c5bd7aec70.md "Token filter reference") types used in selected nodes.
  290.     Properties of `filter_types` objects
  292.     `name`
  294.     (string) Token filter type used in selected nodes.
  296.     `count`
  298.     (integer) Number of analyzers or normalizers using the token filter type in selected nodes.
  300.     `index_count`
  302.     (integer) Number of indices using the token filter type in selected nodes.
  304.     `analyzer_types`
  306.     (array of objects) Contains statistics about [analyzer]($c9d42adcf15ae1bc.md "Anatomy of an analyzer") types used in selected nodes.
  308.     Properties of `analyzer_types` objects
  310.     `name`
  312.     (string) Analyzer type used in selected nodes.
  314.     `count`
  316.     (integer) Occurrences of the analyzer type in selected nodes.
  318.     `index_count`
  320.     (integer) Number of indices using the analyzer type in selected nodes.
  322.     `built_in_char_filters`
  324.     (array of objects) Contains statistics about built-in [character filters]($58912166bab2bf53.md "Character filters reference") used in selected nodes.
  326.     Properties of `built_in_char_filters` objects
  328.     `name`
  330.     (string) Built-in character filter used in selected nodes.
  332.     `count`
  334.     (integer) Number of analyzers or normalizers using the built-in character filter in selected nodes.
  336.     `index_count`
  338.     (integer) Number of indices using the built-in character filter in selected nodes.
  340.     `built_in_tokenizers`
  342.     (array of objects) Contains statistics about built-in [tokenizers]($e0dd0e153cabb387.md "Tokenizer reference") used in selected nodes.
  344.     Properties of `built_in_tokenizers` objects
  346.     `name`
  348.     (string) Built-in tokenizer used in selected nodes.
  350.     `count`
  352.     (integer) Number of analyzers or normalizers using the built-in tokenizer in selected nodes.
  354.     `index_count`
  356.     (integer) Number of indices using the built-in tokenizer in selected nodes.
  358.     `built_in_filters`
  360.     (array of objects) Contains statistics about built-in [token filters]($8f4145c5bd7aec70.md "Token filter reference") used in selected nodes.
  362.     Properties of `built_in_filters` objects
  364.     `name`
  366.     (string) Built-in token filter used in selected nodes.
  368.     `count`
  370.     (integer) Number of analyzers or normalizers using the built-in token filter in selected nodes.
  372.     `index_count`
  374.     (integer) Number of indices using the built-in token filter in selected nodes.
  376.     `built_in_analyzers`
  378.     (array of objects) Contains statistics about built-in [analyzers]($e2030746b025f532.md "Built-in analyzer reference") used in selected nodes.
  380.     Properties of `built_in_analyzers` objects
  382.     `name`
  384.     (string) Built-in analyzer used in selected nodes.
  386.     `count`
  388.     (integer) Occurrences of the built-in analyzer in selected nodes.
  390.     `index_count`
  392.     (integer) Number of indices using the built-in analyzer in selected nodes.

nodes

(object) Contains statistics about nodes selected by the request’s node filters.

Properties of nodes

  • count

    (object) Contains counts for nodes selected by the request’s node filters.

    Properties of count

    • total

      (integer) Total number of selected nodes.

      coordinating_only

      (integer) Number of selected nodes without a role. These nodes are considered coordinating only nodes.

      <role>

      (integer) Number of selected nodes with the role. For a list of roles, see Node.

  1. `versions`
  3. (array of strings) Array of Elasticsearch versions used on selected nodes.
  5. `os`
  7. (object) Contains statistics about the operating systems used by selected nodes.
  9. Properties of `os`
  11. -   `available_processors`
  13.     (integer) Number of processors available to JVM across all selected nodes.
  15.     `allocated_processors`
  17.     (integer) Number of processors used to calculate thread pool size across all selected nodes.
  19.     This number can be set with the `processors` setting of a node and defaults to the number of processors reported by the OS. In both cases, this number will never be larger than `32`.
  21.     `names`
  23.     (array of objects) Contains statistics about operating systems used by selected nodes.
  25.     Properties of `names`
  27.     `name`
  29.     (string) Name of an operating system used by one or more selected nodes.
  31.     `count`
  33.     (string) Number of selected nodes using the operating system.
  35.     `pretty_names`
  37.     (array of objects) Contains statistics about operating systems used by selected nodes.
  39.     Properties of `pretty_names`
  41.     `pretty_name`
  43.     (string) Human-readable name of an operating system used by one or more selected nodes.
  45.     `count`
  47.     (string) Number of selected nodes using the operating system.
  49.     `mem`
  51.     (object) Contains statistics about memory used by selected nodes.
  53.     Properties of `mem`
  55.     `total`
  57.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of physical memory across all selected nodes.
  59.     `total_in_bytes`
  61.     (integer) Total amount, in bytes, of physical memory across all selected nodes.
  63.     `free`
  65.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Amount of free physical memory across all selected nodes.
  67.     `free_in_bytes`
  69.     (integer) Amount, in bytes, of free physical memory across all selected nodes.
  71.     `used`
  73.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Amount of physical memory in use across all selected nodes.
  75.     `used_in_bytes`
  77.     (integer) Amount, in bytes, of physical memory in use across all selected nodes.
  79.     `free_percent`
  81.     (integer) Percentage of free physical memory across all selected nodes.
  83.     `used_percent`
  85.     (integer) Percentage of physical memory in use across all selected nodes.
  88. `process`
  90. (object) Contains statistics about processes used by selected nodes.
  92. Properties of `process`
  94. -   `cpu`
  96.     (object) Contains statistics about CPU used by selected nodes.
  98.     Properties of `cpu`
  100.     `percent`
  102.     (integer) Percentage of CPU used across all selected nodes. Returns `-1` if not supported.
  104.     `open_file_descriptors`
  106.     (object) Contains statistics about open file descriptors in selected nodes.
  108.     Properties of `open_file_descriptors`
  110.     `min`
  112.     (integer) Minimum number of concurrently open file descriptors across all selected nodes. Returns `-1` if not supported.
  114.     `max`
  116.     (integer) Maximum number of concurrently open file descriptors allowed across all selected nodes. Returns `-1` if not supported.
  118.     `avg`
  120.     (integer) Average number of concurrently open file descriptors. Returns `-1` if not supported.
  123. `jvm`
  125. (object) Contains statistics about the Java Virtual Machines (JVMs) used by selected nodes.
  127. Properties of `jvm`
  129. -   `max_uptime`
  131.     ([time unit]($a397f9b7db759452.md#time-units "Time units")) Uptime duration since JVM last started.
  133.     `max_uptime_in_millis`
  135.     (integer) Uptime duration, in milliseconds, since JVM last started.
  137.     `versions`
  139.     (array of objects) Contains statistics about the JVM versions used by selected nodes.
  141.     Properties of `versions`
  143.     `version`
  145.     (string) Version of JVM used by one or more selected nodes.
  147.     `vm_name`
  149.     (string) Name of the JVM.
  151.     `vm_version`
  153.     (string) Full version number of JVM.
  155.     The full version number includes a plus sign (`+`) followed by the build number.
  157.     `vm_vendor`
  159.     (string) Vendor of the JVM.
  161.     `bundled_jdk`
  163.     (boolean) If `true`, the JVM includes a bundled Java Development Kit (JDK).
  165.     `using_bundled_jdk`
  167.     (boolean) If `true`, a bundled JDK is in use by JVM.
  169.     `count`
  171.     (integer) Total number of selected nodes using JVM.
  173.     `mem`
  175.     (object) Contains statistics about memory used by selected nodes.
  177.     Properties of `mem`
  179.     `heap_used`
  181.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Memory currently in use by the heap across all selected nodes.
  183.     `heap_used_in_bytes`
  185.     (integer) Memory, in bytes, currently in use by the heap across all selected nodes.
  187.     `heap_max`
  189.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.
  191.     `heap_max_in_bytes`
  193.     (integer) Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.
  195.     `threads`
  197.     (integer) Number of active threads in use by JVM across all selected nodes.
  200. `fs`
  202. (object) Contains statistics about file stores by selected nodes.
  204. Properties of `fs`
  206. -   `total`
  208.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total size of all file stores across all selected nodes.
  210.     `total_in_bytes`
  212.     (integer) Total size, in bytes, of all file stores across all seleced nodes.
  214.     `free`
  216.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Amount of unallocated disk space in file stores across all selected nodes.
  218.     `free_in_bytes`
  220.     (integer) Total number of unallocated bytes in file stores across all selected nodes.
  222.     `available`
  224.     ([byte units]($a397f9b7db759452.md#byte-units "Byte size units")) Total amount of disk space available to JVM in file stores across all selected nodes.
  226.     Depending on OS or process-level restrictions, this amount may be less than `nodes.fs.free`. This is the actual amount of free disk space the selected Elasticsearch nodes can use.
  228.     `available_in_bytes`
  230.     (integer) Total number of bytes available to JVM in file stores across all selected nodes.
  232.     Depending on OS or process-level restrictions, this number may be less than `nodes.fs.free_in_byes`. This is the actual amount of free disk space the selected Elasticsearch nodes can use.
  235. `plugins`
  237. (array of objects) Contains statistics about installed plugins and modules by selected nodes.
  239. If no plugins or modules are installed, this array is empty.
  241. Properties of `plugins`
  243. -   `<plugin>`
  245.     (object) Contains statistics about an installed plugin or module.
  247.     Properties of `<plugin>`
  249.     `name`
  251.     (string) Name of the Elasticsearch plugin.
  253.     `version`
  255.     (string) Elasticsearch version for which the plugin was built.
  257.     `elasticsearch_version`
  259.     (string) Elasticsearch version for which the plugin was built.
  261.     `java_version`
  263.     (string) Java version for which the plugin was built.
  265.     `description`
  267.     (string) Short description of the plugin.
  269.     `classname`
  271.     (string) Class name used as the plugin’s entry point.
  273.     `extended_plugins`
  275.     (array of strings) An array of other plugins extended by this plugin through the Java Service Provider Interface (SPI).
  277.     If this plugin extends no other plugins, this array is empty.
  279.     `has_native_controller`
  281.     (boolean) If `true`, the plugin has a native controller process.
  284. `network_types`
  286. (object) Contains statistics about the transport and HTTP networks used by selected nodes.
  288. Properties of `network_types`
  290. -   `transport_types`
  292.     (object) Contains statistics about the transport network types used by selected nodes.
  294.     Properties of `transport_types`
  296.     `<transport_type>`
  298.     (integer) Number of selected nodes using the transport type.
  300.     `http_types`
  302.     (object) Contains statistics about the HTTP network types used by selected nodes.
  304.     Properties of `http_types`
  306.     `<http_type>`
  308.     (integer) Number of selected nodes using the HTTP type.
  311. `discovery_types`
  313. (object) Contains statistics about the [discovery types]($101de214b32e765a.md "Discovery") used by selected nodes.
  315. Properties of `discovery_types`
  317. -   `<discovery_type>`
  319.     (integer) Number of selected nodes using the [discovery type]($101de214b32e765a.md "Discovery") to find other nodes.
  322. `packaging_types`
  324. (array of objects) Contains statistics about Elasticsearch distributions installed on selected nodes.
  326. Properties of `packaging_types`
  328. -   `flavor`
  330.     (string) Type of Elasticsearch distribution, such as `default` or `OSS`, used by one or more selected nodes.
  332.     `type`
  334.     (string) File type, such as `tar` or `zip`, used for the distribution package.
  336.     `count`
  338.     (integer) Number of selected nodes using the distribution flavor and file type.

Examples

  1. GET /_cluster/stats?human&pretty

The API returns the following response:

  1. {
  2.    "_nodes" : {
  3.       "total" : 1,
  4.       "successful" : 1,
  5.       "failed" : 0
  6.    },
  7.    "cluster_uuid": "YjAvIhsCQ9CbjWZb2qJw3Q",
  8.    "cluster_name": "elasticsearch",
  9.    "timestamp": 1459427693515,
  10.    "status": "green",
  11.    "indices": {
  12.       "count": 1,
  13.       "shards": {
  14.          "total": 5,
  15.          "primaries": 5,
  16.          "replication": 0,
  17.          "index": {
  18.             "shards": {
  19.                "min": 5,
  20.                "max": 5,
  21.                "avg": 5
  22.             },
  23.             "primaries": {
  24.                "min": 5,
  25.                "max": 5,
  26.                "avg": 5
  27.             },
  28.             "replication": {
  29.                "min": 0,
  30.                "max": 0,
  31.                "avg": 0
  32.             }
  33.          }
  34.       },
  35.       "docs": {
  36.          "count": 10,
  37.          "deleted": 0
  38.       },
  39.       "store": {
  40.          "size": "16.2kb",
  41.          "size_in_bytes": 16684,
  42.          "reserved": "0b",
  43.          "reserved_in_bytes": 0
  44.       },
  45.       "fielddata": {
  46.          "memory_size": "0b",
  47.          "memory_size_in_bytes": 0,
  48.          "evictions": 0
  49.       },
  50.       "query_cache": {
  51.          "memory_size": "0b",
  52.          "memory_size_in_bytes": 0,
  53.          "total_count": 0,
  54.          "hit_count": 0,
  55.          "miss_count": 0,
  56.          "cache_size": 0,
  57.          "cache_count": 0,
  58.          "evictions": 0
  59.       },
  60.       "completion": {
  61.          "size": "0b",
  62.          "size_in_bytes": 0
  63.       },
  64.       "segments": {
  65.          "count": 4,
  66.          "memory": "8.6kb",
  67.          "memory_in_bytes": 8898,
  68.          "terms_memory": "6.3kb",
  69.          "terms_memory_in_bytes": 6522,
  70.          "stored_fields_memory": "1.2kb",
  71.          "stored_fields_memory_in_bytes": 1248,
  72.          "term_vectors_memory": "0b",
  73.          "term_vectors_memory_in_bytes": 0,
  74.          "norms_memory": "384b",
  75.          "norms_memory_in_bytes": 384,
  76.          "points_memory" : "0b",
  77.          "points_memory_in_bytes" : 0,
  78.          "doc_values_memory": "744b",
  79.          "doc_values_memory_in_bytes": 744,
  80.          "index_writer_memory": "0b",
  81.          "index_writer_memory_in_bytes": 0,
  82.          "version_map_memory": "0b",
  83.          "version_map_memory_in_bytes": 0,
  84.          "fixed_bit_set": "0b",
  85.          "fixed_bit_set_memory_in_bytes": 0,
  86.          "max_unsafe_auto_id_timestamp" : -9223372036854775808,
  87.          "file_sizes": {}
  88.       },
  89.       "mappings": {
  90.         "field_types": []
  91.       },
  92.       "analysis": {
  93.         "char_filter_types": [],
  94.         "tokenizer_types": [],
  95.         "filter_types": [],
  96.         "analyzer_types": [],
  97.         "built_in_char_filters": [],
  98.         "built_in_tokenizers": [],
  99.         "built_in_filters": [],
  100.         "built_in_analyzers": []
  101.       }
  102.    },
  103.    "nodes": {
  104.       "count": {
  105.          "total": 1,
  106.          "data": 1,
  107.          "coordinating_only": 0,
  108.          "master": 1,
  109.          "ingest": 1,
  110.          "voting_only": 0
  111.       },
  112.       "versions": [
  113.          "7.9.1"
  114.       ],
  115.       "os": {
  116.          "available_processors": 8,
  117.          "allocated_processors": 8,
  118.          "names": [
  119.             {
  120.                "name": "Mac OS X",
  121.                "count": 1
  122.             }
  123.          ],
  124.          "pretty_names": [
  125.             {
  126.                "pretty_name": "Mac OS X",
  127.                "count": 1
  128.             }
  129.          ],
  130.          "mem" : {
  131.             "total" : "16gb",
  132.             "total_in_bytes" : 17179869184,
  133.             "free" : "78.1mb",
  134.             "free_in_bytes" : 81960960,
  135.             "used" : "15.9gb",
  136.             "used_in_bytes" : 17097908224,
  137.             "free_percent" : 0,
  138.             "used_percent" : 100
  139.          }
  140.       },
  141.       "process": {
  142.          "cpu": {
  143.             "percent": 9
  144.          },
  145.          "open_file_descriptors": {
  146.             "min": 268,
  147.             "max": 268,
  148.             "avg": 268
  149.          }
  150.       },
  151.       "jvm": {
  152.          "max_uptime": "13.7s",
  153.          "max_uptime_in_millis": 13737,
  154.          "versions": [
  155.             {
  156.                "version": "12",
  157.                "vm_name": "OpenJDK 64-Bit Server VM",
  158.                "vm_version": "12+33",
  159.                "vm_vendor": "Oracle Corporation",
  160.                "bundled_jdk": true,
  161.                "using_bundled_jdk": true,
  162.                "count": 1
  163.             }
  164.          ],
  165.          "mem": {
  166.             "heap_used": "57.5mb",
  167.             "heap_used_in_bytes": 60312664,
  168.             "heap_max": "989.8mb",
  169.             "heap_max_in_bytes": 1037959168
  170.          },
  171.          "threads": 90
  172.       },
  173.       "fs": {
  174.          "total": "200.6gb",
  175.          "total_in_bytes": 215429193728,
  176.          "free": "32.6gb",
  177.          "free_in_bytes": 35064553472,
  178.          "available": "32.4gb",
  179.          "available_in_bytes": 34802409472
  180.       },
  181.       "plugins": [
  182.         {
  183.           "name": "analysis-icu",
  184.           "version": "7.9.1",
  185.           "description": "The ICU Analysis plugin integrates Lucene ICU module into elasticsearch, adding ICU relates analysis components.",
  186.           "classname": "org.elasticsearch.plugin.analysis.icu.AnalysisICUPlugin",
  187.           "has_native_controller": false
  188.         },
  189.         ...
  190.       ],
  191.       "ingest": {
  192.         "number_of_pipelines" : 1,
  193.         "processor_stats": {
  194.           ...
  195.         }
  196.       },
  197.       "network_types": {
  198.         ...
  199.       },
  200.       "discovery_types": {
  201.         ...
  202.       },
  203.       "packaging_types": [
  204.         {
  205.           ...
  206.         }
  207.       ]
  208.    }
  209. }

This API can be restricted to a subset of the nodes using node filters:

  1. GET /_cluster/stats/nodes/node1,node*,master:false