Elasticsearch Elasticsearch Performance Metrics: Key Indicators and Monitoring Techniques

By Opster Team

Updated: Jul 23, 2023

| 2 min read


Monitoring Elasticsearch performance is crucial for maintaining the health and efficiency of your cluster. By keeping an eye on key performance metrics, you can identify potential issues and take corrective actions before they escalate into more significant problems. In this article, we will discuss the essential Elasticsearch performance metrics and monitoring techniques to ensure optimal cluster performance. If you want to learn about how to improve Elasticsearch search performance check out this guide.

1. Cluster Health Metrics

Cluster health metrics provide an overview of the overall state of your Elasticsearch cluster. These metrics include:

  • Cluster status: The cluster status can be green, yellow, or red. Green indicates that all primary shards and replicas are allocated, yellow means that all primary shards are allocated but some replicas are not, and red signifies that at least one primary shard is not allocated.
  • Active shards: The number of active primary and replica shards in the cluster.
  • Unassigned shards: The number of shards that are not allocated to any node.
  • Initializing shards: The number of shards that are currently being initialized.
  • Relocating shards: The number of shards that are being moved from one node to another.

To monitor cluster health metrics, you can use the Elasticsearch Cluster Health API:

GET /_cluster/health

2. Node-Level Metrics

Node-level metrics provide insights into the performance of individual nodes in the cluster. Some key node-level metrics include:

  • JVM heap usage: The percentage of JVM heap memory used by Elasticsearch. High JVM heap usage can lead to increased garbage collection times and reduced performance.
  • CPU usage: The percentage of CPU used by Elasticsearch. High CPU usage can indicate that the node is under heavy load and may require additional resources or optimization.
  • Disk usage: The percentage of disk space used by Elasticsearch. High disk usage can lead to slower indexing, merging and search performance.
  • Open file descriptors: The number of open file descriptors used by Elasticsearch. If this number approaches the operating system limit, it can cause node instability or crashes.

To monitor node-level metrics, you can use the Elasticsearch Nodes Stats API:

GET /_nodes/stats

3. Index-Level Metrics

Index-level metrics provide information about the performance of individual indices in the cluster. Some important index-level metrics include:

  • Indexing rate: The number of documents indexed per second. A high indexing rate can indicate that the cluster is handling a large volume of data.
  • Search rate: The number of search queries executed per second. A high search rate can indicate that the cluster is serving a large number of search requests.
  • Merge rate: The rate at which segments are merged in the background. High merge rates can lead to increased disk I/O and CPU usage.
  • Refresh rate: The rate at which Elasticsearch refreshes the search view to make newly indexed documents searchable. Frequent refreshes can impact indexing and search performance.
  • Query cache hit ratio: The ratio of cache hits to total cache requests. A low cache hit ratio can indicate that the query cache is not being utilized effectively.
  • Query cache evictions: The number of cache entries evicted due to memory pressure. High cache evictions can indicate that the cache size is too small or that the cache is not being used effectively.

To monitor index-level metrics, you can use the Elasticsearch Indices Stats API:

GET /_stats


In conclusion, monitoring Elasticsearch performance metrics is essential for maintaining a healthy and efficient cluster. By keeping an eye on cluster health, node-level, and index-level metrics, you can identify potential issues and take corrective actions to ensure optimal cluster performance. Make sure to use the appropriate APIs and tools to monitor these metrics and maintain the health of your Elasticsearch cluster.

How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?