Implicit Request Handlers

Solr ships with many out-of-the-box request handlers, which are called implicit because they do not need to be configured in solrconfig.xml before you are able to use them.

These handlers have pre-defined default parameters, known as paramsets, which can be modified if necessary.

Available Implicit Endpoints

All endpoint paths listed below should be placed after Solr’s host and port (if a port is used) to construct a URL.

Admin Handlers

Many of these handlers are used throughout the Admin UI to show information about Solr.

File

Return content of files in ${solr.home}/conf/. This handler must have a collection name in the path to the endpoint.

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/file

ShowFileRequestHandler

_ADMIN_FILE

Health

Report the health of the node (available only in SolrCloud mode)

API Endpoints Class & Javadocs Paramset

v1: solr/admin/info/health

v2: api/node/health

HealthCheckHandler

This endpoint also accepts additional request parameters. Please see Javadocs for details.

Logging

Retrieve and modify registered loggers.

API Endpoints Class & Javadocs Paramset

v1: solr/admin/info/logging

v2: api/node/logging

LoggingHandler

_ADMIN_LOGGING

Luke

Expose the internal Lucene index. This handler must have a collection name in the path to the endpoint.

Documentation: Luke Request Handler

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/luke

LukeRequestHandler

_ADMIN_LUKE

MBeans

Provide info about all registered SolrInfoMBeans. This handler must have a collection name in the path to the endpoint.

Documentation: MBean Request Handler

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/mbeans

SolrInfoMBeanHandler

_ADMIN_MBEANS

Ping

Health check. This handler must have a collection name in the path to the endpoint.

Documentation: Ping

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/ping

PingRequestHandler

_ADMIN_PING

Plugins

Return info about all registered plugins. This handler must have a collection name in the path to the endpoint.

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/plugins

PluginInfoHandler

None.

System Properties

Return JRE system properties.

API Endpoints Class & Javadocs Paramset

v1: solr/admin/info/properties

v2: api/node/properties

PropertiesRequestHandler

_ADMIN_PROPERTIES

Segments

Return info on last commit generation Lucene index segments.

API Endpoint Class & Javadocs Paramset

solr/<collection>/admin/segments

SegmentsInfoRequestHandler

_ADMIN_SEGMENTS

System Info

Return server statistics and settings.

Documentation: System Info Handler

API Endpoints Class & Javadocs Paramset

v1: solr/admin/info/system

v2: api/node/system

SystemInfoHandler

_ADMIN_SYSTEM

This endpoint can also take the collection or core name in the path (solr/<collection>/admin/system or solr/<core>/admin/system) which will include all of the system-level information and additional information about the specific core that served the request.

Threads

Return info on all JVM threads.

API Endpoints Class & Javadocs Paramset

v1: solr/admin/info/threads

v2: api/node/threads

ThreadDumpHandler

_ADMIN_THREADS

Analysis Handlers

Document Analysis

Return a breakdown of the analysis process of the given document.

API Endpoint Class & Javadocs Paramset

solr/<collection>/analysis/document

DocumentAnalysisRequestHandler

_ANALYSIS_DOCUMENT

Field Analysis

Return index- and query-time analysis over the given field(s)/field type(s). This handler drives the Analysis Screen in Solr’s Admin UI.

API Endpoint Class & Javadocs Paramset

solr/<collection>/analysis/field

FieldAnalysisRequestHandler

_ANALYSIS_FIELD

Handlers for Configuration

Config API

Retrieve and modify Solr configuration.

Documentation: Config API

API Endpoint Class & Javadocs Paramset

v1: solr/<collection>/config

v2: api/collections/<collection>/config

SolrConfigHandler

_CONFIG

Dump

Echo the request contents back to the client.

API Endpoint Class & Javadocs Paramset

solr/debug/dump

DumpRequestHandler

_DEBUG_DUMP

Replication

Replicate indexes for SolrCloud recovery and user-managed cluster index distribution. This handler must have a core name in the path to the endpoint.

