Get cluster statistics
- GET /_cluster/stats/nodes/{node_id}
- GET /_cluster/stats
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).
- Cluster privileges:
monitor
Path Parameters
-
node_idNodeId | NodeIdoptional -
Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.
Leave it out to use
/_cluster/stats.
Query Parameters
-
include_remotesboolean · default: false Include remote cluster data into the response
-
timeoutstring Duration 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.failedproperty. Defaults to no timeout.
Response
-
_nodesNodeStatistics -
Contains statistics about the number of nodes selected by the request’s node filters.
-
failuresErrorCause -
typestringrequired -
The type of error
-
reasonstringnullable -
A human-readable explanation of the error, in English.
-
stack_tracestring -
The server stack trace. Present only if the
error_trace=trueparameter was sent with the request. -
caused_byErrorCause -
root_causeErrorCause -
suppressedErrorCause -
totalnumberrequired -
Total number of nodes selected by the request.
-
successfulnumberrequired -
Number of nodes that responded successfully to the request.
-
failednumberrequired -
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_namestring Namerequired -
Name of the cluster, based on the cluster name setting.
-
cluster_uuidstringrequired -
Unique identifier for the cluster.
-
indicesClusterIndicesrequired -
Contains statistics about indices with shards assigned to selected nodes.
-
analysisCharFilterTypes -
Contains statistics about analyzers and analyzer components used in selected nodes.
-
analyzer_typesFieldTypesrequired -
Contains statistics about analyzer types used in selected nodes.
-
namestring Namerequired -
The name for the field type in selected nodes.
-
countnumberrequired -
The number of occurrences of the field type in selected nodes.
-
index_countnumberrequired -
The number of indices containing the field type in selected nodes.
-
indexed_vector_countnumber -
For dense_vector field types, number of indexed vector types in selected nodes.
-
indexed_vector_dim_maxnumber -
For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
indexed_vector_dim_minnumber -
For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
script_countnumber -
The number of fields that declare a script.
-
vector_index_type_countmap string to number -
For dense_vector field types, count of mappings by index type
-
vector_similarity_type_countmap string to number -
For dense_vector field types, count of mappings by similarity
-
vector_element_type_countmap string to number -
For dense_vector field types, count of mappings by element type
-
built_in_analyzersFieldTypesrequired -
Contains statistics about built-in analyzers used in selected nodes.
-
built_in_char_filtersFieldTypesrequired -
Contains statistics about built-in character filters used in selected nodes.
-
built_in_filtersFieldTypesrequired -
Contains statistics about built-in token filters used in selected nodes.
-
built_in_tokenizersFieldTypesrequired -
Contains statistics about built-in tokenizers used in selected nodes.
-
char_filter_typesFieldTypesrequired -
Contains statistics about character filter types used in selected nodes.
-
multiple_synonym_graph_filtersMultipleSynonymGraphFilter -
analyzer_countnumber · default: 0 -
Number of analyzers across the cluster whose filter chain contains more than one synonym_graph filter.
-
index_countnumber · default: 0 -
Number of indices that contain at least one analyzer with more than one synonym_graph filter.
-
filter_typesFieldTypesrequired -
Contains statistics about token filter types used in selected nodes.
-
tokenizer_typesFieldTypesrequired -
Contains statistics about tokenizer types used in selected nodes.
-
synonymsmap string to SynonymsStatsrequired -
Contains statistics about synonyms types used in selected nodes.
-
<string>SynonymsStats -
countnumberrequired -
index_countnumberrequired -
completionCompletionStatsrequired -
Contains statistics about memory used for completion in selected nodes.
-
size_in_bytesnumberrequired -
Total amount, in bytes, of memory used for completion across all shards assigned to selected nodes.
-
sizenumber | string ByteSize -
Total amount of memory used for completion across all shards assigned to selected nodes.
-
fieldsmap string to FieldSizeUsage -
<string>FieldSizeUsage -
sizenumber | string ByteSize -
size_in_bytesnumberrequired -
countnumberrequired -
Total number of indices with shards assigned to selected nodes.
-
docsDocStatsrequired -
Contains counts for documents in selected nodes.
-
countnumberrequired -
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.
-
deletednumber -
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.
-
total_size_in_bytesnumberrequired -
Returns the total size in bytes of all documents in this stats. This value may be more reliable than store_stats.size_in_bytes in estimating the index size.
-
total_sizenumber | string ByteSize -
Human readable total_size_in_bytes
-
fielddataFielddataStatsrequired -
Contains statistics about the field data cache of selected nodes.
-
evictionsnumber -
memory_sizenumber | string ByteSize -
memory_size_in_bytesnumberrequired -
fieldsmap string to FieldMemoryUsage -
<string>FieldMemoryUsage -
memory_sizenumber | string ByteSize -
memory_size_in_bytesnumberrequired -
global_ordinalsGlobalOrdinalsStatsrequired -
build_time_in_millisnumberrequired -
build_timestring -
fieldsmap string to GlobalOrdinalFieldStats -
<string>GlobalOrdinalFieldStats -
build_time_in_millisnumberrequired -
build_timestring -
shard_max_value_countnumberrequired -
query_cacheQueryCacheStatsrequired -
Contains statistics about the query cache of selected nodes.
-
cache_countnumberrequired -
Total number of entries added to the query cache across all shards assigned to selected nodes. This number includes current and evicted entries.
-
cache_sizenumberrequired -
Total number of entries currently in the query cache across all shards assigned to selected nodes.
-
evictionsnumberrequired -
Total number of query cache evictions across all shards assigned to selected nodes.
-
hit_countnumberrequired -
Total count of query cache hits across all shards assigned to selected nodes.
-
memory_sizenumber | string ByteSize -
Total amount of memory used for the query cache across all shards assigned to selected nodes.
-
memory_size_in_bytesnumberrequired -
Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes.
-
miss_countnumberrequired -
Total count of query cache misses across all shards assigned to selected nodes.
-
total_countnumberrequired -
Total count of hits and misses in the query cache across all shards assigned to selected nodes.
-
searchSearchUsageStatsrequired -
Holds a snapshot of the search usage statistics. Used to hold the stats for a single node that's part of a ClusterStatsNodeResponse, as well as to accumulate stats for the entire cluster and return them as part of the ClusterStatsResponse.
-
totalnumberrequired -
queriesmap string to numberrequired -
rescorersmap string to numberrequired -
sectionsmap string to numberrequired -
retrieversmap string to numberrequired -
extendedExtendedSearchUsagerequired -
retrieversExtendedRetrieversSearchUsage -
text_similarity_rerankerExtendedTextSimilarityRetrieverUsage -
chunk_rescorernumber -
segmentsSegmentsStatsrequired -
Contains statistics about segments in selected nodes.
-
countnumberrequired -
Total number of segments across all shards assigned to selected nodes.
-
doc_values_memorynumber | string ByteSize -
Total amount of memory used for doc values across all shards assigned to selected nodes.
-
doc_values_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes.
-
file_sizesmap string to ShardFileSizeInforequired -
This object is not populated by the cluster stats API. To get information on segment files, use the node stats API.
-
<string>ShardFileSizeInfo -
descriptionstringrequired -
size_in_bytesnumberrequired -
min_size_in_bytesnumber -
max_size_in_bytesnumber -
average_size_in_bytesnumber -
countnumber -
fixed_bit_setnumber | string ByteSize -
Total amount of memory used by fixed bit sets across all shards assigned to selected nodes. Fixed bit sets are used for nested object field types and type filters for join fields.
-
fixed_bit_set_memory_in_bytesnumberrequired -
Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes.
-
index_writer_memorynumber | string ByteSize -
Total amount of memory used by all index writers across all shards assigned to selected nodes.
-
index_writer_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes.
-
max_unsafe_auto_id_timestampnumberrequired -
Unix timestamp, in milliseconds, of the most recently retried indexing request.
-
memorynumber | string ByteSize -
Total amount of memory used for segments across all shards assigned to selected nodes.
-
memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes.
-
norms_memorynumber | string ByteSize -
Total amount of memory used for normalization factors across all shards assigned to selected nodes.
-
norms_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes.
-
points_memorynumber | string ByteSize -
Total amount of memory used for points across all shards assigned to selected nodes.
-
points_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for points across all shards assigned to selected nodes.
-
stored_fields_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes.
-
stored_fields_memorynumber | string ByteSize -
Total amount of memory used for stored fields across all shards assigned to selected nodes.
-
terms_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes.
-
terms_memorynumber | string ByteSize -
Total amount of memory used for terms across all shards assigned to selected nodes.
-
term_vectors_memorynumber | string ByteSize -
Total amount of memory used for term vectors across all shards assigned to selected nodes.
-
term_vectors_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes.
-
version_map_memorynumber | string ByteSize -
Total amount of memory used by all version maps across all shards assigned to selected nodes.
-
version_map_memory_in_bytesnumberrequired -
Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes.
-
shardsClusterIndicesShardsrequired -
Contains statistics about indices with shards assigned to selected nodes.
-
indexClusterIndicesShardsIndex -
Contains statistics about shards assigned to selected nodes.
-
primariesClusterShardMetricsrequired -
Contains statistics about the number of primary shards assigned to selected nodes.
-
avgnumberrequired -
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
maxnumberrequired -
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
minnumberrequired -
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
replicationClusterShardMetricsrequired -
Contains statistics about the number of replication shards assigned to selected nodes.
-
avgnumberrequired -
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
maxnumberrequired -
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
minnumberrequired -
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
shardsClusterShardMetricsrequired -
Contains statistics about the number of shards assigned to selected nodes.
-
avgnumberrequired -
Mean number of shards in an index, counting only shards assigned to selected nodes.
-
maxnumberrequired -
Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
minnumberrequired -
Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
primariesnumber -
Number of primary shards assigned to selected nodes.
-
replicationnumber -
Ratio of replica shards to primary shards across all selected nodes.
-
totalnumber -
Total number of shards assigned to selected nodes.
-
storeStoreStatsrequired -
Contains statistics about the size of shards assigned to selected nodes.
-
sizenumber | string ByteSize -
Total size of all shards assigned to selected nodes.
-
size_in_bytesnumberrequired -
Total size, in bytes, of all shards assigned to selected nodes.
-
reservednumber | string ByteSize -
A prediction of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
-
reserved_in_bytesnumberrequired -
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_sizenumber | string ByteSize -
Total data set size 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.
-
total_data_set_size_in_bytesnumber -
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.
-
mappingsFieldTypesMappings -
Contains statistics about field mappings in selected nodes.
-
field_typesFieldTypesrequired -
Contains statistics about field data types used in selected nodes.
-
runtime_field_typesRuntimeFieldTypesrequired -
Contains statistics about runtime field data types used in selected nodes.
-
chars_maxnumberrequired -
Maximum number of characters for a single runtime field script.
-
chars_totalnumberrequired -
Total number of characters for the scripts that define the current runtime field data type.
-
countnumberrequired -
Number of runtime fields mapped to the field data type in selected nodes.
-
doc_maxnumberrequired -
Maximum number of accesses to doc_values for a single runtime field script
-
doc_totalnumberrequired -
Total number of accesses to doc_values for the scripts that define the current runtime field data type.
-
index_countnumberrequired -
Number of indices containing a mapping of the runtime field data type in selected nodes.
-
langstringrequired -
Script languages used for the runtime fields scripts.
-
lines_maxnumberrequired -
Maximum number of lines for a single runtime field script.
-
lines_totalnumberrequired -
Total number of lines for the scripts that define the current runtime field data type.
-
namestring Namerequired -
Field data type used in selected nodes.
-
scriptless_countnumberrequired -
Number of runtime fields that don’t declare a script.
-
shadowed_countnumberrequired -
Number of runtime fields that shadow an indexed field.
-
source_maxnumberrequired -
Maximum number of accesses to _source for a single runtime field script.
-
source_totalnumberrequired -
Total number of accesses to _source for the scripts that define the current runtime field data type.
-
total_field_countnumber -
Total number of fields in all non-system indices.
-
total_deduplicated_field_countnumber -
Total number of fields in all non-system indices, accounting for mapping deduplication.
-
total_deduplicated_mapping_sizenumber | string ByteSize -
Total size of all mappings after deduplication and compression.
-
total_deduplicated_mapping_size_in_bytesnumber -
Total size of all mappings, in bytes, after deduplication and compression.
-
source_modesmap string to numberrequired -
Source mode usage count.
-
versionsIndicesVersions -
Contains statistics about analyzers and analyzer components used in selected nodes.
-
index_countnumberrequired -
primary_shard_countnumberrequired -
total_primary_bytesnumberrequired -
total_primary_sizenumber | string ByteSize -
versionstringrequired -
dense_vectorDenseVectorStatsrequired -
Contains statistics about indexed dense vector
-
value_countnumberrequired -
off_heapDenseVectorOffHeapStats -
total_size_bytesnumberrequired -
total_sizenumber | string ByteSize -
total_veb_size_bytesnumberrequired -
total_veb_sizenumber | string ByteSize -
total_vec_size_bytesnumberrequired -
total_vec_sizenumber | string ByteSize -
total_veq_size_bytesnumberrequired -
total_veq_sizenumber | string ByteSize -
total_vex_size_bytesnumberrequired -
total_vex_sizenumber | string ByteSize -
total_cenivf_size_bytesnumberrequired -
total_cenivf_sizenumber | string ByteSize -
total_clivf_size_bytesnumberrequired -
total_clivf_sizenumber | string ByteSize -
fielddatamap string to string to number -
sparse_vectorSparseVectorStatsrequired -
Contains statistics about indexed sparse vector
-
value_countnumberrequired -
nodesClusterNodesrequired -
Contains statistics about nodes selected by the request’s node filters.
-
countClusterNodeCountrequired -
Contains counts for nodes selected by the request’s node filters.
-
totalnumberrequired -
coordinating_onlynumber -
datanumber -
data_coldnumber -
data_contentnumber -
data_frozennumber -
data_hotnumber -
data_warmnumber -
indexnumber -
ingestnumber -
masternumber -
mlnumber -
remote_cluster_clientnumber -
searchnumber -
transformnumber -
voting_onlynumber -
discovery_typesmap string to numberrequired -
Contains statistics about the discovery types used by selected nodes.
-
fsClusterFileSystemrequired -
Contains statistics about file stores by selected nodes.
-
pathstring -
mountstring -
typestring -
available_in_bytesnumber -
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. -
availablenumber | string ByteSize -
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. -
free_in_bytesnumber -
Total number, in bytes, of unallocated bytes in file stores across all selected nodes.
-
freenumber | string ByteSize -
Total number of unallocated bytes in file stores across all selected nodes.
-
total_in_bytesnumber -
Total size, in bytes, of all file stores across all selected nodes.
-
totalnumber | string ByteSize -
Total size of all file stores across all selected nodes.
-
low_watermark_free_spacenumber | string ByteSize -
high_watermark_free_spacenumber | string ByteSize -
flood_stage_free_spacenumber | string ByteSize -
frozen_flood_stage_free_spacenumber | string ByteSize -
indexing_pressureIndexingPressurerequired -
memoryIndexingPressureMemoryrequired -
limitnumber | string ByteSize -
Configured memory limit for the indexing requests. Replica requests have an automatic limit that is 1.5x this value.
-
limit_in_bytesnumber -
Configured memory limit, in bytes, for the indexing requests. Replica requests have an automatic limit that is 1.5x this value.
-
currentPressureMemory -
Contains statistics for current indexing load.
-
allnumber | string ByteSize -
Memory consumed by indexing requests in the coordinating, primary, or replica stage.
-
all_in_bytesnumber -
Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage.
-
combined_coordinating_and_primarynumber | string ByteSize -
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_bytesnumber -
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.
-
coordinatingnumber | string ByteSize -
Memory consumed by indexing requests in the coordinating stage.
-
coordinating_in_bytesnumber -
Memory consumed, in bytes, by indexing requests in the coordinating stage.
-
primarynumber | string ByteSize -
Memory consumed by indexing requests in the primary stage.
-
primary_in_bytesnumber -
Memory consumed, in bytes, by indexing requests in the primary stage.
-
replicanumber | string ByteSize -
Memory consumed by indexing requests in the replica stage.
-
replica_in_bytesnumber -
Memory consumed, in bytes, by indexing requests in the replica stage.
-
coordinating_rejectionsnumber -
Number of indexing requests rejected in the coordinating stage.
-
primary_rejectionsnumber -
Number of indexing requests rejected in the primary stage.
-
replica_rejectionsnumber -
Number of indexing requests rejected in the replica stage.
-
primary_document_rejectionsnumber -
large_operation_rejectionsnumber -
totalPressureMemory -
Contains statistics for the cumulative indexing load since the node started.
-
ingestClusterIngestrequired -
number_of_pipelinesnumberrequired -
processor_statsmap string to ClusterProcessorrequired -
<string>ClusterProcessor -
countnumberrequired -
currentnumberrequired -
failednumberrequired -
timestring Duration -
time_in_millisDurationValueUnitMillisrequired -
jvmClusterJvmrequired -
Contains statistics about the Java Virtual Machines (JVMs) used by selected nodes.
-
max_uptime_in_millisDurationValueUnitMillisrequired -
Uptime duration, in milliseconds, since JVM last started.
-
max_uptimestring Duration -
Uptime duration since JVM last started.
-
memClusterJvmMemoryrequired -
Contains statistics about memory used by selected nodes.
-
heap_max_in_bytesnumberrequired -
Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.
-
heap_maxnumber | string ByteSize -
Maximum amount of memory available for use by the heap across all selected nodes.
-
heap_used_in_bytesnumberrequired -
Memory, in bytes, currently in use by the heap across all selected nodes.
-
heap_usednumber | string ByteSize -
Memory currently in use by the heap across all selected nodes.
-
threadsnumberrequired -
Number of active threads in use by JVM across all selected nodes.
-
versionsClusterJvmVersionrequired -
Contains statistics about the JVM versions used by selected nodes.
-
bundled_jdkbooleanrequired -
Always
true. All distributions come with a bundled Java Development Kit (JDK). -
countnumberrequired -
Total number of selected nodes using JVM.
-
using_bundled_jdkbooleanrequired -
If
true, a bundled JDK is in use by JVM. -
versionstringrequired -
Version of JVM used by one or more selected nodes.
-
vm_namestringrequired -
Name of the JVM.
-
vm_vendorstringrequired -
Vendor of the JVM.
-
vm_versionstringrequired -
Full version number of JVM. The full version number includes a plus sign (+) followed by the build number.
-
network_typesClusterNetworkTypesrequired -
Contains statistics about the transport and HTTP networks used by selected nodes.
-
http_typesmap string to numberrequired -
Contains statistics about the HTTP network types used by selected nodes.
-
transport_typesmap string to numberrequired -
Contains statistics about the transport network types used by selected nodes.
-
osClusterOperatingSystemrequired -
Contains statistics about the operating systems used by selected nodes.
-
allocated_processorsnumberrequired -
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.
-
architecturesClusterOperatingSystemArchitecture -
Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes.
-
available_processorsnumberrequired -
Number of processors available to JVM across all selected nodes.
-
memOperatingSystemMemoryInforequired -
Contains statistics about memory used by selected nodes.
-
adjusted_total_in_bytesnumber -
Total amount, in bytes, of memory across all selected nodes, but using the value specified using the
es.total_memory_bytessystem property instead of measured total memory for those nodes where that system property was set. -
adjusted_totalnumber | string ByteSize -
Total amount of memory across all selected nodes, but using the value specified using the
es.total_memory_bytessystem property instead of measured total memory for those nodes where that system property was set. -
free_in_bytesnumberrequired -
Amount, in bytes, of free physical memory across all selected nodes.
-
freenumber | string ByteSize -
Amount of free physical memory across all selected nodes.
-
free_percentnumberrequired -
Percentage of free physical memory across all selected nodes.
-
total_in_bytesnumberrequired -
Total amount, in bytes, of physical memory across all selected nodes.
-
totalnumber | string ByteSize -
Total amount of physical memory across all selected nodes.
-
used_in_bytesnumberrequired -
Amount, in bytes, of physical memory in use across all selected nodes.
-
usednumber | string ByteSize -
Amount of physical memory in use across all selected nodes.
-
used_percentnumberrequired -
Percentage of physical memory in use across all selected nodes.
-
namesClusterOperatingSystemNamerequired -
Contains statistics about operating systems used by selected nodes.
-
pretty_namesClusterOperatingSystemPrettyNamerequired -
Contains statistics about operating systems used by selected nodes.
-
countnumberrequired -
Number of selected nodes using the operating system.
-
pretty_namestring Namerequired -
Human-readable name of an operating system used by one or more selected nodes.
-
packaging_typesNodePackagingTyperequired -
Contains statistics about Elasticsearch distributions installed on selected nodes.
-
pluginsPluginStatsrequired -
Contains statistics about installed plugins and modules by selected nodes. If no plugins or modules are installed, this array is empty.
-
classnamestringrequired -
descriptionstringrequired -
elasticsearch_versionstringrequired -
extended_pluginsstringrequired -
has_native_controllerbooleanrequired -
java_versionstringrequired -
namestring Namerequired -
versionstringrequired -
licensedbooleanrequired -
processClusterProcessrequired -
Contains statistics about processes used by selected nodes.
-
cpuClusterProcessCpurequired -
Contains statistics about CPU used by selected nodes.
-
percentnumberrequired -
Percentage of CPU used across all selected nodes. Returns
-1if not supported. -
open_file_descriptorsClusterProcessOpenFileDescriptorsrequired -
Contains statistics about open file descriptors in selected nodes.
-
avgnumberrequired -
Average number of concurrently open file descriptors. Returns
-1if not supported. -
maxnumberrequired -
Maximum number of concurrently open file descriptors allowed across all selected nodes. Returns
-1if not supported. -
minnumberrequired -
Minimum number of concurrently open file descriptors across all selected nodes. Returns -1 if not supported.
-
versionsstringrequired -
Array of Elasticsearch versions used on selected nodes.
-
repositoriesmap string to string to numberrequired -
Contains stats on repository feature usage exposed in cluster stats for telemetry.
-
snapshotsClusterSnapshotStatsrequired -
Contains stats cluster snapshots.
-
current_countsSnapshotCurrentCountsrequired -
snapshotsnumberrequired -
Snapshots currently in progress
-
shard_snapshotsnumberrequired -
Incomplete shard snapshots
-
snapshot_deletionsnumberrequired -
Snapshots deletions in progress
-
concurrent_operationsnumberrequired -
Sum of snapshots and snapshot_deletions
-
cleanupsnumberrequired -
Cleanups in progress, not counted in concurrent_operations as they are not concurrent
-
repositoriesmap string to PerRepositoryStatsrequired -
<string>PerRepositoryStats -
typestringrequired -
oldest_start_time_millisnumberrequired -
oldest_start_timestring -
current_countsRepositoryStatsCurrentCountsrequired -
snapshotsnumberrequired -
clonesnumberrequired -
finalizationsnumberrequired -
deletionsnumberrequired -
snapshot_deletionsnumberrequired -
active_deletionsnumberrequired -
shardsRepositoryStatsShardsrequired -
totalnumberrequired -
completenumberrequired -
incompletenumberrequired -
statesmap string to numberrequired -
statusHealthStatus -
Health status of the cluster, based on the state of its primary and replica shards.
Supported values include:
green(orGREEN): All shards are assigned.yellow(orYELLOW): 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(orRED): One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.unknownunavailable
-
Values:
greenGREENyellowYELLOWredREDunknownunavailable -
timestampnumberrequired -
Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed.
-
ccsCCSStatsrequired -
Cross-cluster stats
-
clustersmap string to RemoteClusterInfo -
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_remotesoption is set to true. -
<string>RemoteClusterInfo -
cluster_uuidstringrequired -
The UUID of the remote cluster.
-
modestringrequired -
The connection mode used to communicate with the remote cluster.
-
The
skip_unavailablesetting used for this remote cluster. -
transport.compressstringrequired -
Transport compression setting used for this remote cluster.
-
statusHealthStatusrequired -
Health status of the cluster, based on the state of its primary and replica shards.
Supported values include:
green(orGREEN): All shards are assigned.yellow(orYELLOW): 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(orRED): One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.unknownunavailable
-
Values:
greenGREENyellowYELLOWredREDunknownunavailable -
versionstringrequired -
The list of Elasticsearch versions used by the nodes on the remote cluster.
-
nodes_countnumberrequired -
The total count of nodes in the remote cluster.
-
shards_countnumberrequired -
The total number of shards in the remote cluster.
-
indices_countnumberrequired -
The total number of indices in the remote cluster.
-
indices_total_size_in_bytesnumberrequired -
Total data set size, in bytes, of all shards assigned to selected nodes.
-
indices_total_sizestring -
Total data set size of all shards assigned to selected nodes, as a human-readable string.
-
max_heap_in_bytesnumberrequired -
Maximum amount of memory, in bytes, available for use by the heap across the nodes of the remote cluster.
-
max_heapstring -
Maximum amount of memory available for use by the heap across the nodes of the remote cluster, as a human-readable string.
-
mem_total_in_bytesnumberrequired -
Total amount, in bytes, of physical memory across the nodes of the remote cluster.
-
mem_totalstring -
Total amount of physical memory across the nodes of the remote cluster, as a human-readable string.
-
_searchCCSUsageStatsrequired -
Information about cross-cluster search usage.
-
totalnumberrequired -
The total number of cross-cluster search requests that have been executed by the cluster.
-
successnumberrequired -
The total number of cross-cluster search requests that have been successfully executed by the cluster.
-
skippednumberrequired -
The total number of cross-cluster search requests (successful or failed) that had at least one remote cluster skipped.
-
tookCCSUsageTimeValuerequired -
Statistics about the time taken to execute cross-cluster search requests.
-
maxDurationValueUnitMillisrequired -
The maximum time taken to execute a request, in milliseconds.
-
avgDurationValueUnitMillisrequired -
The average time taken to execute a request, in milliseconds.
-
p90DurationValueUnitMillisrequired -
The 90th percentile of the time taken to execute requests, in milliseconds.
-
took_mrt_trueCCSUsageTimeValue -
Statistics about the time taken to execute cross-cluster search requests for which the
ccs_minimize_roundtripssetting was set totrue. -
maxDurationValueUnitMillisrequired -
The maximum time taken to execute a request, in milliseconds.
-
avgDurationValueUnitMillisrequired -
The average time taken to execute a request, in milliseconds.
-
p90DurationValueUnitMillisrequired -
The 90th percentile of the time taken to execute requests, in milliseconds.
-
took_mrt_falseCCSUsageTimeValue -
Statistics about the time taken to execute cross-cluster search requests for which the
ccs_minimize_roundtripssetting was set tofalse. -
maxDurationValueUnitMillisrequired -
The maximum time taken to execute a request, in milliseconds.
-
avgDurationValueUnitMillisrequired -
The average time taken to execute a request, in milliseconds.
-
p90DurationValueUnitMillisrequired -
The 90th percentile of the time taken to execute requests, in milliseconds.
-
remotes_per_search_maxnumberrequired -
The maximum number of remote clusters that were queried in a single cross-cluster search request.
-
remotes_per_search_avgnumberrequired -
The average number of remote clusters that were queried in a single cross-cluster search request.
-
failure_reasonsmap string to numberrequired -
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.
-
featuresmap string to numberrequired -
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
asyncandwildcard). -
clientsmap string to numberrequired -
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
kibanaorelasticsearch) are counted. -
clustersmap string to CCSUsageClusterStatsrequired -
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). -
<string>CCSUsageClusterStats -
totalnumberrequired -
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.
-
skippednumberrequired -
The total number of cross-cluster search requests for which this cluster was skipped.
-
tookCCSUsageTimeValuerequired -
Statistics about the time taken to execute requests against this cluster.
-
maxDurationValueUnitMillisrequired -
The maximum time taken to execute a request, in milliseconds.
-
avgDurationValueUnitMillisrequired -
The average time taken to execute a request, in milliseconds.
-
p90DurationValueUnitMillisrequired -
The 90th percentile of the time taken to execute requests, in milliseconds.
-
_esqlCCSUsageStats -
Information about ES|QL cross-cluster query usage.