elastic.go - A command-line tool to query the Elasticsearch REST API

elastic.go was born to turn commands that look like this:

curl -XGET 'http://localhost:9200/_nodes/_all/host,ip' | python -m json.tool

into this:

elastic node list

elastic fetches data from your Elasticsearch instance, formats the data nicely when it is JSON compressed data, and adds a bit of colors to make it more readable to the human eye. It aims at providing shortcuts for all default Elasticsearch routes. For instance, you can get the cluster health with elastic cluster health (or elastic c he for short).

Of course, you can still issue any GET requests with elastic query <YOUR REQUEST HERE> (or elastic q for short), like elastic q twitter/tweet,user/_search?q=user:kimchy'. By design, only GET requests are allowed. I wanted to make it easy to query Elasticseach indexes, not deleting them so use the good old curl -XDELETE ... if this is what you want to achieve. There is currently no support for PUT requests either since I have no use for it. Pull requests are welcome however.

Installation

Providing that Go is installed and that $GOPATH is set, simply use the following command:

go get -u github.com/Rolinh/elastic-go

Make sure that $GOPATH/bin is in your $PATH.

Build a Docker image

A Dockerfile is provided. Simply run the following command to build the Docker image:

docker build -t Rolinh/elastic-go .

## Usage

`elastic help` provides general help:

$ elastic help NAME: elastic - A command line tool to query the Elasticsearch REST API

USAGE: elastic [global options] command [command options] [arguments...]

VERSION: 1.0.0

AUTHOR(S): Robin Hahling [email protected]

COMMANDS: cluster, c Get cluster information index, i Get index information node, n Get cluster nodes information query, q Perform any ES API GET query stats, s Get statistics help, h Shows a list of commands or help for one command

GLOBAL OPTIONS: --baseurl "http://localhost:9200/" Base API URL --help, -h show help --version, -v print the version

Help works for any subcommand as well. For instance:

$ elastic index help NAME: elastic index - Get index information

USAGE: elastic index [global options] command [command options] [arguments...]

VERSION: 1.0.0

COMMANDS: docs-count, dc Get index documents count list, l List all indexes size, si Get index size status, st Get index status verbose, v List indexes information with many stats help, h Shows a list of commands or help for one command

GLOBAL OPTIONS: --help, -h show help