elasticvue

Forked initially from cars10

Contents

1. About
2. Usage
   • Running elasticvue
   • Elasticsearch Configuration
3. Browser support
4. Troubleshooting
5. Comparing with other frontends
6. Development

About

Elasticvue is a gui for elasticsearch allowing you to search and filter your clusters data right in your browser.

It officially works with the following elasticsearch versions:

• 5.6
• 6.8
• 7.0
• 7.1
• 7.2
• 7.3
• 7.4
• 7.5

Other versions might or might not work, elasticsearch-js will fallback to the 7.4 api if an unsupported version is used.

Features

• Cluster overview
• Index management
• Searching and filtering documents
• Manually running any query against your cluster
• Snapshot + repository management
• Utilities, e.g. deleting all indices

Usage

Running

You can build the image locally:

• Checkout the repo git clone https://github.com/ellingtonb/elasticvue.git
• Open the folder cd elasticvue
• Build docker build -t elasticvue .
• Run docker run -p 8080:8080 elasticvue

Or use docker-compose:

• docker-compose up -d

Then open http://localhost:8080 in your browser.

Run locally

• Checkout the repo git clone https://github.com/ellingtonb/elasticvue.git
• Open the folder cd elasticvue
• Install dependencies yarn install
• Run a production server via yarn prod or dev server yarn serve

Alternatively run yarn build and host the assets yourself. Example nginx config:

server {
  listen 80;
  server_name yourdomain.com;
  root /var/www/elasticvue_app/dist;
  location / {
    try_files $uri $uri/ /index.html?$args;
  }
}

See the official vuejs deployment guide for more details.

Elasticsearch configuration

You have to enable CORS to allow connection to your elasticsearch cluster if you do not use the browser extensions.

Find your elasticsearch configuration (for example /etc/elasticsearch/elasticsearch.yml) and add the following lines:

# enable CORS
http.cors.enabled: true

# Then set the allowed origins based on how you run elasticvue. Chose only one:
# for docker / running locally
http.cors.allow-origin: "http://localhost:8080"
# online version
http.cors.allow-origin: /https?:\/\/app.elasticvue.com/

# and if your cluster uses authorization you also have to add:
http.cors.allow-headers: X-Requested-With,Content-Type,Content-Length,Authorization

If you use docker to run your elasticsearch cluster you can pass the options via environment variables:

docker run -p 9200:9200 \
           -e "http.cors.enabled=true" \
           -e "http.cors.allow-origin=/.*/" \
           elasticsearch

This also works for docker-compose:

services:
  elasticsearch:
    image: elasticsearch
    environment:
      - http.cors.enabled=true
      - http.cors.allow-origin=/.*/
    ports:
      - 9200:9200

After configuration restart your cluster and you should be able to connect.

Browser Support

Development is done on chrome. Firefox, safari and edge should work but are mostly untested.

IE	Edge (2020)	Safari	Firefox	Chrome
None	80+	12+	60+	70+

Troubleshooting

Before opening an issue please try to reset elasticvue to its default settings. To reset click Disconnect and reset in the footer, this will reset all your saved filters and you have to reconnect to your cluster.

Development

Setup and running

# clone
git clone https://github.com/ellingtonb/elasticvue.git
cd elasticvue

# install dependencies
yarn install

# serve with hot reload at localhost:8080
yarn serve

# tests
yarn test:unit   # add --watch to watch test files

# for e2e tests you need a running elasticsearch server on port 9123
yarn test:e2e    # add --headless for headless mode

Other commands

# linting
yarn lint

# minimized build for production
yarn build

# create bundle size report at dist/report.html, dist/legacy-report.html
yarn build --report

Building the chrome/firefox extensions: (Hint: you need web-ext for the firefox extension to build)

yarn build_browser_extensions

TODO

1.0

• switch to new elasticsearch javascript client
• switch to vue-composition-api
• refactor runRequest to use promises
• document, index, snapshot repo and snapshot: add edit/delete
• catch elasticsearch 5xx errors

License

MIT