# \[Announcement\] Introducing Inquisitor, a new Site plugin to help debug queries

**URL:** <https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976>\
**Category:** Elasticsearch\
**Created:** [March 2, 2013, 6:06pm UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976 "2013-03-02T18:06:11Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![polyfractal](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/polyfractal/32/48162_2.png) [@polyfractal](https://discuss.elastic.co/u/polyfractal)\
**Post date:** [March 2, 2013, 6:06pm UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976/1 "2013-03-02T18:06:11Z")

</div>

I'd like to share Inquisitor, a new Site plugin[https://github.com/polyfractal/elasticsearch-inquisitor](https://github.com/polyfractal/elasticsearch-inquisitor)that I've written for ElasticSearch. Inquisitor is intended to help both  
beginners and advanced users with their queries.

For newcomers to ElasticSearch, problems tend to result from incorrect  
syntax in the query DSL. Inquisitor helps by:

- Parsing and formatting your JSON while you type. Uses JSONLint to  
help identify parsing errors.
- Reformats error responses from ES into a more manageable table,  
instead of a big blob of nested statements and JSON encoded JSON.

For more advanced users, problems tend to deal with result relevance. The  
query may work technically, but results are incorrect or poorly scored.  
These problems are more difficult to fix, since relevance is affected by  
query composition, mapping details, and the documents in your index. This  
also makes it difficult for third-parties to help diagnose the problem  
without a complete recreation of the search environment.

Inquisitor helps diagnose these problems by:

- Automatically applying a highlighter to your query whenever possible
- Formatting source document
- Quasi-support for the Explain API (currently gives you a curl command,  
full integration once Commit b4b3e5[https://github.com/elasticsearch/elasticsearch/commit/b4b3e350a6072bab214fffdbbb1bec89f29da9a2](https://github.com/elasticsearch/elasticsearch/commit/b4b3e350a6072bab214fffdbbb1bec89f29da9a2) makes  
its way into a release)
- Analyzer and Tokenizer playgrounds to experiment with arbitrary text  
and see how ES parses it, in real-time

The plugin can be found here:

> **[polyfractal/elasticsearch-inquisitor](https://github.com/polyfractal/elasticsearch-inquisitor)**
>
> elasticsearch-inquisitor - Site plugin for Elasticsearch to help understand and debug queries.

This is a pretty barebones v0.1 release, I have a bunch of features I'd  
like to add in the near future. As always, any comments, issues or  
requests are welcome!  
-Zach

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![dadoonet](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/dadoonet/32/137187_2.png) [@dadoonet](https://discuss.elastic.co/u/dadoonet)\
**Post date:** [March 2, 2013, 7:54pm UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976/2 "2013-03-02T19:54:54Z")

</div>

Very cool Zach!  
Thanks for sharing.

--  
David 😉  
Twitter : @dadoonet / @elasticsearchfr / @scrutmydocs

Le 2 mars 2013 à 19:06, Zachary Tong [zacharyjtong@gmail.com](mailto:zacharyjtong@gmail.com) a écrit :

> I'd like to share Inquisitor, a new Site plugin that I've written for Elasticsearch. Inquisitor is intended to help both beginners and advanced users with their queries.
> 
> For newcomers to Elasticsearch, problems tend to result from incorrect syntax in the query DSL. Inquisitor helps by:  
> Parsing and formatting your JSON while you type. Uses JSONLint to help identify parsing errors.  
> Reformats error responses from ES into a more manageable table, instead of a big blob of nested statements and JSON encoded JSON.
> 
> For more advanced users, problems tend to deal with result relevance. The query may work technically, but results are incorrect or poorly scored. These problems are more difficult to fix, since relevance is affected by query composition, mapping details, and the documents in your index. This also makes it difficult for third-parties to help diagnose the problem without a complete recreation of the search environment.
> 
> Inquisitor helps diagnose these problems by:  
> Automatically applying a highlighter to your query whenever possible  
> Formatting source document  
> Quasi-support for the Explain API (currently gives you a curl command, full integration once Commit b4b3e5 makes its way into a release)  
> Analyzer and Tokenizer playgrounds to experiment with arbitrary text and see how ES parses it, in real-time
> 
> The plugin can be found here: [GitHub - polyfractal/elasticsearch-inquisitor: Site plugin for Elasticsearch to help understand and debug queries.](https://github.com/polyfractal/elasticsearch-inquisitor)
> 
> ## This is a pretty barebones v0.1 release, I have a bunch of features I'd like to add in the near future. As always, any comments, issues or requests are welcome! -Zach
> 
> You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
> To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
> For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![vineeth\_mohan](https://avatars.discourse-cdn.com/v4/letter/v/bc79bd/32.png) [@vineeth\_mohan](https://discuss.elastic.co/u/vineeth_mohan)\
**Post date:** [March 3, 2013, 4:56am UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976/3 "2013-03-03T04:56:46Z")

</div>

Loved the tool.  
Big claps.

Thanks  
Vineeth

On Sun, Mar 3, 2013 at 1:24 AM, David Pilato [david@pilato.fr](mailto:david@pilato.fr) wrote:

> Very cool Zach!  
> Thanks for sharing.
> 
> --  
> David 😉  
> Twitter : @dadoonet / @elasticsearchfr / @scrutmydocs
> 
> Le 2 mars 2013 à 19:06, Zachary Tong [zacharyjtong@gmail.com](mailto:zacharyjtong@gmail.com) a écrit :
> 
> I'd like to share Inquisitor, a new Site plugin[https://github.com/polyfractal/elasticsearch-inquisitor](https://github.com/polyfractal/elasticsearch-inquisitor)that I've written for Elasticsearch. Inquisitor is intended to help both  
> beginners and advanced users with their queries.
> 
> For newcomers to Elasticsearch, problems tend to result from incorrect  
> syntax in the query DSL. Inquisitor helps by:
> 
> - Parsing and formatting your JSON while you type. Uses JSONLint to  
> help identify parsing errors.
> - Reformats error responses from ES into a more manageable table,  
> instead of a big blob of nested statements and JSON encoded JSON.
> 
> For more advanced users, problems tend to deal with result relevance. The  
> query may work technically, but results are incorrect or poorly scored.  
> These problems are more difficult to fix, since relevance is affected by  
> query composition, mapping details, and the documents in your index. This  
> also makes it difficult for third-parties to help diagnose the problem  
> without a complete recreation of the search environment.
> 
> Inquisitor helps diagnose these problems by:
> 
> - Automatically applying a highlighter to your query whenever possible
> - Formatting source document
> - Quasi-support for the Explain API (currently gives you a curl  
> command, full integration once Commit b4b3e5[https://github.com/elasticsearch/elasticsearch/commit/b4b3e350a6072bab214fffdbbb1bec89f29da9a2](https://github.com/elasticsearch/elasticsearch/commit/b4b3e350a6072bab214fffdbbb1bec89f29da9a2) makes  
> its way into a release)
> - Analyzer and Tokenizer playgrounds to experiment with arbitrary text  
> and see how ES parses it, in real-time
> 
> The plugin can be found here:  
> [GitHub - polyfractal/elasticsearch-inquisitor: Site plugin for Elasticsearch to help understand and debug queries.](https://github.com/polyfractal/elasticsearch-inquisitor)
> 
> This is a pretty barebones v0.1 release, I have a bunch of features I'd  
> like to add in the near future. As always, any comments, issues or  
> requests are welcome!  
> -Zach
> 
> --  
> You received this message because you are subscribed to the Google Groups  
> "elasticsearch" group.  
> To unsubscribe from this group and stop receiving emails from it, send an  
> email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
> For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).
> 
> --  
> You received this message because you are subscribed to the Google Groups  
> "elasticsearch" group.  
> To unsubscribe from this group and stop receiving emails from it, send an  
> email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
> For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![Todd.Hardin](https://avatars.discourse-cdn.com/v4/letter/t/ed655f/32.png) [@Todd.Hardin](https://discuss.elastic.co/u/Todd.Hardin)\
**Post date:** [November 5, 2015, 11:35pm UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976/4 "2015-11-05T23:35:27Z")

</div>

I am new to Elastic and have been searching for an equivalent to the Sense feature that was added to Mercury app... but no longer seems to be in the Mercury app?

Anyway - Inquisitor seemed to be just what I would want/need as a tool for learning the Elastic DSL, etc., etc.

I see the last Commit on GitHub for this project was Sept 8, 2014.  
I was not able to get Inquisitor to work with ES v2.0.0 (windows)

Question: Zachary (or anyone) - can you advise please?

Thanks -

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [July 5, 2017, 11:40pm UTC](https://discuss.elastic.co/t/announcement-introducing-inquisitor-a-new-site-plugin-to-help-debug-queries/10976/5 "2017-07-05T23:40:15Z")

</div>


