Repository: elastic/kibana
Stars: 21045
README.md
Kibana
Kibana is the open source interface to query, analyze, visualize, and manage your data stored in Elasticsearch.
- Getting Started
- Using a Kibana Release
- Building and Running Kibana, and/or Contributing Code
- Documentation
- Version Compatibility with Elasticsearch
- Questions? Problems? Suggestions?
Getting Started
If you just want to try Kibana out, check out the Elastic Stack Getting Started Page to give it a whirl.
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.
Using a Kibana Release
If you want to use a Kibana release in production, give it a test run, or just play around:
- Download the latest version on the Kibana Download Page.
- Learn more about Kibana's features and capabilities on the
Kibana Product Page.
- We also offer a hosted version of Kibana on our
Cloud Service.
Building and Running Kibana, and/or Contributing Code
You might want to build Kibana locally to contribute some code, test out the latest features, or try
out an open PR:
- CONTRIBUTING.md will help you get Kibana up and running.
- If you would like to contribute code, please follow our STYLEGUIDE.mdx.
- For all other questions, check out the FAQ.md.
Documentation
Visit Elastic.co for the full Kibana documentation.
For information about building the documentation, see the README in elastic/docs.
Version Compatibility with Elasticsearch
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. | 7.15.1 | 7.15.1 | 💚 OK |
| ES patch number is newer. | 7.15.__0__ | 7.15.__1__ | ⚠️ Logged warning |
| ES minor number is newer. | 7.__14__.2 | 7.__15__.0 | ⚠️ Logged warning |
| ES major number is newer. | __7__.15.1 | __8__.0.0 | 🚫 Fatal error |
| ES patch number is older. | 7.15.__1__ | 7.15.__0__ | ⚠️ Logged warning |
| ES minor number is older. | 7.__15__.1 | 7.__14__.2 | 🚫 Fatal error |
| ES major number is older. | __8__.0.0 | __7__.15.1 | 🚫 Fatal error |
Questions? Problems? Suggestions?
- If you've found a bug or want to request a feature, please create a GitHub Issue.
Please check to make sure someone else hasn't already created an issue for the same topic.
- Need help using Kibana? Ask away on our Kibana Discuss Forum and a fellow community member or
Elastic engineer will be glad to help you out.