explain.solr.pl (beta)

A tool for finding out why the documents are where they are in the results list.


Supported versions of Apache Solr

Explain.solr.pl supports the following versions of Apache Solr search server:

We plan to support Apache Solr 3.6 and newer, but support for versions older than 3.0 is not planned.

Adding a new query - 10 seconds tutorial

In order to add Your query explain information and visualise it, please add the following to your query debugQuery=true and paste the raw Solr response. So if your query looks like q=hd&bf=pow(sold,1.5)&qf=name,description,attributes you should re-run a query which looks like the following: q=hd&bf=pow(sold,1.5)&qf=name,description,attributes&debugQuery=true.

Adding a new query - detailed tutorial

In order to add Your query explain information and visualise it, please add the following parameters to your query:

After adding those parameters please re-run the query. After that paste raw Solr response and click "Create Explain" button.
In order for explain.solr.pl to work the best way, please ensure that one of the fields you return in the documents is your unique identifier (You can add this by modifying with the fl parameter).
The meaning of the additional parameters is:

Hidding your explain visualisation

If you want to make your explain information visualisation private please uncheck the "I want this explain to be visible on history page." checkbox on the "New explain" page. In order to get back to your explain information you will need to remember its identifier and visit the following URL: http://explain.solr.pl/explains/[ID]. For example, if explain.solr.pl generated 53827fty identifier for Your explain, You should visit http://explain.solr.pl/explains/53827fty.

Available information

Explain.solr.pl application can show you the following information regarding your query results:


Unique identifier

On the top of the explain visualisation page, you can see the unique identifier of Your explain visualisation. You will need that identifier to get back to the explain visualisation later.

Public availability

This sections of explain visualisation page tells you about the public availability of your query explain. If you see a sentence like "This explain is available to public." your explain is visible by other users. In other case, to see your explain visualisation, you will need to know its unique identifier.

Fields returned

This section contain information about the value of the fields that were returned by Solr (this are usually the fields defined in the fl parameter).

Score decomposition

One of the main sections of explain visualisation which shows which elements of the scoring influenced the score and how. This section shows percentages of each debug query information.

Explain components

This is the visualisation of the data that is presented in the "Score decomposition" section of the explain visualisation. You can see the same numbers that are presented in the mentioned section, but visualised in a form of pie chart.


This tab presents the simple performance information about query components of the query connected to the explain information you've sent to explain.solr.pl.

Common errors

Here are some common error that You can see while using explain.solr.pl: