Get index statistics Generally available; Added in 1.3.0

GET /{index}/_stats/{metric}
Api key auth Basic auth Bearer auth

All methods and paths for this operation:

GET /_stats

GET /{index}/_stats
GET /_stats/{metric}
GET /{index}/_stats/{metric}

For data streams, the API retrieves statistics for the stream's backing indices.

By default, the returned statistics are index-level with primaries and total aggregations. primaries are the values for only the primary shards. total are the accumulated values for both primary and replica shards.

To get shard-level statistics, set the level parameter to shards.

NOTE: When moving to another node, the shard-level statistics for a shard are cleared. Although the shard is no longer part of the node, that node retains any node-level statistics to which the shard contributed.

Required authorization

  • Index privileges: monitor

Path parameters

  • index string | array[string] Required

    A comma-separated list of index names; use _all or empty string to perform the operation on all indices

  • metric string | array[string] Required

    Limit the information returned the specific metrics.

Query parameters

  • completion_fields string | array[string]

    Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.

  • expand_wildcards string | array[string]

    Type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as open,hidden.

    Supported values include:

    • all: Match any data stream or index, including hidden ones.
    • open: Match open, non-hidden indices. Also matches any non-hidden data stream.
    • closed: Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
    • hidden: Match hidden data streams and hidden indices. Must be combined with open, closed, or both.
    • none: Wildcard expressions are not accepted.

    Values are all, open, closed, hidden, or none.

  • fielddata_fields string | array[string]

    Comma-separated list or wildcard expressions of fields to include in fielddata statistics.

  • fields string | array[string]

    Comma-separated list or wildcard expressions of fields to include in the statistics.

  • forbid_closed_indices boolean

    If true, statistics are not collected from closed indices.

  • groups string | array[string]

    Comma-separated list of search groups to include in the search statistics.

  • include_segment_file_sizes boolean

    If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).

  • include_unloaded_segments boolean

    If true, the response includes information from segments that are not loaded into memory.

  • level string

    Indicates whether statistics are aggregated at the cluster, indices, or shards level.

    Values are cluster, indices, or shards.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • indices object
      Hide indices attribute Show indices attribute object
      • * object Additional properties
        Hide * attributes Show * attributes object
        • primaries object
          Hide primaries attributes Show primaries attributes object
          • completion object

            Contains statistics about completions across all shards assigned to the node.

          • docs object

            Contains statistics about documents across all primary shards assigned to the node.

          • fielddata object

            Contains statistics about the field data cache across all shards assigned to the node.

          • flush object

            Contains statistics about flush operations for the node.

          • get object

            Contains statistics about get operations for the node.

          • indexing object

            Contains statistics about indexing operations for the node.

          • indices object Additional properties

            Contains statistics about indices operations for the node.

          • merges object

            Contains statistics about merge operations for the node.

          • query_cache object

            Contains statistics about the query cache across all shards assigned to the node.

          • recovery object

            Contains statistics about recovery operations for the node.

          • refresh object

            Contains statistics about refresh operations for the node.

          • request_cache object

            Contains statistics about the request cache across all shards assigned to the node.

          • search object

            Contains statistics about search operations for the node.

          • segments object

            Contains statistics about segments across all shards assigned to the node.

          • store object

            Contains statistics about the size of shards assigned to the node.

          • translog object

            Contains statistics about transaction log operations for the node.

          • warmer object

            Contains statistics about index warming operations for the node.

          • bulk object
          • shard_stats object
        • shards object
          Hide shards attribute Show shards attribute object
          • * array[object] Additional properties
            Hide * attributes Show * attributes object
            • commit
            • completion
            • docs
            • fielddata
            • flush
            • get
            • indexing
            • mappings
            • merges
            • shard_path
            • query_cache
            • recovery
            • refresh
            • request_cache
            • retention_leases
            • routing
            • search
            • segments
            • seq_no
            • store
            • translog
            • warmer
            • bulk
            • shards object Generally available; Added in 7.15.0
            • shard_stats
            • indices
        • total object
          Hide total attributes Show total attributes object
          • completion object

            Contains statistics about completions across all shards assigned to the node.

          • docs object

            Contains statistics about documents across all primary shards assigned to the node.

          • fielddata object

            Contains statistics about the field data cache across all shards assigned to the node.

          • flush object

            Contains statistics about flush operations for the node.

          • get object

            Contains statistics about get operations for the node.

          • indexing object

            Contains statistics about indexing operations for the node.

          • indices object Additional properties

            Contains statistics about indices operations for the node.

          • merges object

            Contains statistics about merge operations for the node.

          • query_cache object

            Contains statistics about the query cache across all shards assigned to the node.

          • recovery object

            Contains statistics about recovery operations for the node.

          • refresh object

            Contains statistics about refresh operations for the node.

          • request_cache object

            Contains statistics about the request cache across all shards assigned to the node.

          • search object

            Contains statistics about search operations for the node.

          • segments object

            Contains statistics about segments across all shards assigned to the node.

          • store object

            Contains statistics about the size of shards assigned to the node.

          • translog object

            Contains statistics about transaction log operations for the node.

          • warmer object

            Contains statistics about index warming operations for the node.

          • bulk object
          • shard_stats object
        • uuid string
        • health string

          Supported values include:

          • green (or GREEN): All shards are assigned.
          • yellow (or YELLOW): All primary shards are assigned, but one or more replica shards are unassigned. If a node in the cluster fails, some data could be unavailable until that node is repaired.
          • red (or RED): One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.
          • unknown
          • unavailable

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

        • status string

          Values are open or close.

    • _shards object Required
      Hide _shards attributes Show _shards attributes object
      • failed number Required

        The number of shards the operation or search attempted to run on but failed.

      • successful number Required

        The number of shards the operation or search succeeded on.

      • total number Required

        The number of shards the operation or search will run on overall.

      • failures array[object]
        Hide failures attributes Show failures attributes object
        • index string
        • node string
        • reason object Required

          Cause and details about a request failure. This class defines the properties common to all error types. Additional details are also provided, that depend on the error type.

        • shard number
        • status string
        • primary boolean
      • skipped number
    • _all object Required Additional properties
      Hide _all attributes Show _all attributes object
      • primaries object
        Hide primaries attributes Show primaries attributes object
        • completion object

          Contains statistics about completions across all shards assigned to the node.

        • docs object

          Contains statistics about documents across all primary shards assigned to the node.

        • fielddata object

          Contains statistics about the field data cache across all shards assigned to the node.

        • flush object

          Contains statistics about flush operations for the node.

        • get object

          Contains statistics about get operations for the node.

        • indexing object

          Contains statistics about indexing operations for the node.

        • indices object Additional properties

          Contains statistics about indices operations for the node.

        • merges object

          Contains statistics about merge operations for the node.

        • query_cache object

          Contains statistics about the query cache across all shards assigned to the node.

        • recovery object

          Contains statistics about recovery operations for the node.

        • refresh object

          Contains statistics about refresh operations for the node.

        • request_cache object

          Contains statistics about the request cache across all shards assigned to the node.

        • search object

          Contains statistics about search operations for the node.

        • segments object

          Contains statistics about segments across all shards assigned to the node.

        • store object

          Contains statistics about the size of shards assigned to the node.

        • translog object

          Contains statistics about transaction log operations for the node.

        • warmer object

          Contains statistics about index warming operations for the node.

        • bulk object
        • shard_stats object
      • shards object
        Hide shards attribute Show shards attribute object
        • * array[object] Additional properties
          Hide * attributes Show * attributes object
          • commit
          • completion
          • docs
          • fielddata
          • flush
          • get
          • indexing
          • mappings
          • merges
          • shard_path
          • query_cache
          • recovery
          • refresh
          • request_cache
          • retention_leases
          • routing
          • search
          • segments
          • seq_no
          • store
          • translog
          • warmer
          • bulk
          • shards object Generally available; Added in 7.15.0
          • shard_stats
          • indices
      • total object
        Hide total attributes Show total attributes object
        • completion object

          Contains statistics about completions across all shards assigned to the node.

        • docs object

          Contains statistics about documents across all primary shards assigned to the node.

        • fielddata object

          Contains statistics about the field data cache across all shards assigned to the node.

        • flush object

          Contains statistics about flush operations for the node.

        • get object

          Contains statistics about get operations for the node.

        • indexing object

          Contains statistics about indexing operations for the node.

        • indices object Additional properties

          Contains statistics about indices operations for the node.

        • merges object

          Contains statistics about merge operations for the node.

        • query_cache object

          Contains statistics about the query cache across all shards assigned to the node.

        • recovery object

          Contains statistics about recovery operations for the node.

        • refresh object

          Contains statistics about refresh operations for the node.

        • request_cache object

          Contains statistics about the request cache across all shards assigned to the node.

        • search object

          Contains statistics about search operations for the node.

        • segments object

          Contains statistics about segments across all shards assigned to the node.

        • store object

          Contains statistics about the size of shards assigned to the node.

        • translog object

          Contains statistics about transaction log operations for the node.

        • warmer object

          Contains statistics about index warming operations for the node.

        • bulk object
        • shard_stats object
      • uuid string
      • health string

        Supported values include:

        • green (or GREEN): All shards are assigned.
        • yellow (or YELLOW): All primary shards are assigned, but one or more replica shards are unassigned. If a node in the cluster fails, some data could be unavailable until that node is repaired.
        • red (or RED): One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.
        • unknown
        • unavailable

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

      • status string

        Values are open or close.
GET /{index}/_stats/{metric} 
GET _stats/fielddata?human&fields=my_join_field#question

resp = client.indices.stats(
    metric="fielddata",
    human=True,
    fields="my_join_field",
)
const response = await client.indices.stats({
  metric: "fielddata",
  human: "true",
  fields: "my_join_field",
});
response = client.indices.stats(
  metric: "fielddata",
  human: "true",
  fields: "my_join_field"
)
$resp = $client->indices()->stats([
    "metric" => "fielddata",
    "human" => "true",
    "fields" => "my_join_field",
]);
curl -X GET -H "Authorization: ApiKey $ELASTIC_API_KEY" "$ELASTICSEARCH_URL/_stats/fielddata?human&fields=my_join_field#question"