/elasticsearch-head

A web front end for an elastic search cluster

Primary LanguageJavaScriptApache License 2.0Apache-2.0

elasticsearch-head

A web front end for an ElasticSearch cluster

Installing and Running

There are two ways of running and installing elasticsearch-head

Running as a plugin of ElasticSearch (this is the preferred method)

If you’ve installed the .deb package, then the plugin exectuable will be available at /usr/share/elasticsearch/bin/plugin.

  • sudo elasticsearch/bin/plugin -install mobz/elasticsearch-head
  • open http://localhost:9200/_plugin/head/

This will automatically download the latest version of elasticsearch-head from github and run it as a plugin within the elasticsearch cluster. In this mode;

  • elasticsearch provides a simple webserver to run head
  • elasticsearch-head automatically connects to the node that is running it
  • is available at http://localhost:9200/_plugin/head/ (or whatever the address of your cluster is)
  • Will not work with elasticsearch prior to version 0.17
URL Parameters

Parameters may be appended to the url set some initial state eg. head/index.html?base_uri=http://node-01.example.com:9200

  • base_uri force elasticsearch-head to connect to a particular node.
  • auth_user adds basic auth credentials to http requests ( requires elasticsearch-http-basic plugin)
  • auth_password basic auth password as above (note: without additional security layers, passwords are sent over the network in the clear )

Running as a standalone webapp

  • git clone git://github.com/mobz/elasticsearch-head.git
  • cd elasticsearch-head
  • open index.html

This will manually download the latest version of elasticsearch-head from github and run it standalone. In this mode;

  • elasticsearch-head is running from the file system and some features will not work
  • may have trouble connecting to the node if the node is protected by some security measures
  • works with any version of elasticsearch

Alternatives

elastisearch-head is a standalone webapp written in good-ol’ html5. This means, you can put it up on any webserver, run it directly from the filesystem, use it on an ipad, or put it on a floppy disk and carry it with you.

ClusterOverview Screenshot