---
title: stack es nodes stats cli command
description: Get node statistics. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4083/reference/elastic-cli/cli/stack/es/nodes/stats
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es nodes stats cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es nodes stats [options]
```

Get node statistics.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--completion-fields string">
    Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.
    **Repeatable:** pass `--completion-fields` multiple times to supply more than one value
  </definition>
  <definition term="--fielddata-fields string">
    Comma-separated list or wildcard expressions of fields to include in fielddata statistics.
    **Repeatable:** pass `--fielddata-fields` multiple times to supply more than one value
  </definition>
  <definition term="--fields string">
    Comma-separated list or wildcard expressions of fields to include in the statistics.
    **Repeatable:** pass `--fields` multiple times to supply more than one value
  </definition>
  <definition term="--groups">
    Comma-separated list of search groups to include in the search statistics.
  </definition>
  <definition term="--include-segment-file-sizes">
    If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).
  </definition>
  <definition term="--level enum">
    Indicates whether statistics are aggregated at the node, indices, or shards level.
    **Values:** node, indices, shards
  </definition>
  <definition term="--timeout string">
    Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
  </definition>
  <definition term="--types string[]">
    A comma-separated list of document types for the indexing index metric.
    **Repeatable:** pass `--types` multiple times to supply more than one value
  </definition>
  <definition term="--include-unloaded-segments">
    If `true`, the response includes information from segments that are not loaded into memory.
  </definition>
  <definition term="--node-id string">
    Comma-separated list of node IDs or names used to limit returned information.
    **Repeatable:** pass `--node-id` multiple times to supply more than one value
  </definition>
  <definition term="--metric enum">
    Limits the information returned to the specific metrics.
    **Values:** _all, _none, indices, os, process, jvm, thread_pool, fs, transport, http, breaker, script, discovery, ingest, adaptive_selection, script_cache, indexing_pressure, repositories, allocations
    **Repeatable:** pass `--metric` multiple times to supply more than one value
  </definition>
  <definition term="--index-metric enum">
    Limit the information returned for indices metric to the specific index metrics. It can be used only if indices (or all) metric is specified.
    **Values:** _all, store, indexing, get, search, merge, flush, refresh, query_cache, fielddata, docs, warmer, completion, segments, translog, request_cache, recovery, bulk, shard_stats, mappings, dense_vector, sparse_vector
    **Repeatable:** pass `--index-metric` multiple times to supply more than one value
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>