- Elasticsearch Guide: other versions:
- What is Elasticsearch?
- What’s new in 8.10
- Set up Elasticsearch
- Installing Elasticsearch
- Run Elasticsearch locally
- Configuring Elasticsearch
- Important Elasticsearch configuration
- Secure settings
- Auditing settings
- Circuit breaker settings
- Cluster-level shard allocation and routing settings
- Miscellaneous cluster settings
- Cross-cluster replication settings
- Discovery and cluster formation settings
- Field data cache settings
- Health Diagnostic settings
- Index lifecycle management settings
- Index management settings
- Index recovery settings
- Indexing buffer settings
- License settings
- Local gateway settings
- Logging
- Machine learning settings
- Monitoring settings
- Node
- Networking
- Node query cache settings
- Search settings
- Security settings
- Shard request cache settings
- Snapshot and restore settings
- Transforms settings
- Thread pools
- Watcher settings
- Advanced configuration
- Important system configuration
- Bootstrap Checks
- Heap size check
- File descriptor check
- Memory lock check
- Maximum number of threads check
- Max file size check
- Maximum size virtual memory check
- Maximum map count check
- Client JVM check
- Use serial collector check
- System call filter check
- OnError and OnOutOfMemoryError checks
- Early-access check
- All permission check
- Discovery configuration check
- Bootstrap Checks for X-Pack
- Starting Elasticsearch
- Stopping Elasticsearch
- Discovery and cluster formation
- Add and remove nodes in your cluster
- Full-cluster restart and rolling restart
- Remote clusters
- Plugins
- Upgrade Elasticsearch
- Index modules
- Mapping
- Text analysis
- Overview
- Concepts
- Configure text analysis
- Built-in analyzer reference
- Tokenizer reference
- Token filter reference
- Apostrophe
- ASCII folding
- CJK bigram
- CJK width
- Classic
- Common grams
- Conditional
- Decimal digit
- Delimited payload
- Dictionary decompounder
- Edge n-gram
- Elision
- Fingerprint
- Flatten graph
- Hunspell
- Hyphenation decompounder
- Keep types
- Keep words
- Keyword marker
- Keyword repeat
- KStem
- Length
- Limit token count
- Lowercase
- MinHash
- Multiplexer
- N-gram
- Normalization
- Pattern capture
- Pattern replace
- Phonetic
- Porter stem
- Predicate script
- Remove duplicates
- Reverse
- Shingle
- Snowball
- Stemmer
- Stemmer override
- Stop
- Synonym
- Synonym graph
- Trim
- Truncate
- Unique
- Uppercase
- Word delimiter
- Word delimiter graph
- Character filters reference
- Normalizers
- Index templates
- Data streams
- Ingest pipelines
- Example: Parse logs
- Enrich your data
- Processor reference
- Append
- Attachment
- Bytes
- Circle
- Community ID
- Convert
- CSV
- Date
- Date index name
- Dissect
- Dot expander
- Drop
- Enrich
- Fail
- Fingerprint
- Foreach
- Geo-grid
- GeoIP
- Grok
- Gsub
- HTML strip
- Inference
- Join
- JSON
- KV
- Lowercase
- Network direction
- Pipeline
- Redact
- Registered domain
- Remove
- Rename
- Reroute
- Script
- Set
- Set security user
- Sort
- Split
- Trim
- Uppercase
- URL decode
- URI parts
- User agent
- Aliases
- Search your data
- Collapse search results
- Filter search results
- Highlighting
- Long-running searches
- Near real-time search
- Paginate search results
- Retrieve inner hits
- Retrieve selected fields
- Search across clusters
- Search multiple data streams and indices
- Search shard routing
- Search templates
- Search with synonyms
- Sort search results
- kNN search
- Semantic search
- Searching with query rules
- Query DSL
- Aggregations
- Bucket aggregations
- Adjacency matrix
- Auto-interval date histogram
- Categorize text
- Children
- Composite
- Date histogram
- Date range
- Diversified sampler
- Filter
- Filters
- Frequent item sets
- Geo-distance
- Geohash grid
- Geohex grid
- Geotile grid
- Global
- Histogram
- IP prefix
- IP range
- Missing
- Multi Terms
- Nested
- Parent
- Random sampler
- Range
- Rare terms
- Reverse nested
- Sampler
- Significant terms
- Significant text
- Terms
- Time series
- Variable width histogram
- Subtleties of bucketing range fields
- Metrics aggregations
- Pipeline aggregations
- Average bucket
- Bucket script
- Bucket count K-S test
- Bucket correlation
- Bucket selector
- Bucket sort
- Change point
- Cumulative cardinality
- Cumulative sum
- Derivative
- Extended stats bucket
- Inference bucket
- Max bucket
- Min bucket
- Moving function
- Moving percentiles
- Normalize
- Percentiles bucket
- Serial differencing
- Stats bucket
- Sum bucket
- Bucket aggregations
- Geospatial analysis
- EQL
- SQL
- Overview
- Getting Started with SQL
- Conventions and Terminology
- Security
- SQL REST API
- SQL Translate API
- SQL CLI
- SQL JDBC
- SQL ODBC
- SQL Client Applications
- SQL Language
- Functions and Operators
- Comparison Operators
- Logical Operators
- Math Operators
- Cast Operators
- LIKE and RLIKE Operators
- Aggregate Functions
- Grouping Functions
- Date/Time and Interval Functions and Operators
- Full-Text Search Functions
- Mathematical Functions
- String Functions
- Type Conversion Functions
- Geo Functions
- Conditional Functions And Expressions
- System Functions
- Reserved keywords
- SQL Limitations
- Scripting
- Data management
- ILM: Manage the index lifecycle
- Tutorial: Customize built-in policies
- Tutorial: Automate rollover
- Index management in Kibana
- Overview
- Concepts
- Index lifecycle actions
- Configure a lifecycle policy
- Migrate index allocation filters to node roles
- Troubleshooting index lifecycle management errors
- Start and stop index lifecycle management
- Manage existing indices
- Skip rollover
- Restore a managed data stream or index
- Data tiers
- Autoscaling
- Monitor a cluster
- Roll up or transform your data
- Set up a cluster for high availability
- Snapshot and restore
- Secure the Elastic Stack
- Elasticsearch security principles
- Start the Elastic Stack with security enabled automatically
- Manually configure security
- Updating node security certificates
- User authentication
- Built-in users
- Service accounts
- Internal users
- Token-based authentication services
- User profiles
- Realms
- Realm chains
- Security domains
- Active Directory user authentication
- File-based user authentication
- LDAP user authentication
- Native user authentication
- OpenID Connect authentication
- PKI user authentication
- SAML authentication
- Kerberos authentication
- JWT authentication
- Integrating with other authentication systems
- Enabling anonymous access
- Looking up users without authentication
- Controlling the user cache
- Configuring SAML single-sign-on on the Elastic Stack
- Configuring single sign-on to the Elastic Stack using OpenID Connect
- User authorization
- Built-in roles
- Defining roles
- Role restriction
- Security privileges
- Document level security
- Field level security
- Granting privileges for data streams and aliases
- Mapping users and groups to roles
- Setting up field and document level security
- Submitting requests on behalf of other users
- Configuring authorization delegation
- Customizing roles and authorization
- Enable audit logging
- Restricting connections with IP filtering
- Securing clients and integrations
- Operator privileges
- Troubleshooting
- Some settings are not returned via the nodes settings API
- Authorization exceptions
- Users command fails due to extra arguments
- Users are frequently locked out of Active Directory
- Certificate verification fails for curl on Mac
- SSLHandshakeException causes connections to fail
- Common SSL/TLS exceptions
- Common Kerberos exceptions
- Common SAML issues
- Internal Server Error in Kibana
- Setup-passwords command fails due to connection failure
- Failures due to relocation of the configuration files
- Limitations
- Watcher
- Command line tools
- elasticsearch-certgen
- elasticsearch-certutil
- elasticsearch-create-enrollment-token
- elasticsearch-croneval
- elasticsearch-keystore
- elasticsearch-node
- elasticsearch-reconfigure-node
- elasticsearch-reset-password
- elasticsearch-saml-metadata
- elasticsearch-service-tokens
- elasticsearch-setup-passwords
- elasticsearch-shard
- elasticsearch-syskeygen
- elasticsearch-users
- How to
- Troubleshooting
- Fix common cluster issues
- Diagnose unassigned shards
- Add a missing tier to the system
- Allow Elasticsearch to allocate the data in the system
- Allow Elasticsearch to allocate the index
- Indices mix index allocation filters with data tiers node roles to move through data tiers
- Not enough nodes to allocate all shard replicas
- Total number of shards for an index on a single node exceeded
- Total number of shards per node has been reached
- Troubleshooting corruption
- Fix data nodes out of disk
- Fix master nodes out of disk
- Fix other role nodes out of disk
- Start index lifecycle management
- Start Snapshot Lifecycle Management
- Restore from snapshot
- Multiple deployments writing to the same snapshot repository
- Addressing repeated snapshot policy failures
- Troubleshooting an unstable cluster
- Troubleshooting discovery
- Troubleshooting monitoring
- Troubleshooting transforms
- Troubleshooting Watcher
- Troubleshooting searches
- Troubleshooting shards capacity health issues
- REST APIs
- API conventions
- Common options
- REST API compatibility
- Autoscaling APIs
- Behavioral Analytics APIs
- Compact and aligned text (CAT) APIs
- cat aliases
- cat allocation
- cat anomaly detectors
- cat component templates
- cat count
- cat data frame analytics
- cat datafeeds
- cat fielddata
- cat health
- cat indices
- cat master
- cat nodeattrs
- cat nodes
- cat pending tasks
- cat plugins
- cat recovery
- cat repositories
- cat segments
- cat shards
- cat snapshots
- cat task management
- cat templates
- cat thread pool
- cat trained model
- cat transforms
- Cluster APIs
- Cluster allocation explain
- Cluster get settings
- Cluster health
- Health
- Cluster reroute
- Cluster state
- Cluster stats
- Cluster update settings
- Nodes feature usage
- Nodes hot threads
- Nodes info
- Prevalidate node removal
- Nodes reload secure settings
- Nodes stats
- Cluster Info
- Pending cluster tasks
- Remote cluster info
- Task management
- Voting configuration exclusions
- Create or update desired nodes
- Get desired nodes
- Delete desired nodes
- Get desired balance
- Reset desired balance
- Cross-cluster replication APIs
- Data stream APIs
- Document APIs
- Enrich APIs
- EQL APIs
- Features APIs
- Fleet APIs
- Find structure API
- Graph explore API
- Index APIs
- Alias exists
- Aliases
- Analyze
- Analyze index disk usage
- Clear cache
- Clone index
- Close index
- Create index
- Create or update alias
- Create or update component template
- Create or update index template
- Create or update index template (legacy)
- Delete component template
- Delete dangling index
- Delete alias
- Delete index
- Delete index template
- Delete index template (legacy)
- Exists
- Field usage stats
- Flush
- Force merge
- Get alias
- Get component template
- Get field mapping
- Get index
- Get index settings
- Get index template
- Get index template (legacy)
- Get mapping
- Import dangling index
- Index recovery
- Index segments
- Index shard stores
- Index stats
- Index template exists (legacy)
- List dangling indices
- Open index
- Refresh
- Resolve index
- Rollover
- Shrink index
- Simulate index
- Simulate template
- Split index
- Unfreeze index
- Update index settings
- Update mapping
- Index lifecycle management APIs
- Create or update lifecycle policy
- Get policy
- Delete policy
- Move to step
- Remove policy
- Retry policy
- Get index lifecycle management status
- Explain lifecycle
- Start index lifecycle management
- Stop index lifecycle management
- Migrate indices, ILM policies, and legacy, composable and component templates to data tiers routing
- Ingest APIs
- Info API
- Licensing APIs
- Logstash APIs
- Machine learning APIs
- Machine learning anomaly detection APIs
- Add events to calendar
- Add jobs to calendar
- Close jobs
- Create jobs
- Create calendars
- Create datafeeds
- Create filters
- Delete calendars
- Delete datafeeds
- Delete events from calendar
- Delete filters
- Delete forecasts
- Delete jobs
- Delete jobs from calendar
- Delete model snapshots
- Delete expired data
- Estimate model memory
- Flush jobs
- Forecast jobs
- Get buckets
- Get calendars
- Get categories
- Get datafeeds
- Get datafeed statistics
- Get influencers
- Get jobs
- Get job statistics
- Get model snapshots
- Get model snapshot upgrade statistics
- Get overall buckets
- Get scheduled events
- Get filters
- Get records
- Open jobs
- Post data to jobs
- Preview datafeeds
- Reset jobs
- Revert model snapshots
- Start datafeeds
- Stop datafeeds
- Update datafeeds
- Update filters
- Update jobs
- Update model snapshots
- Upgrade model snapshots
- Machine learning data frame analytics APIs
- Create data frame analytics jobs
- Delete data frame analytics jobs
- Evaluate data frame analytics
- Explain data frame analytics
- Get data frame analytics jobs
- Get data frame analytics jobs stats
- Preview data frame analytics
- Start data frame analytics jobs
- Stop data frame analytics jobs
- Update data frame analytics jobs
- Machine learning trained model APIs
- Clear trained model deployment cache
- Create or update trained model aliases
- Create part of a trained model
- Create trained models
- Create trained model vocabulary
- Delete trained model aliases
- Delete trained models
- Get trained models
- Get trained models stats
- Infer trained model
- Start trained model deployment
- Stop trained model deployment
- Update trained model deployment
- Migration APIs
- Node lifecycle APIs
- Query rules APIs
- Reload search analyzers API
- Repositories metering APIs
- Rollup APIs
- Script APIs
- Search APIs
- Search Application APIs
- Searchable snapshots APIs
- Security APIs
- Authenticate
- Change passwords
- Clear cache
- Clear roles cache
- Clear privileges cache
- Clear API key cache
- Clear service account token caches
- Create API keys
- Create or update application privileges
- Create or update role mappings
- Create or update roles
- Create or update users
- Create service account tokens
- Delegate PKI authentication
- Delete application privileges
- Delete role mappings
- Delete roles
- Delete service account token
- Delete users
- Disable users
- Enable users
- Enroll Kibana
- Enroll node
- Get API key information
- Get application privileges
- Get builtin privileges
- Get role mappings
- Get roles
- Get service accounts
- Get service account credentials
- Get token
- Get user privileges
- Get users
- Grant API keys
- Has privileges
- Invalidate API key
- Invalidate token
- OpenID Connect prepare authentication
- OpenID Connect authenticate
- OpenID Connect logout
- Query API key information
- Update API key
- Bulk update API keys
- SAML prepare authentication
- SAML authenticate
- SAML logout
- SAML invalidate
- SAML complete logout
- SAML service provider metadata
- SSL certificate
- Activate user profile
- Disable user profile
- Enable user profile
- Get user profiles
- Suggest user profile
- Update user profile data
- Has privileges user profile
- Create Cross-Cluster API key
- Update Cross-Cluster API key
- Snapshot and restore APIs
- Snapshot lifecycle management APIs
- SQL APIs
- Synonyms APIs
- Transform APIs
- Usage API
- Watcher APIs
- Definitions
- Migration guide
- Release notes
- Elasticsearch version 8.10.4
- Elasticsearch version 8.10.3
- Elasticsearch version 8.10.2
- Elasticsearch version 8.10.1
- Elasticsearch version 8.10.0
- Elasticsearch version 8.9.2
- Elasticsearch version 8.9.1
- Elasticsearch version 8.9.0
- Elasticsearch version 8.8.2
- Elasticsearch version 8.8.1
- Elasticsearch version 8.8.0
- Elasticsearch version 8.7.1
- Elasticsearch version 8.7.0
- Elasticsearch version 8.6.2
- Elasticsearch version 8.6.1
- Elasticsearch version 8.6.0
- Elasticsearch version 8.5.3
- Elasticsearch version 8.5.2
- Elasticsearch version 8.5.1
- Elasticsearch version 8.5.0
- Elasticsearch version 8.4.3
- Elasticsearch version 8.4.2
- Elasticsearch version 8.4.1
- Elasticsearch version 8.4.0
- Elasticsearch version 8.3.3
- Elasticsearch version 8.3.2
- Elasticsearch version 8.3.1
- Elasticsearch version 8.3.0
- Elasticsearch version 8.2.3
- Elasticsearch version 8.2.2
- Elasticsearch version 8.2.1
- Elasticsearch version 8.2.0
- Elasticsearch version 8.1.3
- Elasticsearch version 8.1.2
- Elasticsearch version 8.1.1
- Elasticsearch version 8.1.0
- Elasticsearch version 8.0.1
- Elasticsearch version 8.0.0
- Elasticsearch version 8.0.0-rc2
- Elasticsearch version 8.0.0-rc1
- Elasticsearch version 8.0.0-beta1
- Elasticsearch version 8.0.0-alpha2
- Elasticsearch version 8.0.0-alpha1
- Dependencies and versions
Cluster stats API
editCluster stats API
editReturns cluster statistics.
Prerequisites
edit-
If the Elasticsearch security features are enabled, you must have the
monitor
ormanage
cluster privilege to use this API.
Description
editThe Cluster Stats API allows to retrieve statistics from a cluster wide perspective. The API returns 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
edit-
<node_filter>
- (Optional, string) Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster.
Query parameters
edit-
timeout
-
(Optional, time units)
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.
Response body
edit-
_nodes
-
(object) Contains statistics about the number of nodes selected by the request’s node filters.
Properties of
_nodes
-
total
- (integer) Total number of nodes selected by the request.
-
successful
- (integer) Number of nodes that responded successfully to the request.
-
failed
-
(integer)
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) Name of the cluster, based on the Cluster name setting setting.
-
cluster_uuid
- (string) Unique identifier for the cluster.
-
timestamp
- (integer) Unix timestamp, in milliseconds, of the last time the cluster statistics were refreshed.
-
status
-
(string) Health status of the cluster, based on the state of its primary and replica shards. Statuses are:
-
green
: All shards are assigned. -
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
: One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.
See Cluster health.
-
-
indices
-
(object) Contains statistics about indices with shards assigned to selected nodes.
Properties of
indices
-
count
- (integer) Total number of indices with shards assigned to selected nodes.
-
shards
-
(object) Contains statistics about shards assigned to selected nodes.
Properties of
shards
-
total
- (integer) Total number of shards assigned to selected nodes.
-
primaries
- (integer) Number of primary shards assigned to selected nodes.
-
replication
- (float) Ratio of replica shards to primary shards across all selected nodes.
-
index
-
(object) Contains statistics about shards assigned to selected nodes.
Properties of
index
-
shards
-
(object) Contains statistics about the number of shards assigned to selected nodes.
Properties of
shards
-
min
- (integer) Minimum number of shards in an index, counting only shards assigned to selected nodes.
-
max
- (integer) Maximum number of shards in an index, counting only shards assigned to selected nodes.
-
avg
- (float) Mean number of shards in an index, counting only shards assigned to selected nodes.
-
-
primaries
-
(object) Contains statistics about the number of primary shards assigned to selected nodes.
Properties of
primaries
-
min
- (integer) Minimum number of primary shards in an index, counting only shards assigned to selected nodes.
-
max
- (integer) Maximum number of primary shards in an index, counting only shards assigned to selected nodes.
-
avg
- (float) Mean number of primary shards in an index, counting only shards assigned to selected nodes.
-
-
replication
-
(object) Contains statistics about the number of replication shards assigned to selected nodes.
Properties of
replication
-
min
- (float) Minimum replication factor in an index, counting only shards assigned to selected nodes.
-
max
- (float) Maximum replication factor in an index, counting only shards assigned to selected nodes.
-
avg
- (float) Mean replication factor in an index, counting only shards assigned to selected nodes.
-
-
-
-
docs
-
(object) Contains counts for documents in selected nodes.
Properties of
docs
-
count
-
(integer) 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
-
(integer) 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.
-
-
store
-
(object) Contains statistics about the size of shards assigned to selected nodes.
Properties of
store
-
size
- (byte units) Total size of all shards assigned to selected nodes.
-
size_in_bytes
- (integer) Total size, in bytes, of all shards assigned to selected nodes.
-
total_data_set_size
- (byte units) 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_bytes
- (integer) 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.
-
reserved
- (byte value) A prediction of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
-
reserved_in_bytes
- (integer) A prediction, in bytes, of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities.
-
-
fielddata
-
(object) Contains statistics about the field data cache of selected nodes.
Properties of
fielddata
-
memory_size
- (byte units) Total amount of memory used for the field data cache across all shards assigned to selected nodes.
-
memory_size_in_bytes
- (integer) Total amount, in bytes, of memory used for the field data cache across all shards assigned to selected nodes.
-
evictions
- (integer) Total number of evictions from the field data cache across all shards assigned to selected nodes.
-
global_ordinals.build_time
- (time unit) The total time spent building global ordinals for all fields.
-
global_ordinals.build_time_in_millis
- (integer) The total time, in milliseconds, spent building global ordinals for all fields.
-
global_ordinals.fields.[field-name].build_time
- (time unit) The total time spent building global ordinals for field with specified name.
-
global_ordinals.fields.[field-name].build_time_in_millis
- (integer) The total time, in milliseconds, spent building global ordinals for field with specified name.
-
global_ordinals.fields.[field-name].shard_max_value_count
- (long) The total time spent building global ordinals for field with specified name.
-
-
query_cache
-
(object) Contains statistics about the query cache of selected nodes.
Properties of
query_cache
-
memory_size
- (byte units) Total amount of memory used for the query cache across all shards assigned to selected nodes.
-
memory_size_in_bytes
- (integer) Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes.
-
total_count
- (integer) Total count of hits and misses in the query cache across all shards assigned to selected nodes.
-
hit_count
- (integer) Total count of query cache hits across all shards assigned to selected nodes.
-
miss_count
- (integer) Total count of query cache misses across all shards assigned to selected nodes.
-
cache_size
- (integer) Total number of entries currently in the query cache across all shards assigned to selected nodes.
-
cache_count
- (integer) Total number of entries added to the query cache across all shards assigned to selected nodes. This number includes current and evicted entries.
-
evictions
- (integer) Total number of query cache evictions across all shards assigned to selected nodes.
-
-
completion
-
(object) Contains statistics about memory used for completion in selected nodes.
Properties of
completion
-
size
- (byte units) Total amount of memory used for completion across all shards assigned to selected nodes.
-
size_in_bytes
- (integer) Total amount, in bytes, of memory used for completion across all shards assigned to selected nodes.
-
-
segments
-
(object) Contains statistics about segments in selected nodes.
Properties of
segments
-
count
- (integer) Total number of segments across all shards assigned to selected nodes.
-
memory
- (byte units) Total amount of memory used for segments across all shards assigned to selected nodes.
-
memory_in_bytes
- (integer) Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes.
-
terms_memory
- (byte units) Total amount of memory used for terms across all shards assigned to selected nodes.
-
terms_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes.
-
stored_fields_memory
- (byte units) Total amount of memory used for stored fields across all shards assigned to selected nodes.
-
stored_fields_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes.
-
term_vectors_memory
- (byte units) Total amount of memory used for term vectors across all shards assigned to selected nodes.
-
term_vectors_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes.
-
norms_memory
- (byte units) Total amount of memory used for normalization factors across all shards assigned to selected nodes.
-
norms_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes.
-
points_memory
- (byte units) Total amount of memory used for points across all shards assigned to selected nodes.
-
points_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for points across all shards assigned to selected nodes.
-
doc_values_memory
- (byte units) Total amount of memory used for doc values across all shards assigned to selected nodes.
-
doc_values_memory_in_bytes
- (integer) Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes.
-
index_writer_memory
- (byte units) Total amount of memory used by all index writers across all shards assigned to selected nodes.
-
index_writer_memory_in_bytes
- (integer) Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes.
-
version_map_memory
- (byte units) Total amount of memory used by all version maps across all shards assigned to selected nodes.
-
version_map_memory_in_bytes
- (integer) Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes.
-
fixed_bit_set
-
(byte units) 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_bytes
- (integer) Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes.
-
max_unsafe_auto_id_timestamp
- (integer) Unix timestamp, in milliseconds, of the most recently retried indexing request.
-
file_sizes
-
(object) This object is not populated by the cluster stats API.
To get information on segment files, use the node stats API.
-
-
mappings
-
(object) Contains statistics about field mappings in selected nodes.
Properties of
mappings
-
total_field_count
- (integer) Total number of fields in all non-system indices.
-
total_deduplicated_field_count
- (integer) Total number of fields in all non-system indices, accounting for mapping deduplication.
-
total_deduplicated_mapping_size
- (byte units) Total size of all mappings after deduplication and compression.
-
total_deduplicated_mapping_size_in_bytes
- (integer) Total size of all mappings, in bytes, after deduplication and compression.
-
field_types
-
(array of objects) Contains statistics about field data types used in selected nodes.
Properties of
field_types
objects-
name
- (string) Field data type used in selected nodes.
-
count
- (integer) Number of fields mapped to the field data type in selected nodes.
-
index_count
- (integer) Number of indices containing a mapping of the field data type in selected nodes.
-
indexed_vector_count
- (integer) For dense_vector field types, number of indexed vector types in selected nodes.
-
indexed_vector_dim_min
- (integer) For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes.
-
indexed_vector_dim_max
- (integer) For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes.
-
script_count
- (integer) Number of fields that declare a script.
-
lang
- (array of strings) Script languages used for the optional scripts
-
lines_max
- (integer) Maximum number of lines for a single field script
-
lines_total
- (integer) Total number of lines for the scripts
-
chars_max
- (integer) Maximum number of characters for a single field script
-
chars_total
- (integer) Total number of characters for the scripts
-
source_max
- (integer) Maximum number of accesses to _source for a single field script
-
source_total
- (integer) Total number of accesses to _source for the scripts
-
doc_max
- (integer) Maximum number of accesses to doc_values for a single field script
-
doc_total
- (integer) Total number of accesses to doc_values for the scripts
-
-
runtime_field_types
-
(array of objects) Contains statistics about runtime field data types used in selected nodes.
Properties of
runtime_field_types
objects-
name
- (string) Field data type used in selected nodes.
-
count
- (integer) Number of runtime fields mapped to the field data type in selected nodes.
-
index_count
- (integer) Number of indices containing a mapping of the runtime field data type in selected nodes.
-
scriptless_count
- (integer) Number of runtime fields that don’t declare a script.
-
shadowed_count
- (integer) Number of runtime fields that shadow an indexed field.
-
lang
- (array of strings) Script languages used for the runtime fields scripts
-
lines_max
- (integer) Maximum number of lines for a single runtime field script
-
lines_total
- (integer) Total number of lines for the scripts that define the current runtime field data type
-
chars_max
- (integer) Maximum number of characters for a single runtime field script
-
chars_total
- (integer) Total number of characters for the scripts that define the current runtime field data type
-
source_max
- (integer) Maximum number of accesses to _source for a single runtime field script
-
source_total
- (integer) Total number of accesses to _source for the scripts that define the current runtime field data type
-
doc_max
- (integer) Maximum number of accesses to doc_values for a single runtime field script
-
doc_total
- (integer) Total number of accesses to doc_values for the scripts that define the current runtime field data type
-
-
-
analysis
-
(object) Contains statistics about analyzers and analyzer components used in selected nodes.
Properties of
analysis
-
char_filter_types
-
(array of objects) Contains statistics about character filter types used in selected nodes.
Properties of
char_filter_types
objects-
name
- (string) Character filter type used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the character filter type in selected nodes.
-
index_count
- (integer) Number of indices the character filter type in selected nodes.
-
-
tokenizer_types
-
(array of objects) Contains statistics about tokenizer types used in selected nodes.
Properties of
tokenizer_types
objects-
name
- (string) Tokenizer type used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the tokenizer type in selected nodes.
-
index_count
- (integer) Number of indices using the tokenizer type in selected nodes.
-
-
filter_types
-
(array of objects) Contains statistics about token filter types used in selected nodes.
Properties of
filter_types
objects-
name
- (string) Token filter type used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the token filter type in selected nodes.
-
index_count
- (integer) Number of indices using the token filter type in selected nodes.
-
-
analyzer_types
-
(array of objects) Contains statistics about analyzer types used in selected nodes.
Properties of
analyzer_types
objects-
name
- (string) Analyzer type used in selected nodes.
-
count
- (integer) Occurrences of the analyzer type in selected nodes.
-
index_count
- (integer) Number of indices using the analyzer type in selected nodes.
-
-
built_in_char_filters
-
(array of objects) Contains statistics about built-in character filters used in selected nodes.
Properties of
built_in_char_filters
objects-
name
- (string) Built-in character filter used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the built-in character filter in selected nodes.
-
index_count
- (integer) Number of indices using the built-in character filter in selected nodes.
-
-
built_in_tokenizers
-
(array of objects) Contains statistics about built-in tokenizers used in selected nodes.
Properties of
built_in_tokenizers
objects-
name
- (string) Built-in tokenizer used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the built-in tokenizer in selected nodes.
-
index_count
- (integer) Number of indices using the built-in tokenizer in selected nodes.
-
-
built_in_filters
-
(array of objects) Contains statistics about built-in token filters used in selected nodes.
Properties of
built_in_filters
objects-
name
- (string) Built-in token filter used in selected nodes.
-
count
- (integer) Number of analyzers or normalizers using the built-in token filter in selected nodes.
-
index_count
- (integer) Number of indices using the built-in token filter in selected nodes.
-
-
built_in_analyzers
-
(array of objects) Contains statistics about built-in analyzers used in selected nodes.
Properties of
built_in_analyzers
objects-
name
- (string) Built-in analyzer used in selected nodes.
-
count
- (integer) Occurrences of the built-in analyzer in selected nodes.
-
index_count
- (integer) Number of indices using the built-in analyzer in selected nodes.
-
-
synonyms
-
(object) Contains statistics about synonyms defined in synonym and synonym graph token filters configuration.
Properties of
synonyms
objects-
inline
-
(object) Inline synonyms defined using
synonyms
configuration in synonym or synonym graph token filters.Properties of
inline
objects-
count
- (integer) Occurrences of inline synonyms configuration in selected nodes. Each inline synonyms configuration will be counted separately, regardless of the synonyms defined. Two synonyms configurations with the same synonyms will count as separate ocurrences.
-
index_count
- (integer) Number of indices that use inline synonyms configuration for synonyms token filters.
-
-
paths
-
(object) Contains statistics about synonym files defined as
synonyms_path
in synonym and synonym graph token filters configuration.Properties of
paths
objects-
count
- (integer) Occurrences of unique synonym paths in selected nodes.
-
index_count
-
(integer)
Number of indices that use
synonyms_path
configuration for synonyms token filters.
-
-
sets
-
(object) Contains statistics about synonyms sets configured as
synonyms_set
in synonym and synonym graph token filters configuration.Properties of
sets
objects-
count
- (integer) Occurrences of unique synonyms sets in selected nodes.
-
index_count
-
(integer)
Number of indices that use
synonyms_set
configuration for synonyms token filters.
-
-
-
-
search
-
(object) Contains usage statistics about search requests submitted to selected nodes that acted as coordinator during the search execution. Search requests are tracked when they are successfully parsed, regardless of their results: requests that yield errors after parsing contribute to the usage stats, as well as requests that don’t access any data.
Properties of
search
objects-
total
- (integer) Total number of incoming search requests. Search requests that don’t specify a request body are not counted.
-
queries
-
(object)
Query types used in selected nodes. For each query, name and number of times
it’s been used within the
query
orpost_filter
section is reported. Queries are counted once per search request, meaning that if the same query type is used multiple times in the same search request, its counter will be incremented by 1 rather than by the number of times it’s been used in that individual search request. -
sections
- (object) Search sections used in selected nodes. For each section, name and number of times it’s been used is reported.
-
-
dense_vector
-
(object) Contains statistics about indexed dense vector used in selected nodes.
Properties of
dense_vector
-
value_count
- (integer) Total number of dense vector indexed in selected nodes.
-
-
-
nodes
-
(object) Contains statistics about nodes selected by the request’s node filters.
Properties of
nodes
-
count
-
(object) Contains counts for nodes selected by the request’s node filters.
Properties of
count
-
total
- (integer) Total number of selected nodes.
-
coordinating_only
- (integer) Number of selected nodes without a role. These nodes are considered coordinating only nodes.
-
<role>
- (integer) Number of selected nodes with the role. For a list of roles, see Node.
-
-
versions
- (array of strings) Array of Elasticsearch versions used on selected nodes.
-
os
-
(object) Contains statistics about the operating systems used by selected nodes.
Properties of
os
-
available_processors
- (integer) Number of processors available to JVM across all selected nodes.
-
allocated_processors
-
(integer) 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 OS. In both cases, this number will never be larger than32
. -
names
-
(array of objects) Contains statistics about operating systems used by selected nodes.
Properties of
names
-
name
- (string) Name of an operating system used by one or more selected nodes.
-
count
- (string) Number of selected nodes using the operating system.
-
-
pretty_names
-
(array of objects) Contains statistics about operating systems used by selected nodes.
Properties of
pretty_names
-
pretty_name
- (string) Human-readable name of an operating system used by one or more selected nodes.
-
count
- (string) Number of selected nodes using the operating system.
-
-
architectures
-
(array of objects) Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes.
Properties of
architectures
-
arch
- (string) Name of an architecture used by one or more selected nodes.
-
count
- (string) Number of selected nodes using the architecture.
-
-
mem
-
(object) Contains statistics about memory used by selected nodes.
Properties of
mem
-
total
- (byte units) Total amount of physical memory across all selected nodes.
-
total_in_bytes
- (integer) Total amount, in bytes, of physical memory across all selected nodes.
-
adjusted_total
-
(byte value)
Total amount 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. -
adjusted_total_in_bytes
-
(integer)
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
- (byte units) Amount of free physical memory across all selected nodes.
-
free_in_bytes
- (integer) Amount, in bytes, of free physical memory across all selected nodes.
-
used
- (byte units) Amount of physical memory in use across all selected nodes.
-
used_in_bytes
- (integer) Amount, in bytes, of physical memory in use across all selected nodes.
-
free_percent
- (integer) Percentage of free physical memory across all selected nodes.
-
used_percent
- (integer) Percentage of physical memory in use across all selected nodes.
-
-
-
process
-
(object) Contains statistics about processes used by selected nodes.
Properties of
process
-
cpu
-
(object) Contains statistics about CPU used by selected nodes.
Properties of
cpu
-
percent
-
(integer)
Percentage of CPU used across all selected nodes. Returns
-1
if not supported.
-
-
open_file_descriptors
-
(object) Contains statistics about open file descriptors in selected nodes.
Properties of
open_file_descriptors
-
min
-
(integer)
Minimum number of concurrently open file descriptors across all selected nodes.
Returns
-1
if not supported. -
max
-
(integer)
Maximum number of concurrently open file descriptors allowed across all selected
nodes. Returns
-1
if not supported. -
avg
-
(integer)
Average number of concurrently open file descriptors. Returns
-1
if not supported.
-
-
-
jvm
-
(object) Contains statistics about the Java Virtual Machines (JVMs) used by selected nodes.
Properties of
jvm
-
max_uptime
- (time unit) Uptime duration since JVM last started.
-
max_uptime_in_millis
- (integer) Uptime duration, in milliseconds, since JVM last started.
-
versions
-
(array of objects) Contains statistics about the JVM versions used by selected nodes.
Properties of
versions
-
version
- (string) Version of JVM used by one or more selected nodes.
-
vm_name
- (string) Name of the JVM.
-
vm_version
-
(string) Full version number of JVM.
The full version number includes a plus sign (
+
) followed by the build number. -
vm_vendor
- (string) Vendor of the JVM.
-
bundled_jdk
-
(Boolean)
Always
true
. All distributions come with a bundled Java Development Kit (JDK). -
using_bundled_jdk
-
(Boolean)
If
true
, a bundled JDK is in use by JVM. -
count
- (integer) Total number of selected nodes using JVM.
-
-
mem
-
(object) Contains statistics about memory used by selected nodes.
Properties of
mem
-
heap_used
- (byte units) Memory currently in use by the heap across all selected nodes.
-
heap_used_in_bytes
- (integer) Memory, in bytes, currently in use by the heap across all selected nodes.
-
heap_max
- (byte units) Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.
-
heap_max_in_bytes
- (integer) Maximum amount of memory, in bytes, available for use by the heap across all selected nodes.
-
-
threads
- (integer) Number of active threads in use by JVM across all selected nodes.
-
-
fs
-
(object) Contains statistics about file stores by selected nodes.
Properties of
fs
-
total
- (byte units) Total size of all file stores across all selected nodes.
-
total_in_bytes
- (integer) Total size, in bytes, of all file stores across all selected nodes.
-
free
- (byte units) Amount of unallocated disk space in file stores across all selected nodes.
-
free_in_bytes
- (integer) Total number of unallocated bytes in file stores across all selected nodes.
-
available
-
(byte units) Total amount of disk space available to JVM in file stores across all selected nodes.
Depending on OS or process-level restrictions, this amount may be less than
nodes.fs.free
. This is the actual amount of free disk space the selected Elasticsearch nodes can use. -
available_in_bytes
-
(integer) Total number of bytes available to JVM in file stores across all selected nodes.
Depending on OS 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.
-
-
plugins
-
(array of objects) Contains statistics about installed plugins and modules by selected nodes.
If no plugins or modules are installed, this array is empty.
Properties of
plugins
-
<plugin>
-
(object) Contains statistics about an installed plugin or module.
Properties of
<plugin>
-
name
- (string) Name of the Elasticsearch plugin.
-
version
- (string) Elasticsearch version for which the plugin was built.
-
elasticsearch_version
- (string) Elasticsearch version for which the plugin was built.
-
java_version
- (string) Java version for which the plugin was built.
-
description
- (string) Short description of the plugin.
-
classname
- (string) Class name used as the plugin’s entry point.
-
extended_plugins
-
(array of strings) An array of other plugins extended by this plugin through the Java Service Provider Interface (SPI).
If this plugin extends no other plugins, this array is empty.
-
has_native_controller
-
(Boolean)
If
true
, the plugin has a native controller process.
-
-
-
network_types
-
(object) Contains statistics about the transport and HTTP networks used by selected nodes.
Properties of
network_types
-
transport_types
-
(object) Contains statistics about the transport network types used by selected nodes.
Properties of
transport_types
-
<transport_type>
- (integer) Number of selected nodes using the transport type.
-
-
http_types
-
(object) Contains statistics about the HTTP network types used by selected nodes.
Properties of
http_types
-
<http_type>
- (integer) Number of selected nodes using the HTTP type.
-
-
-
discovery_types
-
(object) Contains statistics about the discovery types used by selected nodes.
Properties of
discovery_types
-
<discovery_type>
- (integer) Number of selected nodes using the discovery type to find other nodes.
-
-
packaging_types
-
(array of objects) Contains statistics about Elasticsearch distributions installed on selected nodes.
Properties of
packaging_types
-
flavor
-
(string)
Type of Elasticsearch distribution. This is always
default
. -
type
-
(string)
File type, such as
tar
orzip
, used for the distribution package. -
count
- (integer) Number of selected nodes using the distribution flavor and file type.
-
-
-
snapshots
-
(object) Contains statistics about the snapshot activity in the cluster.
Properties of
snapshots
-
current_counts
-
(object) Contains statistics which report the numbers of various ongoing snapshot activities in the cluster.
Properties of
current_counts
-
snapshots
- (integer) The total number of snapshots and clones currently being created by the cluster.
-
shard_snapshots
- (integer) The total number of outstanding shard snapshots in the cluster.
-
snapshot_deletions
- (integer) The total number of snapshot deletion operations that the cluster is currently running.
-
concurrent_operations
-
(integer)
The total number of snapshot operations that the cluster is currently running
concurrently. This is the total of the
snapshots
andsnapshot_deletions
entries, and is limited by thesnapshot.max_concurrent_operations
setting. -
cleanups
- (integer) The total number of repository cleanup operations that the cluster is currently running. These operations do not count towards the total number of concurrent operations.
-
-
repositories
-
(object) Contains statistics which report the progress of snapshot activities broken down by repository. This object contains one entry for each repository registered with the cluster.
Properties of
repositories
-
current_counts
-
(object) Contains statistics which report the numbers of various ongoing snapshot activities for this repository.
Properties of
current_counts
-
snapshots
- (integer) The total number of ongoing snapshots in this repository.
-
clones
- (integer) The total number of ongoing snapshot clones in this repository.
-
finalizations
- (integer) The total number of this repository’s ongoing snapshots and clone operations which are mostly complete except for their last "finalization" step.
-
deletions
- (integer) The total number of ongoing snapshot deletion operations in this repository.
-
snapshot_deletions
- (integer) The total number of snapshots that are currently being deleted from this repository.
-
active_deletions
-
(integer)
The total number of ongoing snapshot deletion operations which are currently
active in this repository. Snapshot deletions do not run concurrently with other
snapshot operations, so this may be
0
if any pending deletes are waiting for other operations to finish. -
shards
-
(object) Contains statistics which report the shard-level progress of ongoing snapshot activities for a repository. Note that these statistics relate only to ongoing snapshots.
Properties of
shards
-
total
-
(integer)
The total number of shard snapshots currently tracked by this repository. This
statistic only counts shards in ongoing snapshots, so it will drop when a
snapshot completes and will be
0
if there are no ongoing snapshots. -
complete
-
(integer)
The total number of tracked shard snapshots which have completed in this
repository. This statistic only counts shards in ongoing snapshots, so it will
drop when a snapshot completes and will be
0
if there are no ongoing snapshots. -
incomplete
-
(integer)
The total number of tracked shard snapshots which have not completed in this
repository. This is the difference between the
total
andcomplete
values. -
states
- (object) The total number of shard snapshots in each of the named states in this repository. These states are an implementation detail of the snapshotting process which may change between versions. They are included here for expert users, but should otherwise be ignored.
-
-
-
oldest_start_time
- (string) The start time of the oldest running snapshot in this repository.
-
oldest_start_time_in_millis
- (integer) The start time of the oldest running snapshot in this repository, represented as milliseconds since the Unix epoch.
-
-
Examples
editresponse = client.cluster.stats( human: true, pretty: true ) puts response
GET /_cluster/stats?human&pretty
The API returns the following response:
{ "_nodes" : { "total" : 1, "successful" : 1, "failed" : 0 }, "cluster_uuid": "YjAvIhsCQ9CbjWZb2qJw3Q", "cluster_name": "elasticsearch", "timestamp": 1459427693515, "status": "green", "indices": { "count": 1, "shards": { "total": 5, "primaries": 5, "replication": 0, "index": { "shards": { "min": 5, "max": 5, "avg": 5 }, "primaries": { "min": 5, "max": 5, "avg": 5 }, "replication": { "min": 0, "max": 0, "avg": 0 } } }, "docs": { "count": 10, "deleted": 0 }, "store": { "size": "16.2kb", "size_in_bytes": 16684, "total_data_set_size": "16.2kb", "total_data_set_size_in_bytes": 16684, "reserved": "0b", "reserved_in_bytes": 0 }, "search": { ... }, "fielddata": { "memory_size": "0b", "memory_size_in_bytes": 0, "evictions": 0, "global_ordinals": { "build_time" : "0s", "build_time_in_millis" : 0 } }, "query_cache": { "memory_size": "0b", "memory_size_in_bytes": 0, "total_count": 0, "hit_count": 0, "miss_count": 0, "cache_size": 0, "cache_count": 0, "evictions": 0 }, "completion": { "size": "0b", "size_in_bytes": 0 }, "segments": { "count": 4, "memory": "8.6kb", "memory_in_bytes": 0, "terms_memory": "0b", "terms_memory_in_bytes": 0, "stored_fields_memory": "0b", "stored_fields_memory_in_bytes": 0, "term_vectors_memory": "0b", "term_vectors_memory_in_bytes": 0, "norms_memory": "0b", "norms_memory_in_bytes": 0, "points_memory" : "0b", "points_memory_in_bytes" : 0, "doc_values_memory": "0b", "doc_values_memory_in_bytes": 0, "index_writer_memory": "0b", "index_writer_memory_in_bytes": 0, "version_map_memory": "0b", "version_map_memory_in_bytes": 0, "fixed_bit_set": "0b", "fixed_bit_set_memory_in_bytes": 0, "max_unsafe_auto_id_timestamp" : -9223372036854775808, "file_sizes": {} }, "mappings": { "total_field_count": 0, "total_deduplicated_field_count": 0, "total_deduplicated_mapping_size": "0b", "total_deduplicated_mapping_size_in_bytes": 0, "field_types": [], "runtime_field_types": [] }, "analysis": { "char_filter_types": [], "tokenizer_types": [], "filter_types": [], "analyzer_types": [], "built_in_char_filters": [], "built_in_tokenizers": [], "built_in_filters": [], "built_in_analyzers": [], "synonyms": {} }, "versions": [ { "version": "8.0.0", "index_count": 1, "primary_shard_count": 1, "total_primary_size": "7.4kb", "total_primary_bytes": 7632 } ], "dense_vector": { "value_count": 0 } }, "nodes": { "count": { "total": 1, "data": 1, "coordinating_only": 0, "master": 1, "ingest": 1, "voting_only": 0 }, "versions": [ "8.10.4" ], "os": { "available_processors": 8, "allocated_processors": 8, "names": [ { "name": "Mac OS X", "count": 1 } ], "pretty_names": [ { "pretty_name": "Mac OS X", "count": 1 } ], "architectures": [ { "arch": "x86_64", "count": 1 } ], "mem" : { "total" : "16gb", "total_in_bytes" : 17179869184, "adjusted_total" : "16gb", "adjusted_total_in_bytes" : 17179869184, "free" : "78.1mb", "free_in_bytes" : 81960960, "used" : "15.9gb", "used_in_bytes" : 17097908224, "free_percent" : 0, "used_percent" : 100 } }, "process": { "cpu": { "percent": 9 }, "open_file_descriptors": { "min": 268, "max": 268, "avg": 268 } }, "jvm": { "max_uptime": "13.7s", "max_uptime_in_millis": 13737, "versions": [ { "version": "12", "vm_name": "OpenJDK 64-Bit Server VM", "vm_version": "12+33", "vm_vendor": "Oracle Corporation", "bundled_jdk": true, "using_bundled_jdk": true, "count": 1 } ], "mem": { "heap_used": "57.5mb", "heap_used_in_bytes": 60312664, "heap_max": "989.8mb", "heap_max_in_bytes": 1037959168 }, "threads": 90 }, "fs": { "total": "200.6gb", "total_in_bytes": 215429193728, "free": "32.6gb", "free_in_bytes": 35064553472, "available": "32.4gb", "available_in_bytes": 34802409472 }, "plugins": [ { "name": "analysis-icu", "version": "8.10.4", "description": "The ICU Analysis plugin integrates Lucene ICU module into elasticsearch, adding ICU relates analysis components.", "classname": "org.elasticsearch.plugin.analysis.icu.AnalysisICUPlugin", "has_native_controller": false }, ... ], "ingest": { "number_of_pipelines" : 1, "processor_stats": { ... } }, "indexing_pressure": { "memory": { "current": { "combined_coordinating_and_primary": "0b", "combined_coordinating_and_primary_in_bytes": 0, "coordinating": "0b", "coordinating_in_bytes": 0, "primary": "0b", "primary_in_bytes": 0, "replica": "0b", "replica_in_bytes": 0, "all": "0b", "all_in_bytes": 0 }, "total": { "combined_coordinating_and_primary": "0b", "combined_coordinating_and_primary_in_bytes": 0, "coordinating": "0b", "coordinating_in_bytes": 0, "primary": "0b", "primary_in_bytes": 0, "replica": "0b", "replica_in_bytes": 0, "all": "0b", "all_in_bytes": 0, "coordinating_rejections": 0, "primary_rejections": 0, "replica_rejections": 0 }, "limit" : "0b", "limit_in_bytes": 0 } }, "network_types": { ... }, "discovery_types": { ... }, "packaging_types": [ { ... } ] }, "snapshots": { ... } }
This API can be restricted to a subset of the nodes using node filters:
response = client.cluster.stats( node_id: 'node1,node*,master:false' ) puts response
GET /_cluster/stats/nodes/node1,node*,master:false