# Get cluster statistics


**GET /_cluster/stats/nodes/{node_id}**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_cluster/stats</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_cluster/stats/nodes/{node_id}</span>
                      </div>
                    

Get 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).

## Required authorization

* Cluster privileges: `monitor`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **node_id** (string | array[string])
  Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.

### Query parameters
- **include_remotes** (boolean)
  Include remote cluster data into the response
- **timeout** (string)
  Period to wait for each node to respond.
  If a node does not respond before its timeout expires, the response does not include its stats.
  However, timed out nodes are included in the response’s `_nodes.failed` property. Defaults to no timeout.


## Responses
### 200


#### Body: application/json (object)
- **_nodes** (object)
  Contains statistics about the number of nodes selected by the request’s node filters.
- **cluster_name** (string)
  Name of the cluster, based on the cluster name setting.
- **cluster_uuid** (string)
  Unique identifier for the cluster.
- **indices** (object)
  Contains statistics about indices with shards assigned to selected nodes.
- **nodes** (object)
  Contains statistics about nodes selected by the request’s node filters.
- **repositories** (object)
  Contains stats on repository feature usage exposed in cluster stats for telemetry.
- **snapshots** (object)
  Contains stats cluster snapshots.
- **status** (string)
  Health status of the cluster, based on the state of its primary and replica shards.

  Supported values include:
    - `green` (or `GREEN`): All shards are assigned.
    - `yellow` (or `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` (or `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.
    - `unknown`
    - `unavailable`

- **timestamp** (number)
  Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed.
- **ccs** (object)
  Cross-cluster stats


[Powered by Bump.sh](https://bump.sh)