Using ElasticHQ with Bonsai

Bonsai supports the ElasticHQ monitoring and management interface. This open source software gives you insight into the state of your cluster. If you’re looking to see details about performance, check out Cluster Metrics.

The GitHub repo has tons of documentation and how-to guides. This article lays out some common methods of running ElasticHQ locally.

Using OS X with Pow

mkdir -p ~/.pow/elastichq
git clone git@github.com:royrusso/elasticsearch-HQ.git ~/.pow/elastichq/public

Navigate your browser to http://elastichq.dev/. You should see the ElasticHQ dashboard. Enter your Bonsai cluster URL in the field for the cluster location and click on “Connect.” The dashboard will bring up information about your cluster.

Using Grunt

git clone git@github.com:royrusso/elasticsearch-HQ.git
cd elasticsearch-HQ
git checkout master
npm install
grunt server

You should see the ElasticHQ dashboard at http://localhost:9000/. Enter your bonsai.io cluster URL in the field for the cluster location and click on “Connect.” The dashboard will bring up information about your cluster.

Using Apache

First, make sure Apache is running. Typically this means you can access a directory via your browser at http://localhost:80/. Your install may be different, so use whatever URL/folder is appropriate for you.

cd <PUBLIC_HTML>  # The root directory of your HTTP server
git@github.com:royrusso/elasticsearch-HQ.git
cd elasticsearch-HQ/
git checkout master

Open up your browser to http://localhost:80/elasticsearch-HQ/ and you should see the ElasticHQ dashboard. Enter your bonsai.io cluster URL in the field for the cluster location and click on “Connect.” The dashboard will bring up information about your cluster.