Path parameters

• node_id string | array[string] Required

  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 application/json
  Hide response attributes Show response attributes object

  • _nodes object
    Hide _nodes attributes Show _nodes attributes object

    • failures array[object]
      Hide failures attributes Show failures attributes object

      • type string Required

        The type of error

      • reason string

        A human-readable explanation of the error, in English.

      • stack_trace string

        The server stack trace. Present only if the error_trace=true parameter was sent with the request.

      • caused_by object
      • root_cause array[object]
      • suppressed array[object]
    • total number Required

      Total number of nodes selected by the request.

    • successful number Required

      Number of nodes that responded successfully to the request.

    • failed number Required

      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 Required
  • cluster_uuid string Required
  • indices object Required
    Hide indices attributes Show indices attributes object

    • analysis object Required
      Hide analysis attributes Show analysis attributes object

      • analyzer_types array[object] Required

        Contains statistics about analyzer types used in selected nodes.

        Hide analyzer_types attributes Show analyzer_types attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • built_in_analyzers array[object] Required

        Contains statistics about built-in analyzers used in selected nodes.

        Hide built_in_analyzers attributes Show built_in_analyzers attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • built_in_char_filters array[object] Required

        Contains statistics about built-in character filters used in selected nodes.

        Hide built_in_char_filters attributes Show built_in_char_filters attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • built_in_filters array[object] Required

        Contains statistics about built-in token filters used in selected nodes.

        Hide built_in_filters attributes Show built_in_filters attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • built_in_tokenizers array[object] Required

        Contains statistics about built-in tokenizers used in selected nodes.

        Hide built_in_tokenizers attributes Show built_in_tokenizers attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • char_filter_types array[object] Required

        Contains statistics about character filter types used in selected nodes.

        Hide char_filter_types attributes Show char_filter_types attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • filter_types array[object] Required

        Contains statistics about token filter types used in selected nodes.

        Hide filter_types attributes Show filter_types attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • tokenizer_types array[object] Required

        Contains statistics about tokenizer types used in selected nodes.

        Hide tokenizer_types attributes Show tokenizer_types attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

    • completion object Required
      Hide completion attributes Show completion attributes object

      • size_in_bytes number Required

        Total amount, in bytes, of memory used for completion across all shards assigned to selected nodes.

      • size number | string

        One of:

        ByteSize number ByteSize string
      • fields object
        Hide fields attribute Show fields attribute object

        • * object Additional properties
          Hide * attributes Show * attributes object

          • size
          • size_in_bytes number Required
    • count number Required

      Total number of indices with shards assigned to selected nodes.

    • docs object Required
      Hide docs attributes Show docs attributes object

      • count number Required

        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.

      • deleted number

        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.

    • fielddata object Required
      Hide fielddata attributes Show fielddata attributes object

      • evictions number

      • memory_size number | string

        One of:

        ByteSize number ByteSize string
      • memory_size_in_bytes number Required
      • fields object
        Hide fields attribute Show fields attribute object

        • * object Additional properties
          Hide * attributes Show * attributes object

          • memory_size
          • memory_size_in_bytes number Required
    • query_cache object Required
      Hide query_cache attributes Show query_cache attributes object

      • cache_count number Required

        Total number of entries added to the query cache across all shards assigned to selected nodes. This number includes current and evicted entries.

      • cache_size number Required

        Total number of entries currently in the query cache across all shards assigned to selected nodes.

      • evictions number Required

        Total number of query cache evictions across all shards assigned to selected nodes.

      • hit_count number Required

        Total count of query cache hits across all shards assigned to selected nodes.

      • memory_size number | string

        One of:

        ByteSize number ByteSize string
      • memory_size_in_bytes number Required

        Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes.

      • miss_count number Required

        Total count of query cache misses across all shards assigned to selected nodes.

      • total_count number Required

        Total count of hits and misses in the query cache across all shards assigned to selected nodes.

    • segments object Required
      Hide segments attributes Show segments attributes object

      • count number Required

        Total number of segments across all shards assigned to selected nodes.

      • doc_values_memory number | string

        One of:

        ByteSize number ByteSize string
      • doc_values_memory_in_bytes number Required

        Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes.

      • file_sizes object Required

        This object is not populated by the cluster stats API. To get information on segment files, use the node stats API.

        Hide file_sizes attribute Show file_sizes attribute object

        • * object Additional properties
          Hide * attributes Show * attributes object

          • description string Required
          • size_in_bytes number Required
          • min_size_in_bytes number
          • max_size_in_bytes number
          • average_size_in_bytes number
          • count number

      • fixed_bit_set number | string

        One of:

        ByteSize number ByteSize string
      • fixed_bit_set_memory_in_bytes number Required

        Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes.

      • index_writer_memory number | string

        One of:

        ByteSize number ByteSize string
      • index_writer_max_memory_in_bytes number
      • index_writer_memory_in_bytes number Required

        Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes.

      • max_unsafe_auto_id_timestamp number Required

        Unix timestamp, in milliseconds, of the most recently retried indexing request.

      • memory number | string

        One of:

        ByteSize number ByteSize string
      • memory_in_bytes number Required

        Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes.

      • norms_memory number | string

        One of:

        ByteSize number ByteSize string
      • norms_memory_in_bytes number Required

        Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes.

      • points_memory number | string

        One of:

        ByteSize number ByteSize string
      • points_memory_in_bytes number Required

        Total amount, in bytes, of memory used for points across all shards assigned to selected nodes.

      • stored_memory number | string

        One of:

        ByteSize number ByteSize string
      • stored_fields_memory_in_bytes number Required

        Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes.

      • terms_memory_in_bytes number Required

        Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes.

      • terms_memory number | string

        One of:

        ByteSize number ByteSize string

      • term_vectory_memory number | string

        One of:

        ByteSize number ByteSize string
      • term_vectors_memory_in_bytes number Required

        Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes.

      • version_map_memory number | string

        One of:

        ByteSize number ByteSize string
      • version_map_memory_in_bytes number Required

        Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes.

    • shards object Required
      Hide shards attributes Show shards attributes object

      • index object
        Hide index attributes Show index attributes object

        • primaries object Required
          Hide primaries attributes Show primaries attributes object

          • avg number Required

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

          • max number Required

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

          • min number Required

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

        • replication object Required
          Hide replication attributes Show replication attributes object

          • avg number Required

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

          • max number Required

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

          • min number Required

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

        • shards object Required
          Hide shards attributes Show shards attributes object

          • avg number Required

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

          • max number Required

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

          • min number Required

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

      • primaries number

        Number of primary shards assigned to selected nodes.

      • replication number

        Ratio of replica shards to primary shards across all selected nodes.

      • total number

        Total number of shards assigned to selected nodes.

    • store object Required
      Hide store attributes Show store attributes object

      • size number | string

        One of:

        ByteSize number ByteSize string
      • size_in_bytes number Required

        Total size, in bytes, of all shards assigned to selected nodes.

      • reserved number | string

        One of:

        ByteSize number ByteSize string
      • reserved_in_bytes number Required

        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 number | string

        One of:

        ByteSize number ByteSize string
      • total_data_set_size_in_bytes number

        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.

    • mappings object Required
      Hide mappings attributes Show mappings attributes object

      • field_types array[object] Required

        Contains statistics about field data types used in selected nodes.

        Hide field_types attributes Show field_types attributes object

        • name string Required
        • count number Required

          The number of occurrences of the field type in selected nodes.

        • index_count number Required

          The number of indices containing the field type in selected nodes.

        • indexed_vector_count number

          For dense_vector field types, number of indexed vector types in selected nodes.

        • indexed_vector_dim_max number

          For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.

        • indexed_vector_dim_min number

          For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.

        • script_count number

          The number of fields that declare a script.

      • runtime_field_types array[object]

        Contains statistics about runtime field data types used in selected nodes.

        Hide runtime_field_types attributes Show runtime_field_types attributes object

        • chars_max number Required

          Maximum number of characters for a single runtime field script.

        • chars_total number Required

          Total number of characters for the scripts that define the current runtime field data type.

        • count number Required

          Number of runtime fields mapped to the field data type in selected nodes.

        • doc_max number Required

          Maximum number of accesses to doc_values for a single runtime field script

        • doc_total number Required

          Total number of accesses to doc_values for the scripts that define the current runtime field data type.

        • index_count number Required

          Number of indices containing a mapping of the runtime field data type in selected nodes.

        • lang array[string] Required

          Script languages used for the runtime fields scripts.

        • lines_max number Required

          Maximum number of lines for a single runtime field script.

        • lines_total number Required

          Total number of lines for the scripts that define the current runtime field data type.

        • name string Required
        • scriptless_count number Required

          Number of runtime fields that don’t declare a script.

        • shadowed_count number Required

          Number of runtime fields that shadow an indexed field.

        • source_max number Required

          Maximum number of accesses to _source for a single runtime field script.

        • source_total number Required

          Total number of accesses to _source for the scripts that define the current runtime field data type.

      • total_field_count number

        Total number of fields in all non-system indices.

      • total_deduplicated_field_count number

        Total number of fields in all non-system indices, accounting for mapping deduplication.

      • total_deduplicated_mapping_size number | string

        One of:

        ByteSize number ByteSize string
      • total_deduplicated_mapping_size_in_bytes number

        Total size of all mappings, in bytes, after deduplication and compression.

    • versions array[object]

      Contains statistics about analyzers and analyzer components used in selected nodes.

      Hide versions attributes Show versions attributes object

      • index_count number Required
      • primary_shard_count number Required
      • total_primary_bytes number Required
      • version string Required
  • nodes object Required
    Hide nodes attributes Show nodes attributes object

    • count object Required
      Hide count attributes Show count attributes object

      • coordinating_only number Required
      • data number Required
      • data_cold number Required
      • data_content number Required
      • data_frozen number
      • data_hot number Required
      • data_warm number Required
      • ingest number Required
      • master number Required
      • ml number Required
      • remote_cluster_client number Required
      • total number Required
      • transform number Required
      • voting_only number Required
    • discovery_types object Required

      Contains statistics about the discovery types used by selected nodes.

      Hide discovery_types attribute Show discovery_types attribute object

      • * number Additional properties
    • fs object Required
      Hide fs attributes Show fs attributes object

      • available_in_bytes number Required

        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_bytes number Required

        Total number of unallocated bytes in file stores across all selected nodes.

      • total_in_bytes number Required

        Total size, in bytes, of all file stores across all selected nodes.

    • indexing_pressure object Required
      Hide indexing_pressure attribute Show indexing_pressure attribute object

      • memory object Required
        Hide memory attributes Show memory attributes object

        • current object Required
          Hide current attributes Show current attributes object

          • all_in_bytes number Required
          • combined_coordinating_and_primary_in_bytes number Required
          • coordinating_in_bytes number Required
          • coordinating_rejections number
          • primary_in_bytes number Required
          • primary_rejections number
          • replica_in_bytes number Required
          • replica_rejections number
        • limit_in_bytes number Required
        • total object Required
          Hide total attributes Show total attributes object

          • all_in_bytes number Required
          • combined_coordinating_and_primary_in_bytes number Required
          • coordinating_in_bytes number Required
          • coordinating_rejections number
          • primary_in_bytes number Required
          • primary_rejections number
          • replica_in_bytes number Required
          • replica_rejections number
    • ingest object Required
      Hide ingest attributes Show ingest attributes object

      • number_of_pipelines number Required
      • processor_stats object Required
        Hide processor_stats attribute Show processor_stats attribute object

        • * object Additional properties
          Hide * attributes Show * attributes object

          • count number Required
          • current number Required
          • failed number Required
          • time string

            A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.

    • jvm object Required
      Hide jvm attributes Show jvm attributes object

      • Time unit for milliseconds

      • mem object Required
        Hide mem attributes Show mem attributes object

        • heap_max_in_bytes number Required

          Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.

        • heap_used_in_bytes number Required

          Memory, in bytes, currently in use by the heap across all selected nodes.

      • threads number Required

        Number of active threads in use by JVM across all selected nodes.

      • versions array[object] Required

        Contains statistics about the JVM versions used by selected nodes.

        Hide versions attributes Show versions attributes object

        • bundled_jdk boolean Required

          Always true. All distributions come with a bundled Java Development Kit (JDK).

        • count number Required

          Total number of selected nodes using JVM.

        • using_bundled_jdk boolean Required

          If true, a bundled JDK is in use by JVM.

        • version string Required
        • vm_name string Required

          Name of the JVM.

        • vm_vendor string Required

          Vendor of the JVM.

        • vm_version string Required
    • network_types object Required
      Hide network_types attributes Show network_types attributes object

      • http_types object Required

        Contains statistics about the HTTP network types used by selected nodes.

        Hide http_types attribute Show http_types attribute object

        • * number Additional properties
      • transport_types object Required

        Contains statistics about the transport network types used by selected nodes.

        Hide transport_types attribute Show transport_types attribute object

        • * number Additional properties
    • os object Required
      Hide os attributes Show os attributes object

      • allocated_processors number Required

        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.

      • architectures array[object]

        Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes.

        Hide architectures attributes Show architectures attributes object

        • arch string Required

          Name of an architecture used by one or more selected nodes.

        • count number Required

          Number of selected nodes using the architecture.

      • available_processors number Required

        Number of processors available to JVM across all selected nodes.

      • mem object Required
        Hide mem attributes Show mem attributes object

        • adjusted_total_in_bytes number

          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.

        • free_in_bytes number Required

          Amount, in bytes, of free physical memory across all selected nodes.

        • free_percent number Required

          Percentage of free physical memory across all selected nodes.

        • total_in_bytes number Required

          Total amount, in bytes, of physical memory across all selected nodes.

        • used_in_bytes number Required

          Amount, in bytes, of physical memory in use across all selected nodes.

        • used_percent number Required

          Percentage of physical memory in use across all selected nodes.

      • names array[object] Required

        Contains statistics about operating systems used by selected nodes.

        Hide names attributes Show names attributes object

        • count number Required

          Number of selected nodes using the operating system.

        • name string Required
      • pretty_names array[object] Required

        Contains statistics about operating systems used by selected nodes.

        Hide pretty_names attributes Show pretty_names attributes object

        • count number Required

          Number of selected nodes using the operating system.

        • pretty_name string Required
    • packaging_types array[object] Required

      Contains statistics about Elasticsearch distributions installed on selected nodes.

      Hide packaging_types attributes Show packaging_types attributes object

      • count number Required

        Number of selected nodes using the distribution flavor and file type.

      • flavor string Required

        Type of Elasticsearch distribution. This is always default.

      • type string Required

        File type (such as tar or zip) used for the distribution package.

    • plugins array[object] Required

      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

      • classname string Required
      • description string Required
      • elasticsearch_version string Required
      • extended_plugins array[string] Required
      • has_native_controller boolean Required
      • java_version string Required
      • name string Required
      • version string Required
      • licensed boolean Required
    • process object Required
      Hide process attributes Show process attributes object

      • cpu object Required
        Hide cpu attribute Show cpu attribute object

        • percent number Required

          Percentage of CPU used across all selected nodes. Returns -1 if not supported.

      • open_file_descriptors object Required
        Hide open_file_descriptors attributes Show open_file_descriptors attributes object

        • avg number Required

          Average number of concurrently open file descriptors. Returns -1 if not supported.

        • max number Required

          Maximum number of concurrently open file descriptors allowed across all selected nodes. Returns -1 if not supported.

        • min number Required

          Minimum number of concurrently open file descriptors across all selected nodes. Returns -1 if not supported.

    • versions array[string] Required

      Array of Elasticsearch versions used on selected nodes.

  • status string Required

    Values are green, GREEN, yellow, YELLOW, red, or RED.

  • timestamp number Required

    Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed.