Standalone Kibana plugin install

If you don’t want to use the all-in-one Open Distro for Elasticsearch installation options, you can install the security, alerting, and Index State Management plugins for Kibana individually.

Table of contents

1. Plugin compatibility
2. Prerequisites
3. Install
4. List installed plugins
5. Remove plugins
6. Update plugins

Plugin compatibility

opendistro-anomaly-detection-kibana    1.10.1.0, 1.11.0.0
opendistro_alerting-kibana             1.10.1.1, 1.11.0.2
opendistro_index_management-kibana     1.10.1.0, 1.11.0.0
opendistro_security_kibana             1.10.1.1, 1.11.0.0
opendistro-query-workbench             1.11.0.0
opendistro-notebooks-kibana            1.11.0.0

opendistro-anomaly-detection-kibana    1.9.0.0
opendistro_alerting-kibana             1.9.0.0
opendistro_index_management-kibana     1.9.0.0
opendistro_security_kibana             1.9.0.0
opendistro_sql_workbench               1.9.0.0

Prerequisites

• An Elasticsearch cluster that uses a compatible version
• The corresponding Elasticsearch plugins installed on the cluster
• The corresponding version of Kibana (e.g. Kibana 6.7.1 works with Elasticsearch 6.7.1)

Install

Navigate to the Kibana home directory (likely /usr/share/kibana) and run the install command for each plugin.

Security Kibana

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-security/opendistro_security_kibana_plugin-1.11.0.0.zip

This plugin provides a user interface for managing users, roles, mappings, action groups, and tenants.

Alerting Kibana

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-alerting/opendistro-alerting-1.11.0.2.zip

This plugin provides a user interface for creating monitors and managing alerts.

Index State Management Kibana

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-index-management/opendistro_index_management_kibana-1.11.0.0.zip

This plugin provides a user interface for managing policies.

Anomaly Detection Kibana

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-anomaly-detection/opendistro-anomaly-detection-kibana-1.11.0.0.zip

This plugin provides a user interface for adding detectors.

Query Workbench

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-query-workbench/opendistro-query-workbench-1.11.0.0.zip

This plugin provides a user interface for using SQL queries to explore your data.

Kibana Notebooks

sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-notebooks/opendistro-notebooks-kibana-1.11.0.0.zip

This plugin lets you combine Kibana visualizations and narrative text in a single interface.

List installed plugins

To check your installed plugins:

sudo bin/kibana-plugin list

Remove plugins

sudo bin/kibana-plugin remove <plugin-name>

For certain plugins, you must also remove the “optimze” bundle. Here is a sample command for the Anomaly Detection plugin:

sudo rm /usr/share/kibana/optimize/bundles/opendistro-anomaly-detection-kibana.*

Then restart Kibana. After the removal of any plugin, Kibana performs an optimize operation the next time you start it. This operation takes several minutes even on fast machines, so be patient.

Update plugins

Kibana doesn’t update plugins. Instead, you have to remove the old version and its optimized bundle, reinstall them, and restart Kibana:

1. Remove the old version:

sudo bin/kibana-plugin remove <plugin-name>

1. Remove the optimized bundle:

sudo rm /usr/share/kibana/optimize/bundles/<bundle-name>

1. Reinstall the new version:

sudo bin/kibana-plugin install <plugin-name>

1. Restart Kibana.

For example, to remove and reinstall the anomaly detection plugin:

sudo bin/elasticsearch-plugin remove opendistro-anomaly-detection
sudo rm /usr/share/kibana/optimize/bundles/opendistro-anomaly-detection-kibana.*
sudo bin/kibana-plugin install <AD Kibana plugin artifact URL>
Restart Kibana.