karimalaa / kibana

Kibana 3

Kibana

NOTE: You have reached the Kibana 3 repository. Kibana 3 is a completely new version of Kibana written entirely in HTML and Javascript. You can find the Kibana 2 repository at https://github.com/rashidkpc/Kibana

More information about Kibana 3 can be found at http://www.elasticsearch.org/overview/kibana/

Overview

Kibana is an open source (Apache Licensed), browser based analytics and search interface to Logstash and other timestamped data sets stored in ElasticSearch. With those in place Kibana is a snap to setup and start using (seriously). Kibana strives to be easy to get started with, while also being flexible and powerful

Requirements

• Elasticsearch 0.90.9 or above
• A modern web browser. The latest version of Chrome, Safari and Firefox have all been tested to work. IE9 and greater should work. IE8 does not.
• A webserver. No extensions are required, as long as it can serve plain html it will work
• A browser reachable Elasticsearch server. Port 9200 must be open, or a proxy configured to allow access to it.

Installation

1. Download and extract http://download.elasticsearch.org/kibana/kibana/kibana-latest.zip to your webserver.
2. Edit config.js in your deployed directory to point to your elasticsearch server. This should not be http://localhost:9200, but rather the fully qualified domain name of your elasticsearch server. The url entered here must be reachable by your browser.
3. Point your browser at your installation. If you're using Logstash with the default indexing configuration the included Kibana logstash interface should work nicely.

FAQ

Q: Why doesnt it work? I have http://localhost:9200 in my config.js, my webserver and elasticsearch server are on the same machine
A: Kibana 3 does not work like previous versions of Kibana. To ease deployment, the server side component has been eliminated. Thus the browser connects directly to Elasticsearch. The default config.js setup works for the webserver+Elasticsearch on the same machine scenario. Do not set it to http://localhost:9200 unless your browser and elasticsearch are on the same machine

Q: How do I secure this? I don't want to leave 9200 open.
A: A simple nginx virtual host and proxy configuration can be found in the sample/nginx.conf

Q: How to run the grunt build process.
A: Steps to follow a)Install node & npm b)npm install -g grunt-cli c)npm install in kibana folder d)grunt build

    Useful links:
    	https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager
    	https://npmjs.org/doc/install.html
    	http://www.ghosthorses.co.uk/production-diary/installing-grunt-on-os-x-and-windows-7/

Support

If you have questions or comments the best place to reach me is #logstash or #elasticsearch on irc.freenode.net

Contributing

Please see CONTRIBUTING.md. If you have a bugfix or new feature that you would like to contribute to Kibana, please find or open an issue about it first.