2018-11-15 23:49:36 +01:00
# Kibana
2014-03-04 19:58:10 +01:00
2018-04-20 21:13:37 +02:00
Kibana is your window into the [Elastic Stack ](https://www.elastic.co/products ). Specifically, it's a browser-based analytics and search dashboard for Elasticsearch.
2014-09-18 22:45:25 +02:00
2016-11-18 18:30:43 +01:00
- [Getting Started ](#getting-started )
- [Using a Kibana Release ](#using-a-kibana-release )
- [Building and Running Kibana, and/or Contributing Code ](#building-and-running-kibana-andor-contributing-code )
- [Documentation ](#documentation )
- [Version Compatibility with Elasticsearch ](#version-compatibility-with-elasticsearch )
- [Questions? Problems? Suggestions? ](#questions-problems-suggestions )
2014-10-06 18:49:21 +02:00
2016-11-18 18:30:43 +01:00
## Getting Started
2014-10-06 18:49:21 +02:00
2016-11-18 18:30:43 +01:00
If you just want to try Kibana out, check out the [Elastic Stack Getting Started Page ](https://www.elastic.co/start ) to give it a whirl.
2014-09-19 01:10:13 +02:00
2016-11-18 18:30:43 +01:00
If you're interested in diving a bit deeper and getting a taste of Kibana's capabilities, head over to the [Kibana Getting Started Page ](https://www.elastic.co/guide/en/kibana/current/getting-started.html ).
2014-09-19 01:10:13 +02:00
2016-11-18 18:30:43 +01:00
### Using a Kibana Release
2016-01-05 17:39:45 +01:00
2016-11-18 18:30:43 +01:00
If you want to use a Kibana release in production, give it a test run, or just play around:
2016-01-05 17:39:45 +01:00
2016-11-18 18:30:43 +01:00
- Download the latest version on the [Kibana Download Page ](https://www.elastic.co/downloads/kibana ).
- Learn more about Kibana's features and capabilities on the
[Kibana Product Page ](https://www.elastic.co/products/kibana ).
- We also offer a hosted version of Kibana on our
[Cloud Service ](https://www.elastic.co/cloud/as-a-service ).
### Building and Running Kibana, and/or Contributing Code
2017-11-21 23:18:42 +01:00
You might want to build Kibana locally to contribute some code, test out the latest features, or try
2016-11-18 18:30:43 +01:00
out an open PR:
- [CONTRIBUTING.md ](CONTRIBUTING.md ) will help you get Kibana up and running.
- If you would like to contribute code, please follow our [STYLEGUIDE.md ](STYLEGUIDE.md ).
- For all other questions, check out the [FAQ.md ](FAQ.md ) and
[wiki ](https://github.com/elastic/kibana/wiki ).
## Documentation
Visit [Elastic.co ](http://www.elastic.co/guide/en/kibana/current/index.html ) for the full Kibana documentation.
2018-02-01 19:19:00 +01:00
For information about building the documentation, see the README in [elastic/docs ](https://github.com/elastic/docs ).
2016-11-18 18:30:43 +01:00
## Version Compatibility with Elasticsearch
2016-09-10 00:36:09 +02:00
2016-09-15 03:12:05 +02:00
Ideally, you should be running Elasticsearch and Kibana with matching version numbers. If your Elasticsearch has an older version number or a newer _major_ number than Kibana, then Kibana will fail to run. If Elasticsearch has a newer minor or patch number than Kibana, then the Kibana Server will log a warning.
_Note: The version numbers below are only examples, meant to illustrate the relationships between different types of version numbers._
| Situation | Example Kibana version | Example ES version | Outcome |
| ------------------------- | -------------------------- |------------------- | ------- |
| Versions are the same. | 5.1.2 | 5.1.2 | 💚 OK |
| ES patch number is newer. | 5.1.__2__ | 5.1.__5__ | ⚠️ Logged warning |
| ES minor number is newer. | 5.__1__.2 | 5.__5__.0 | ⚠️ Logged warning |
| ES major number is newer. | __5__ .1.2 | __6__ .0.0 | 🚫 Fatal error |
2016-11-05 01:01:38 +01:00
| ES patch number is older. | 5.1.__2__ | 5.1.__0__ | ⚠️ Logged warning |
2016-09-15 03:12:05 +02:00
| ES minor number is older. | 5.__1__.2 | 5.__0__.0 | 🚫 Fatal error |
| ES major number is older. | __5__ .1.2 | __4__ .0.0 | 🚫 Fatal error |
2016-09-10 00:36:09 +02:00
2016-11-18 18:30:43 +01:00
## Questions? Problems? Suggestions?
2014-09-19 00:41:08 +02:00
2019-10-29 20:37:52 +01:00
- If you've found a bug or want to request a feature, please create a [GitHub Issue ](https://github.com/elastic/kibana/issues/new/choose ).
Please check to make sure someone else hasn't already created an issue for the same topic.
2016-11-18 18:30:43 +01:00
- Need help using Kibana? Ask away on our [Kibana Discuss Forum ](https://discuss.elastic.co/c/kibana ) and a fellow community member or
2017-11-21 23:18:42 +01:00
Elastic engineer will be glad to help you out.