Get cluster statistics
Added in 1.3.0
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).
Path parameters
-
Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.
Query parameters
-
Include remote cluster data into the response
-
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.Values are
-1
or0
.
Responses
-
Hide response attributes Show response attributes object
-
Hide _nodes attributes Show _nodes attributes object
-
Hide failures attributes Show failures attributes object
-
Total number of nodes selected by the request.
-
Number of nodes that responded successfully to the request.
-
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.
-
-
Hide indices attributes Show indices attributes object
-
Hide analysis attributes Show analysis attributes object
-
Contains statistics about analyzer types used in selected nodes.
Hide analyzer_types attributes Show analyzer_types attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about built-in analyzers used in selected nodes.
Hide built_in_analyzers attributes Show built_in_analyzers attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about built-in character filters used in selected nodes.
Hide built_in_char_filters attributes Show built_in_char_filters attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about built-in token filters used in selected nodes.
Hide built_in_filters attributes Show built_in_filters attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about built-in tokenizers used in selected nodes.
Hide built_in_tokenizers attributes Show built_in_tokenizers attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about character filter types used in selected nodes.
Hide char_filter_types attributes Show char_filter_types attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about token filter types used in selected nodes.
Hide filter_types attributes Show filter_types attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about tokenizer types used in selected nodes.
Hide tokenizer_types attributes Show tokenizer_types attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
-
Hide completion attributes Show completion attributes object
-
Total number of indices with shards assigned to selected nodes.
-
Hide docs attributes Show docs attributes object
-
Total number of non-deleted documents across all primary shards assigned to selected nodes. This number is based on documents in Lucene segments and may include documents from nested fields.
-
Total number of deleted documents across all primary shards assigned to selected nodes. This number is based on documents in Lucene segments. Elasticsearch reclaims the disk space of deleted Lucene documents when a segment is merged.
-
-
Hide fielddata attributes Show fielddata attributes object
-
Hide query_cache attributes Show query_cache attributes object
-
Total number of entries added to the query cache across all shards assigned to selected nodes. This number includes current and evicted entries.
-
Total number of entries currently in the query cache across all shards assigned to selected nodes.
-
Total number of query cache evictions across all shards assigned to selected nodes.
-
Total count of query cache hits across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes.
-
Total count of query cache misses across all shards assigned to selected nodes.
-
Total count of hits and misses in the query cache across all shards assigned to selected nodes.
-
-
Hide segments attributes Show segments attributes object
-
Total number of segments across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes.
-
This object is not populated by the cluster stats API. To get information on segment files, use the node stats API.
-
Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes.
-
Unix timestamp, in milliseconds, of the most recently retried indexing request.
-
Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for points across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes.
-
Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes.
-
-
Hide shards attributes Show shards attributes object
-
Hide index attributes Show index attributes object
-
Hide primaries attributes Show primaries attributes object
-
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
-
Hide replication attributes Show replication attributes object
-
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
-
Hide shards attributes Show shards attributes object
-
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
-
-
Number of primary shards assigned to selected nodes.
-
Ratio of replica shards to primary shards across all selected nodes.
-
Total number of shards assigned to selected nodes.
-
-
Hide store attributes Show store attributes object
-
Total size, in bytes, of all shards assigned to selected nodes.
-
A prediction, in bytes, of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
-
Total data set size, in bytes, of all shards assigned to selected nodes. This includes the size of shards not stored fully on the nodes, such as the cache for partially mounted indices.
-
Hide mappings attributes Show mappings attributes object
-
Contains statistics about field data types used in selected nodes.
Hide field_types attributes Show field_types attributes object
-
The number of occurrences of the field type in selected nodes.
-
The number of indices containing the field type in selected nodes.
-
For dense_vector field types, number of indexed vector types in selected nodes.
-
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
The number of fields that declare a script.
-
Contains statistics about runtime field data types used in selected nodes.
Hide runtime_field_types attributes Show runtime_field_types attributes object
-
Maximum number of characters for a single runtime field script.
-
Total number of characters for the scripts that define the current runtime field data type.
-
Number of runtime fields mapped to the field data type in selected nodes.
-
Maximum number of accesses to doc_values for a single runtime field script
-
Total number of accesses to doc_values for the scripts that define the current runtime field data type.
-
Number of indices containing a mapping of the runtime field data type in selected nodes.
-
Script languages used for the runtime fields scripts.
-
Maximum number of lines for a single runtime field script.
-
Total number of lines for the scripts that define the current runtime field data type.
-
Number of runtime fields that don’t declare a script.
-
Number of runtime fields that shadow an indexed field.
-
Maximum number of accesses to _source for a single runtime field script.
-
Total number of accesses to _source for the scripts that define the current runtime field data type.
-
-
Total number of fields in all non-system indices.
-
Total number of fields in all non-system indices, accounting for mapping deduplication.
-
Total size of all mappings, in bytes, after deduplication and compression.
-
-
Contains statistics about analyzers and analyzer components used in selected nodes.
-
-
Hide nodes attributes Show nodes attributes object
-
Hide count attributes Show count attributes object
-
Contains statistics about the discovery types used by selected nodes.
-
Hide fs attributes Show fs attributes object
-
Total number of bytes available to JVM in file stores across all selected nodes. Depending on operating system 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. -
Total number of unallocated bytes in file stores across all selected nodes.
-
Total size, in bytes, of all file stores across all selected nodes.
-
-
Hide indexing_pressure attribute Show indexing_pressure attribute object
-
Hide memory attributes Show memory attributes object
-
Hide current attributes Show current attributes object
-
Hide total attributes Show total attributes object
-
-
-
Hide ingest attributes Show ingest attributes object
-
Hide processor_stats attribute Show processor_stats attribute object
-
Hide * attributes Show * attributes object
-
-
Hide jvm attributes Show jvm attributes object
-
Time unit for milliseconds
-
Number of active threads in use by JVM across all selected nodes.
-
Contains statistics about the JVM versions used by selected nodes.
Hide versions attributes Show versions attributes object
-
Always
true
. All distributions come with a bundled Java Development Kit (JDK). -
Total number of selected nodes using JVM.
-
If
true
, a bundled JDK is in use by JVM. -
Name of the JVM.
-
Vendor of the JVM.
-
-
-
Hide network_types attributes Show network_types attributes object
-
Contains statistics about the HTTP network types used by selected nodes.
-
Contains statistics about the transport network types used by selected nodes.
-
-
Hide os attributes Show os attributes object
-
Number of processors used to calculate thread pool size across all selected nodes. This number can be set with the processors setting of a node and defaults to the number of processors reported by the operating system. In both cases, this number will never be larger than 32.
-
Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes.
-
Number of processors available to JVM across all selected nodes.
-
Hide mem attributes Show mem attributes object
-
Total amount, in bytes, of memory across all selected nodes, but using the value specified using the
es.total_memory_bytes
system property instead of measured total memory for those nodes where that system property was set. -
Amount, in bytes, of free physical memory across all selected nodes.
-
Percentage of free physical memory across all selected nodes.
-
Total amount, in bytes, of physical memory across all selected nodes.
-
Amount, in bytes, of physical memory in use across all selected nodes.
-
Percentage of physical memory in use across all selected nodes.
-
-
Contains statistics about operating systems used by selected nodes.
-
Contains statistics about operating systems used by selected nodes.
-
-
Contains statistics about Elasticsearch distributions installed on selected nodes.
Hide packaging_types attributes Show packaging_types attributes object
-
Contains statistics about installed plugins and modules by selected nodes. If no plugins or modules are installed, this array is empty.
Hide plugins attributes Show plugins attributes object
-
Hide process attributes Show process attributes object
-
Hide open_file_descriptors attributes Show open_file_descriptors attributes object
-
Average number of concurrently open file descriptors. Returns
-1
if not supported. -
Maximum number of concurrently open file descriptors allowed across all selected nodes. Returns
-1
if not supported. -
Minimum number of concurrently open file descriptors across all selected nodes. Returns -1 if not supported.
-
-
Array of Elasticsearch versions used on selected nodes.
-
-
Values are
green
,GREEN
,yellow
,YELLOW
,red
, orRED
. -
Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed.
-
Hide ccs attributes Show ccs attributes object
-
Contains remote cluster settings and metrics collected from them. The keys are cluster names, and the values are per-cluster data. Only present if
include_remotes
option is set to true.Hide clusters attribute Show clusters attribute object
-
Hide * attributes Show * attributes object
-
The UUID of the remote cluster.
-
The connection mode used to communicate with the remote cluster.
-
The
skip_unavailable
setting used for this remote cluster. -
Transport compression setting used for this remote cluster.
-
Values are
green
,GREEN
,yellow
,YELLOW
,red
, orRED
. -
The list of Elasticsearch versions used by the nodes on the remote cluster.
-
The total count of nodes in the remote cluster.
-
The total number of shards in the remote cluster.
-
The total number of indices in the remote cluster.
-
Total data set size, in bytes, of all shards assigned to selected nodes.
-
Total data set size of all shards assigned to selected nodes, as a human-readable string.
-
Maximum amount of memory, in bytes, available for use by the heap across the nodes of the remote cluster.
-
Maximum amount of memory available for use by the heap across the nodes of the remote cluster, as a human-readable string.
-
Total amount, in bytes, of physical memory across the nodes of the remote cluster.
-
Total amount of physical memory across the nodes of the remote cluster, as a human-readable string.
-
-
-
Hide _search attributes Show _search attributes object
-
The total number of cross-cluster search requests that have been executed by the cluster.
-
The total number of cross-cluster search requests that have been successfully executed by the cluster.
-
The total number of cross-cluster search requests (successful or failed) that had at least one remote cluster skipped.
-
Hide took attributes Show took attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
Hide took_mrt_true attributes Show took_mrt_true attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
Hide took_mrt_false attributes Show took_mrt_false attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
The maximum number of remote clusters that were queried in a single cross-cluster search request.
-
The average number of remote clusters that were queried in a single cross-cluster search request.
-
Statistics about the reasons for cross-cluster search request failures. The keys are the failure reason names and the values are the number of requests that failed for that reason.
-
The keys are the names of the search feature, and the values are the number of requests that used that feature. Single request can use more than one feature (e.g. both
async
andwildcard
). -
Statistics about the clients that executed cross-cluster search requests. The keys are the names of the clients, and the values are the number of requests that were executed by that client. Only known clients (such as
kibana
orelasticsearch
) are counted. -
Statistics about the clusters that were queried in cross-cluster search requests. The keys are cluster names, and the values are per-cluster telemetry data. This also includes the local cluster itself, which uses the name
(local)
.Hide clusters attribute Show clusters attribute object
-
Hide * attributes Show * attributes object
-
The total number of successful (not skipped) cross-cluster search requests that were executed against this cluster. This may include requests where partial results were returned, but not requests in which the cluster has been skipped entirely.
-
The total number of cross-cluster search requests for which this cluster was skipped.
-
-
-
-
Hide _esql attributes Show _esql attributes object
-
The total number of cross-cluster search requests that have been executed by the cluster.
-
The total number of cross-cluster search requests that have been successfully executed by the cluster.
-
The total number of cross-cluster search requests (successful or failed) that had at least one remote cluster skipped.
-
Hide took attributes Show took attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
Hide took_mrt_true attributes Show took_mrt_true attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
Hide took_mrt_false attributes Show took_mrt_false attributes object
-
Time unit for milliseconds
-
Time unit for milliseconds
-
Time unit for milliseconds
-
-
The maximum number of remote clusters that were queried in a single cross-cluster search request.
-
The average number of remote clusters that were queried in a single cross-cluster search request.
-
Statistics about the reasons for cross-cluster search request failures. The keys are the failure reason names and the values are the number of requests that failed for that reason.
-
The keys are the names of the search feature, and the values are the number of requests that used that feature. Single request can use more than one feature (e.g. both
async
andwildcard
). -
Statistics about the clients that executed cross-cluster search requests. The keys are the names of the clients, and the values are the number of requests that were executed by that client. Only known clients (such as
kibana
orelasticsearch
) are counted. -
Statistics about the clusters that were queried in cross-cluster search requests. The keys are cluster names, and the values are per-cluster telemetry data. This also includes the local cluster itself, which uses the name
(local)
.Hide clusters attribute Show clusters attribute object
-
Hide * attributes Show * attributes object
-
The total number of successful (not skipped) cross-cluster search requests that were executed against this cluster. This may include requests where partial results were returned, but not requests in which the cluster has been skipped entirely.
-
The total number of cross-cluster search requests for which this cluster was skipped.
-
-
-
-
-
curl \
--request GET 'http://api.example.com/_cluster/stats/nodes/{node_id}' \
--header "Authorization: $API_KEY"