Apache Solr extension
- Latest Dynatrace
- Extension
- Published Oct 27, 2025
Open-source enterprise-search platform, written in Java.
Get started
Overview
Monitor your Apache Solr deployments with Dynatrace. Get metrics on documents, requests and caches for your Solr cores.
Install the agent on your Apache Solr hosts and create an extension monitoring configuration to get started.
This extension relies on JMX metrics collected through the OneAgent and as such requires the OneAgent to be deployed on the Solr hosts. Once that is done, a monitoring configuration for this extension needs to be created for these hosts.
This extension comes with two feature sets, solrcloud and solrusermanaged, designed to work with SolrCloud or Solr User Managed deployments, respectively (see relevant Solr documentation).
The two feature sets collect essentially the same metrics, the main difference being the topology created.
Currently, the only entity types created will be SolrCloud Replica, for SolrCloud deployments and Solr User-Managed Core for Solr User Managed deployments.
Compatibility information
Apache Solr 8.x, 9.x.
Although this extension should also work with Solr 7.x, please note that this version of Apache Solr is EOL and thus we cannot guarantee support for this version going forward.
Details
Licensing and cost
The metrics and events collected through this extension consume Dynatrace Davis Data Units (see DDUs for metrics) or metric data points depending on your licensing model.
A general formula to estimate the number of metrics would be 26 × solr cores.
From there it follows that DDU consumption can be estimated by 13665 × solr cores (DDU per year).
Feature sets
When activating your extension using monitoring configuration, you can limit monitoring to one of the feature sets. To work properly the extension has to collect at least one metric after the activation.
In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.
All metrics that aren't categorized into any feature set are considered to be the default and are always reported.
A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.
default
| Metric name | Metric key | Description |
|---|---|---|
| Solr metadata coreName | solr.solrcloud.metadata.coreName | Placeholder metric to extract metadata |
| Solr metadata replicaState | solr.solrcloud.metadata.replicaState | Placeholder metric to extract metadata |
solrusermanaged
| Metric name | Metric key | Description |
|---|---|---|
| Solr searcher deleted documents (User Managed) | solr.solrusermanaged.searcher.deletedDocs | Solr searcher deleted documents (User Managed) |
| Solr searcher max documents (User Managed) | solr.solrusermanaged.searcher.maxDoc | Solr searcher max documents (User Managed) |
| Solr searcher current documents (User Managed) | solr.solrusermanaged.searcher.numDocs | Solr searcher current documents (User Managed) |
| Solr number of additions (User Managed) | solr.solrusermanaged.update.adds.count | Solr number of additions (User Managed) |
| Solr number of deletes by ID (User Managed) | solr.solrusermanaged.update.deletesById.count | Solr number of deletes by ID (User Managed) |
| Solr number of deletes by query (User Managed) | solr.solrusermanaged.update.deletesByQuery.count | Solr number of deletes by query (User Managed) |
| Solr number of update errors (User Managed) | solr.solrusermanaged.update.errors.count | Solr number of update errors (User Managed) |
| Solr number of requests (User Managed) | solr.solrusermanaged.select.requests.count | Solr number of requests (User Managed) |
| Solr document cache evictions (User Managed) | solr.solrusermanaged.documentCache.evictions.count | Solr document cache evictions (User Managed) |
| Solr document cache hits (User Managed) | solr.solrusermanaged.documentCache.hits.count | Solr document cache hits (User Managed) |
| Solr document cache inserts (User Managed) | solr.solrusermanaged.documentCache.inserts.count | Solr document cache inserts (User Managed) |
| Solr document cache lookups (User Managed) | solr.solrusermanaged.documentCache.lookups.count | Solr document cache lookups (User Managed) |
| Solr query result cache evictions (User Managed) | solr.solrusermanaged.queryResultCache.evictions.count | Solr query result cache evictions (User Managed) |
| Solr query result cache hits (User Managed) | solr.solrusermanaged.queryResultCache.hits.count | Solr query result cache hits (User Managed) |
| Solr query result cache inserts (User Managed) | solr.solrusermanaged.queryResultCache.inserts.count | Solr query result cache inserts (User Managed) |
| Solr query result cache lookups (User Managed) | solr.solrusermanaged.queryResultCache.lookups.count | Solr query result cache lookups (User Managed) |
| Solr filter cache evictions (User Managed) | solr.solrusermanaged.filterCache.evictions.count | Solr filter cache evictions (User Managed) |
| Solr filter cache hits (User Managed) | solr.solrusermanaged.filterCache.hits.count | Solr filter cache hits (User Managed) |
| Solr filter cache inserts (User Managed) | solr.solrusermanaged.filterCache.inserts.count | Solr filter cache inserts (User Managed) |
| Solr filter cache lookups (User Managed) | solr.solrusermanaged.filterCache.lookups.count | Solr filter cache lookups (User Managed) |
| Solr field cache evictions (User Managed) | solr.solrusermanaged.fieldValueCache.evictions.count | Solr field cache evictions (User Managed) |
| Solr field cache hits (User Managed) | solr.solrusermanaged.fieldValueCache.hits.count | Solr field cache hits (User Managed) |
| Solr field cache inserts (User Managed) | solr.solrusermanaged.fieldValueCache.inserts.count | Solr field cache inserts (User Managed) |
| Solr field cache lookups (User Managed) | solr.solrusermanaged.fieldValueCache.lookups.count | Solr field cache lookups (User Managed) |
solrcloud
| Metric name | Metric key | Description |
|---|---|---|
| Solr searcher deleted documents | solr.solrcloud.searcher.deletedDocs | Solr searcher deleted documents |
| Solr searcher max documents | solr.solrcloud.searcher.maxDoc | Solr searcher max documents |
| Solr searcher current documents | solr.solrcloud.searcher.numDocs | Solr searcher current documents |
| Solr number of additions | solr.solrcloud.update.adds.count | Solr number of additions |
| Solr number of deletes by ID | solr.solrcloud.update.deletesById.count | Solr number of deletes by ID |
| Solr number of deletes by query | solr.solrcloud.update.deletesByQuery.count | Solr number of deletes by query |
| Solr number of update errors | solr.solrcloud.update.errors.count | Solr number of update errors |
| Solr number of requests | solr.solrcloud.select.requests.count | Solr number of requests |
| Solr document cache evictions | solr.solrcloud.documentCache.evictions.count | Solr document cache evictions |
| Solr document cache hits | solr.solrcloud.documentCache.hits.count | Solr document cache hits |
| Solr document cache inserts | solr.solrcloud.documentCache.inserts.count | Solr document cache inserts |
| Solr document cache lookups | solr.solrcloud.documentCache.lookups.count | Solr document cache lookups |
| Solr query result cache evictions | solr.solrcloud.queryResultCache.evictions.count | Solr query result cache evictions |
| Solr query result cache hits | solr.solrcloud.queryResultCache.hits.count | Solr query result cache hits |
| Solr query result cache inserts | solr.solrcloud.queryResultCache.inserts.count | Solr query result cache inserts |
| Solr query result cache lookups | solr.solrcloud.queryResultCache.lookups.count | Solr query result cache lookups |
| Solr filter cache evictions | solr.solrcloud.filterCache.evictions.count | Solr filter cache evictions |
| Solr filter cache hits | solr.solrcloud.filterCache.hits.count | Solr filter cache hits |
| Solr filter cache inserts | solr.solrcloud.filterCache.inserts.count | Solr filter cache inserts |
| Solr filter cache lookups | solr.solrcloud.filterCache.lookups.count | Solr filter cache lookups |
| Solr field cache evictions | solr.solrcloud.fieldValueCache.evictions.count | Solr field cache evictions |
| Solr field cache hits | solr.solrcloud.fieldValueCache.hits.count | Solr field cache hits |
| Solr field cache inserts | solr.solrcloud.fieldValueCache.inserts.count | Solr field cache inserts |
| Solr field cache lookups | solr.solrcloud.fieldValueCache.lookups.count | Solr field cache lookups |
FAQ and Troubleshooing
This extension retrieves Apache Solr metrics through the JMX framework, using the mBeans that are created by default by Solr. If you don't see any metrics, or are missing some metrics, ensure that your deployment is exposing mBeans of the following types:
solr:category=UPDATEsolr:category=SEARCHERsolr:category=CACHEsolr:name=requests