API Endpoint Class & Javadocs Paramset

solr/<core>/replication

ReplicationHandler

_REPLICATION

Schema API

Retrieve and modify the Solr schema.

Documentation: Schema API

API Endpoint Class & Javadocs Paramset

v1: solr/<collection>/schema, solr/<core>/schema

v2: api/collections/<collection>/schema, api/cores/<core>/schema

SchemaHandler

_SCHEMA

Query Handlers

Export

Export full sorted result sets.

Documentation: Exporting Result Sets

API Endpoint Class & Javadocs Paramset

solr/<collection>/export

ExportHandler

_EXPORT

RealTimeGet

Low-latency retrieval of the latest version of a document.

Documentation: RealTime Get

API Endpoint Class & Javadocs Paramset

solr/<collection>/get

RealTimeGetHandler

_GET

Graph Traversal

Return GraphML formatted output from a gatherNodes streaming expression.

Documentation: Graph Traversal

API Endpoint Class & Javadocs Paramset

solr/<collection>/graph

GraphHandler

_ADMIN_GRAPH

SQL

SQL query support.

Documentation: SQL Request Handler

API Endpoint Class & Javadocs Paramset

solr/<collection>/sql

SQLHandler

_SQL

Streaming Expressions

Distributed stream processing.

API Endpoint Class & Javadocs Paramset

solr/<collection>/stream

StreamHandler

_STREAM

Terms

Return a field’s indexed terms and the number of documents containing each term.

API Endpoint Class & Javadocs Paramset

solr/<collection>/terms

SearchHandler

_TERMS

Update Handlers

Update

Add, delete and update indexed documents formatted as SolrXML, CSV, SolrJSON or javabin.

API Endpoint Class & Javadocs Paramset

solr/<collection>/update

UpdateRequestHandler

_UPDATE

CSV Updates

Add and update CSV-formatted documents.

API Endpoint Class & Javadocs Paramset

solr/<collection>/update/csv

UpdateRequestHandler

_UPDATE_CSV

JSON Updates

Add, delete and update SolrJSON-formatted documents.

API Endpoint Class & Javadocs Paramset

solr/<collection>/update/json

UpdateRequestHandler

_UPDATE_JSON

Custom JSON Updates

Add and update custom JSON-formatted documents.

API Endpoint Class & Javadocs Paramset

solr/<collection>/update/json/docs

UpdateRequestHandler

_UPDATE_JSON_DOCS

How to View Implicit Handler Paramsets

You can see configuration for all request handlers, including the implicit request handlers, via the Config API.

To include the expanded paramset in the response, as well as the effective parameters from merging the paramset parameters with the built-in parameters, use the expandParams request parameter.

For example, for the /export request handler, you can make a request like this:

  • V1 API

  • V2 API

http://localhost:8983/solr/gettingstarted/config/requestHandler?componentName=/export&expandParams=true
http://localhost:8983/api/collections/gettingstarted/config/requestHandler?componentName=/export&expandParams=true

The response will look similar to:

{
  "config": {
    "requestHandler": {
      "/export": {
        "class": "solr.ExportHandler",
        "useParams": "_EXPORT",
        "components": ["query"],
        "defaults": {
          "wt": "json"
        },
        "invariants": {
          "rq": "{!xport}",
          "distrib": false
        },
        "name": "/export",
        "_useParamsExpanded_": {
          "_EXPORT": "[NOT AVAILABLE]"
        },
        "_effectiveParams_": {
          "distrib": "false",
          "omitHeader": "true",
          "wt": "json",
          "rq": "{!xport}"
        }
      }
    }
  }
}

How to Edit Implicit Handler Paramsets

Because implicit request handlers are not present in solrconfig.xml, configuration of their associated default, invariant and appends parameters may be edited via the Request Parameters API using the paramset listed in the above table. However, other parameters, including SearchHandler components, may not be modified. The invariants and appends specified in the implicit configuration cannot be overridden.