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


(Zachary Tong) #1

I'd like to share Inquisitor, a new Site pluginhttps://github.com/polyfractal/elasticsearch-inquisitorthat 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:

The plugin can be found here:

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.
For more options, visit https://groups.google.com/groups/opt_out.


(David Pilato) #2

Very cool Zach!
Thanks for sharing.

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

Le 2 mars 2013 à 19:06, Zachary Tong 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: 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.
For more options, visit 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.
For more options, visit https://groups.google.com/groups/opt_out.


(vineeth mohan) #3

Loved the tool.
Big claps.

Thanks
Vineeth

On Sun, Mar 3, 2013 at 1:24 AM, David Pilato david@pilato.fr wrote:

Very cool Zach!
Thanks for sharing.

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

Le 2 mars 2013 à 19:06, Zachary Tong zacharyjtong@gmail.com a écrit :

I'd like to share Inquisitor, a new Site pluginhttps://github.com/polyfractal/elasticsearch-inquisitorthat 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:

The plugin can be found here:
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.
For more options, visit 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.
For more options, visit 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.
For more options, visit https://groups.google.com/groups/opt_out.


(Todd Hardin) #4

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 -


(system) #5