Link Search Menu Expand Document

The Open Distro project is archived. Open Distro development has moved to OpenSearch. The Open Distro plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.

Kibana

Kibana is the default visualization tool for data in Elasticsearch. It also serves as a user interface for the Open Distro security, alerting, and Index State Management plugins.

Run Kibana using Docker

You can start Kibana using docker run after creating a Docker network and starting Elasticsearch, but the process of connecting Kibana to Elasticsearch is significantly easier with a Docker Compose file.

  1. Run docker pull amazon/opendistro-for-elasticsearch-kibana:1.13.3.

  2. Create a docker-compose.yml file appropriate for your environment. A sample file that includes Kibana is available on the Open Distro Docker installation page.

    Just like elasticsearch.yml, you can pass a custom kibana.yml to the container in the Docker Compose file.

  3. Run docker-compose up.

    Wait for the containers to start. Then see Get started with Kibana.

  4. When finished, run docker-compose down.

Run Kibana using the RPM or Debian package

  1. If you haven’t already, add the yum repositories specified in steps 1–2 in RPM or the apt repositories in steps 2–3 of Debian package.
  2. sudo yum install opendistroforelasticsearch-kibana or sudo apt install opendistroforelasticsearch-kibana
  3. Modify /etc/kibana/kibana.yml to use elasticsearch.hosts rather than elasticsearch.url.
  4. sudo systemctl start kibana.service

  5. To stop Kibana:

    sudo systemctl stop kibana.service

Configuration

To run Kibana when the system starts:

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.service

You can also modify the values in /etc/kibana/kibana.yml.

Run Kibana using the tarball

  1. Download the tarball:

    # x64
curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz -o opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz
# ARM64
curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz -o opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz

  2. Download the checksum:

    # x64
curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz.sha512 -o opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz.sha512
# ARM64
curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz.sha512 -o opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz.sha512

  3. Verify the tarball against the checksum:

    # x64
shasum -a 512 -c opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz.sha512
# ARM64
shasum -a 512 -c opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz.sha512

    On CentOS, you might not have shasum. Install this package:

    sudo yum install perl-Digest-SHA

  4. Extract the TAR file to a directory and change to that directory:

    # x64
tar -zxf opendistroforelasticsearch-kibana-1.13.3-linux-x64.tar.gz
cd opendistroforelasticsearch-kibana
# ARM64
tar -zxf opendistroforelasticsearch-kibana-1.13.3-linux-arm64.tar.gz
cd opendistroforelasticsearch-kibana

  5. If desired, modify config/kibana.yml.

  6. Run Kibana:

    ./bin/kibana

Run Kibana on Windows (ZIP)

  1. Download the ZIP.

  2. Extract the ZIP file to a directory and open that directory at the command prompt.

  3. If desired, modify config/kibana.yml.

  4. Run Kibana:

    .\bin\kibana.bat

Run Kibana on Windows (EXE)

  1. Download the EXE file, run it, and click through the steps.

  2. Open the command prompt.

  3. Navigate to the Kibana install directory.

  4. If desired, modify config/kibana.yml.

  5. Run Kibana:

    .\bin\kibana.bat

Get started with Kibana

  1. After starting Kibana, you can access it at port 5601. For example, http://localhost:5601.
  2. Log in with the default username admin and password admin.
  3. Choose Try our sample data and add the sample flight data.
  4. Choose Discover and search for a few flights.
  5. Choose Dashboard, [Flights] Global Flight Dashboard, and wait for the dashboard to load.