|
|
@@ -1,41 +1,45 @@
|
|
|
# What is Kibana?
|
|
|
|
|
|
-Kibana is an open source data visualization plugin for Elasticsearch. It provides visualization capabilities on top of the content indexed on an Elasticsearch cluster. Users can create bar, line and scatter plots, or pie charts and maps on top of large volumes of data.
|
|
|
+Kibana is an open source analytics and visualization platform designed to work with Elasticsearch. You use Kibana to search, view, and interact with data stored in Elasticsearch indices. You can easily perform advanced data analysis and visualize your data in a variety of charts, tables, and maps.
|
|
|
|
|
|
-Kibana is a registered trademark of Elasticsearch BV.
|
|
|
-
|
|
|
-> [wikipedia.org/wiki/Kibana](https://en.wikipedia.org/wiki/Kibana)
|
|
|
+> For more information about Kibana, please visit [www.elastic.co/products/kibana](https://www.elastic.co/products/kibana)
|
|
|
|
|
|
%%LOGO%%
|
|
|
|
|
|
+# About This Image
|
|
|
+
|
|
|
+This default distribution is governed by the Elastic License, and includes the [full set of free features](https://www.elastic.co/subscriptions).
|
|
|
+
|
|
|
+View the detailed release notes [here](https://www.elastic.co/guide/en/kibana/current/release-notes.html).
|
|
|
+
|
|
|
+Not the version you're looking for? View all supported [past releases](https://www.docker.elastic.co).
|
|
|
+
|
|
|
# How to use this image
|
|
|
|
|
|
-You can run the default `%%REPO%%` command simply:
|
|
|
+**Note:** Pulling an images requires using a specific version number tag. The `latest` tag is not supported.
|
|
|
|
|
|
-```console
|
|
|
-$ docker run --link some-elasticsearch:elasticsearch -d %%REPO%%
|
|
|
-```
|
|
|
+For Kibana versions prior to 6.4.0 a full list of images, tags, and documentation can be found at [docker.elastic.co](https://www.docker.elastic.co/).
|
|
|
|
|
|
-You can also pass in additional flags to `%%REPO%%`:
|
|
|
+For full Kibana documentation see [here](https://www.elastic.co/guide/en/kibana/index.html).
|
|
|
|
|
|
-```console
|
|
|
-$ docker run --link some-elasticsearch:elasticsearch -d %%REPO%% --plugins /somewhere/else
|
|
|
-```
|
|
|
+## Running in Development Mode
|
|
|
|
|
|
-This image includes `EXPOSE 5601` ([default `port`](https://www.elastic.co/guide/en/kibana/5.2/settings.html)). If you'd like to be able to access the instance from the host without the container's IP, standard port mappings can be used:
|
|
|
+In the given example, Kibana will a attach to a user defined network (useful for connecting to other services (e.g. Elasticsearch)). If network has not yet been created, this can be done with the following command:
|
|
|
|
|
|
```console
|
|
|
-$ docker run --name some-%%REPO%% --link some-elasticsearch:elasticsearch -p 5601:5601 -d %%REPO%%
|
|
|
+$ docker network create somenetwork
|
|
|
```
|
|
|
|
|
|
-You can also provide the address of elasticsearch via `ELASTICSEARCH_URL` environnement variable:
|
|
|
+*Note: In this example, Kibana is using the default configuration and expects to connect to a running Elasticsearch instance at http://localhost:9200*
|
|
|
+
|
|
|
+Run Kibana
|
|
|
|
|
|
```console
|
|
|
-$ docker run --name some-kibana -e ELASTICSEARCH_URL=http://some-elasticsearch:9200 -p 5601:5601 -d kibana
|
|
|
+$ docker run -d --name kibana --net somenetwork -p 5601:5601 kibana:tag
|
|
|
```
|
|
|
|
|
|
-Then, access it via `http://localhost:5601` or `http://host-ip:5601` in a browser.
|
|
|
+Kibana can be accessed by browser via `http://localhost:5601` or `http://host-ip:5601`
|
|
|
|
|
|
-## %%STACK%%
|
|
|
+## Running in Production Mode
|
|
|
|
|
|
-Run `docker stack deploy -c stack.yml %%REPO%%` (or `docker-compose -f stack.yml up`), wait for it to initialize completely, and visit `http://swarm-ip:5601`, `http://localhost:5601`, or `http://host-ip:5601` (as appropriate).
|
|
|
+For additional information on running and configuring Kibana on Docker, see [Running Kibana on Docker](https://www.elastic.co/guide/en/kibana/current/docker.html)
|
Tianon Gravi