Name: mirage
Owner: appbase.io
Description: :art: GUI for simplifying Elasticsearch Query DSL
Created: 2016-02-25 06:15:36.0
Updated: 2018-05-23 01:10:23.0
Pushed: 2018-02-09 17:17:39.0
Homepage: http://opensource.appbase.io/mirage
Size: 91125
Language: TypeScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
The Elasticsearch query DSL supports 100+ query APIs ranging from full-text search, numeric range filters, geolocation queries to nested and span queries.
Mirage is a modern, open-source web based query explorer for Elasticsearch.
It offers a blocks based GUI for composing Elasticsearch queries and comes with an on-the-fly transformer to show the corresponding JSON query API of Elasticsearch.
Add Conditions
allows adding additional clauses within the same query andNested Query
allows adding a nested query clause.Mirage works with an Elasticsearch 2.x index currently. Below is the roadmap for query support.
? indicates queries already supported.
? indicates queries we would like to support and see contributions for.
? indicates queries that can't be supported currently.
| Full-text Queries | Term Level Queries | Joining Queries | Geo Queries | Specialized Queries | Span Queries | | :——————–: |:———————:| :————–:| :——————-:|:——————-:|:————:| | ? Match | ? Term | ? Nested | ? GeoDistance | ? MoreLikeThis | ? SpanTerm | | ? Multi-match | ? Terms | ? HasChild | ? GeoBoundingBox | ? Template | ? SpanMulti | | ? Query String | ? Range | ? HasParent | ? GeoShape | ? Script | ? SpanFirst | | ? Simple Query String | ? Exists | ? ParentId | ? GeoDistanceRange | | ? SpanNear | | ? Common Terms | ? Missing | | ? GeoPolygon | | ? SpanOr | | | ? Prefix | | ? GeoHashCell | | ? SpanNot | | | ? Wildcard | | | | ? SpanContaining | | | ? Regexp | | | | ? SpanWithin | | | ? Fuzzy | | | | | | ? Ids | | | | | | ? Type | | | |
Besides broadening the query support, we would like to see Mirage support Elasticsearch v5.0.
m install
wer install
m start
This will start a local webserver running on port 3030 serving mirage locally.
m test
will fire up the jasmine tests.
master
branch: Elasticsearch Pluginm run build_es_plugin
chrome-extension
branch: Chrome extensionm run build_chrome_extension
npm test
.Mirage is available as a hosted app and as a chrome extension.
or
or
Every app in appbase.io has a query explorer view, which uses mirage.
or
Works with Elasticsearch versions 1.x, 2.x and 5.x.
er run -p 3030:3030 -d appbaseio/mirage
CORS settings: To make sure you enable CORS settings for your ElasticSearch instance, add the following lines in the ES configuration file.
.port: 9200
.cors.allow-origin: "/.*/"
.cors.enabled: true
.cors.allow-headers: X-Requested-With,X-Auth-Token,Content-Type, Content-Length, Authorization
.cors.allow-credentials: true
[Deprecated] Works with Elasticsearch versions 1.x and 2.x. Site plugins have been disabled starting v5.0. We recommend running mirage with docker instead.
in install appbaseio/mirage
Note:
Elasticsearch has a CORS header issue with v2.3.0, use v2.3.2 and above.
.port: 9200
.cors.allow-origin: "/.*/"
.cors.enabled: true
.cors.allow-headers: X-Requested-With,X-Auth-Token,Content-Type, Content-Length, Authorization
.cors.allow-credentials: true
After installing the plugin, start the elasticsearch service and visit the following URL to access it.
http://127.0.0.1:9200/_plugin/mirage
Note:
If you use Elasticsearch from a different port, the URL to access and the http.cors.allow-origin value in the configuration file would change accordingly.
Mirage can be used along with ? DejaVu to browse data and perform CRUD operations inside an Elasticsearch index.
Proudly built with