Performance Statistics Reference

This page explains some of the JMX statistics that Solr exposes.

The same statistics are also exposed via the MBean Request Handler when statistics are requested.

These statistics are per core. When you are running in SolrCloud mode these statistics would co-relate to each performance of an individual replica.

Request Handlers

Update Request Handler

The update request handler is an endpoint to send data to Solr. We can see how many update requests are being fired, how fast is it performing, and other valuable information regarding requests.

Path: /solr/<core>/update

Search Request Handler

Can be useful to measure and track number of search queries , response times etc. If you are not using the “select” handler then the path needs to be changed appropriately. Similarly if you are using the “sql” handler or “export” handler , the realtime handler “get”, or any other handler similar statistics can be found for that as well.

Path: /solr/<core>/select

Both Update Request Handler and Search Request Handler along with handlers like “sql”, “export” and realtime “get” handler will provide the following attributes in their statistics.

Attribute Description

15minRateReqsPerSecond

Requests per second received over the past 15 minutes.

5minRateReqsPerSecond

Requests per second received over the past 5 minutes.

75thPcRequestTime

Request processing time for the request which belongs to the 75th Percentile. E.g., if 100 requests are received, then the 75th fastest request time will be reported by this statistic.

95thPcRequestTime

Request processing time in milliseconds for the request which belongs to the 95th Percentile. E.g., if 80 requests are received, then the 76th fastest request time will be reported in this statistic.

999thPcRequestTime

Request processing time in milliseconds for the request which belongs to the 99.9th Percentile. E.g., if 1000 requests are received, then the 999th fastest request time will be reported in this statistic.

99thPcRequestTime

Request processing time in milliseconds for the request which belongs to the 99th Percentile. E.g., if 200 requests are received, then the 198th fastest request time will be reported in this statistic.

avgRequestsPerSecond

Average number of requests received per second.

avgTimePerRequest

Average time taken for processing the requests. This parameter will decay over time, with a bias toward activity in the last 5 minutes.

errors

Number of error encountered by handler.

clientErrors

Number of syntax errors/parse errors made by client while making requests.

handlerStart

Epoch time when the handler was registered.

medianRequestTime

Median of all the request processing time.

requests

Total number of requests made since the Solr process was started.

serverErrors

Number of errors thrown by the server while executing the request.

timeouts

Number of responses received with partial results.

totalTime

The sum of all request processing times since the Solr process was started.

Update Handler

Update Handler: This section has information on the total number of adds, how many commits have been fired against a solr core.

Path: /solr/<core>/updateHandler/DirectUpdateHandler2

Attribute Description

adds

Total number of “add” requests since last commit.

autocommit maxTime

Maximum time between two autocommits execution.

autocommits

Total number of auto-commits executed.

cumulative_adds

Number of “effective” additions executed over the lifetime. The counter is incremented when “add‘ command is executed while decremented when “rollback” is executed.

cumulative_deletesById

Number of document deletions executed by ID over the lifetime. The counter is incremented when “delete” command is executed while decremented when “rollback” is executed.

cumulative_deletesByQuery

Number of document deletions executed by query over the lifetime. The counter is incremented when “delete” command is executed while decremented when “rollback” is executed.

cumulative_errors

Number of error messages received by Update Handler while performing addition/deletion action on documents over the lifetime.

deletesById

Currently uncommitted deletions by ID.

deletesByQuery

Currently uncommitted deletions by query.

docsPending

Number of documents which are pending commit.

errors

Number of error messages received by Update Handler while performing addition/deletion/commit/rollback action on documents over the lifetime.

expungeDeletes

Number of commit commands issued with expunge deletes.

optimizes

Number of explicit optimize commands issued

rollbacks

Number of rollbacks executed.

soft autocommit maxTime

Maximum documents ‘adds’ between two soft auto-commits.

soft autocommits

Number of soft commits executed.

transaction_logs_total_number

Number of TLogs created from the beginning of the Solr instance. It will be equivalent to number of Hard commits executed.

transaction_logs_total_size

Total size of all the TLogs created so far from the beginning of the Solr instance.

Caches

Document Cache

This cache holds Lucene Document objects (the stored fields for each document). Since Lucene internal document IDs are transient, this cache cannot be auto-warmed.

Path: /solr/<cache>/documentCache

Query Result Cache

This cache holds the results of previous searches: ordered lists of document IDs based on a query, a sort, and the range of documents requested

Path: /solr/<cache>/queryResultCache

Filter Cache

This cache is used for filters for unordered sets of all documents that match a query.

Path: /solr/<cache>/filterCache

Attribute Description

cumulative_evictions

Number of cache evictions across all caches since this node has been running.

cumulative_hitratio

Ratio of cache hits to lookups across all the caches since this node has been running.

cumulative_hits

Number of cache hits across all the caches since this node has been running.

cumulative_inserts

Number of cache insertions across all the caches since this node has been running.

cumulative_lookups

Number of cache lookups across all the caches since this node has been running.

evictions

Number of cache evictions for the current index searcher.

hitratio

Ratio of cache hits to lookups for the current index searcher.

hits

Number of hits for the current index searcher.

inserts

Number of inserts into the cache.

lookups

Number of lookups against the cache.

size

Size of the cache at that particular instance (in KBs).

warmupTime

Warm-up time for the registered index searcher. This time is taken in account for the “auto-warming” of caches.

More information on Solr caches is available in the section Query Settings in SolrConfig.