2015-09-15 05:36:47 +02:00
|
|
|
[[kibana-plugins]]
|
2016-04-05 01:38:09 +02:00
|
|
|
== Kibana Plugins
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
Add-on functionality for Kibana is implemented with plug-in modules. You can use the `bin/kibana-plugin`
|
|
|
|
command to manage these modules. You can also install a plugin manually by moving the plugin file to the
|
|
|
|
`plugins` directory and unpacking the plugin files into a new directory.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2016-03-23 17:29:17 +01:00
|
|
|
A list of existing Kibana plugins is available on https://github.com/elastic/kibana/wiki/Known-Plugins[GitHub].
|
|
|
|
|
2015-09-15 05:36:47 +02:00
|
|
|
[float]
|
|
|
|
=== Installing Plugins
|
|
|
|
|
|
|
|
Use the following command to install a plugin:
|
|
|
|
|
|
|
|
[source,shell]
|
2016-04-05 01:38:09 +02:00
|
|
|
bin/kibana-plugin install <package name or URL>
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2016-04-05 01:38:09 +02:00
|
|
|
When you specify a plugin name without a URL, the plugin tool attempts to download the plugin from `download.elastic.co`.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2015-09-17 02:21:46 +02:00
|
|
|
[float]
|
2016-04-02 20:36:04 +02:00
|
|
|
==== Installing Plugins from an Arbitrary URL
|
2015-09-17 02:21:46 +02:00
|
|
|
|
2016-04-05 01:38:09 +02:00
|
|
|
You can specify a URL to a specific plugin, as in the following example:
|
2015-09-17 02:21:46 +02:00
|
|
|
|
|
|
|
[source,shell]
|
2016-04-05 01:38:09 +02:00
|
|
|
$ bin/kibana-plugin install https://download.elastic.co/kibana/x-pack/x-pack-5.0.0-snapshot.zip
|
|
|
|
Attempting to transfer from https://download.elastic.co/kibana/x-pack//x-pack-5.0.0-snapshot.zip
|
|
|
|
Transferring <some number> bytes....................
|
|
|
|
Transfer complete
|
|
|
|
Retrieving metadata from plugin archive
|
|
|
|
Extracting plugin archive
|
2015-09-17 02:21:46 +02:00
|
|
|
Extraction complete
|
|
|
|
Optimizing and caching browser bundles...
|
|
|
|
Plugin installation complete
|
|
|
|
|
2015-09-19 00:24:30 +02:00
|
|
|
You can specify URLs that use the HTTP, HTTPS, or `file` protocols.
|
|
|
|
|
2015-09-17 02:21:46 +02:00
|
|
|
[float]
|
|
|
|
=== Installing Plugins to an Arbitrary Directory
|
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
Use the `-d` or `--plugin-dir` option after the `install` command to specify a directory for plugins, as in the following
|
2016-04-02 20:36:04 +02:00
|
|
|
example:
|
2015-09-17 02:21:46 +02:00
|
|
|
|
|
|
|
[source,shell]
|
2016-04-05 01:38:09 +02:00
|
|
|
$ bin/kibana-plugin install file:///some/local/path/x-pack.zip -d path/to/directory
|
2015-09-17 02:21:46 +02:00
|
|
|
Installing sample-plugin
|
2016-04-05 01:38:09 +02:00
|
|
|
Attempting to transfer from file:///some/local/path/x-pack.zip
|
|
|
|
Transferring <some number> bytes....................
|
|
|
|
Transfer complete
|
|
|
|
Retrieving metadata from plugin archive
|
|
|
|
Extracting plugin archive
|
2015-09-17 02:21:46 +02:00
|
|
|
Extraction complete
|
|
|
|
Optimizing and caching browser bundles...
|
|
|
|
Plugin installation complete
|
|
|
|
|
|
|
|
NOTE: This command creates the specified directory if it does not already exist.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Removing Plugins
|
|
|
|
|
2016-04-02 20:36:04 +02:00
|
|
|
Use the `remove` command to remove a plugin, including any configuration information, as in the following example:
|
2015-09-15 05:36:47 +02:00
|
|
|
|
|
|
|
[source,shell]
|
2016-04-05 01:38:09 +02:00
|
|
|
$ bin/kibana-plugin remove timelion
|
2015-09-19 00:54:49 +02:00
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
You can also remove a plugin manually by deleting the plugin's subdirectory under the `plugins/` directory.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2016-03-08 02:37:29 +01:00
|
|
|
[float]
|
|
|
|
=== Listing Installed Plugins
|
|
|
|
|
2016-04-02 20:36:04 +02:00
|
|
|
Use the `list` command to list the currently installed plugins.
|
2016-03-08 02:37:29 +01:00
|
|
|
|
2015-09-18 23:56:24 +02:00
|
|
|
[float]
|
|
|
|
=== Updating Plugins
|
|
|
|
|
|
|
|
To update a plugin, remove the current version and reinstall the plugin.
|
|
|
|
|
2015-09-15 05:36:47 +02:00
|
|
|
[float]
|
|
|
|
=== Configuring the Plugin Manager
|
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
By default, the plugin manager provides you with feedback on the status of the activity you've asked the plugin manager
|
|
|
|
to perform. You can control the level of feedback for the `install` and `remove` commands with the `--quiet` and
|
|
|
|
`--silent` options. Use the `--quiet` option to suppress all non-error output. Use the `--silent` option to suppress all
|
2016-04-02 20:36:04 +02:00
|
|
|
output.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
2016-04-02 20:36:04 +02:00
|
|
|
By default, plugin manager installation requests do not time out. Use the `--timeout` option, followed by a time, to
|
|
|
|
change this behavior, as in the following examples:
|
2015-09-15 05:36:47 +02:00
|
|
|
|
|
|
|
[source,shell]
|
|
|
|
.Waits for 30 seconds before failing
|
2016-07-06 00:16:33 +02:00
|
|
|
bin/kibana-plugin install --timeout 30s sample-plugin
|
2015-09-15 05:36:47 +02:00
|
|
|
|
|
|
|
[source,shell]
|
|
|
|
.Waits for 1 minute before failing
|
2016-07-06 00:16:33 +02:00
|
|
|
bin/kibana-plugin install --timeout 1m sample-plugin
|
2015-09-17 02:21:46 +02:00
|
|
|
|
2015-09-18 00:36:31 +02:00
|
|
|
[float]
|
2015-09-17 02:21:46 +02:00
|
|
|
==== Plugins and Custom Kibana Configurations
|
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
Use the `-c` or `--config` options with the `install` and `remove` commands to specify the path to the configuration file
|
|
|
|
used to start Kibana. By default, Kibana uses the configuration file `config/kibana.yml`. When you change your installed
|
|
|
|
plugins, the `bin/kibana-plugin` command restarts the Kibana server. When you are using a customized configuration file,
|
2016-04-05 01:38:09 +02:00
|
|
|
you must specify the path to that configuration file each time you use the `bin/kibana-plugin` command.
|
2015-09-15 05:36:47 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Plugin Manager Exit Codes
|
|
|
|
|
|
|
|
[horizontal]
|
|
|
|
0:: Success
|
|
|
|
64:: Unknown command or incorrect option parameter
|
|
|
|
74:: I/O error
|
|
|
|
70:: Other error
|
2015-09-26 02:11:50 +02:00
|
|
|
|
2015-11-24 17:25:14 +01:00
|
|
|
[float]
|
2015-09-26 02:11:50 +02:00
|
|
|
[[plugin-switcher]]
|
|
|
|
== Switching Plugin Functionality
|
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
The Kibana UI serves as a framework that can contain several different plugins. You can switch between these
|
2016-04-02 20:36:04 +02:00
|
|
|
plugins by clicking the icons for your desired plugins in the left-hand navigation bar.
|
2015-09-26 02:11:50 +02:00
|
|
|
|
2016-04-02 20:36:04 +02:00
|
|
|
[float]
|
|
|
|
=== Disabling Plugins
|
|
|
|
|
|
|
|
Use the following command to disable a plugin:
|
|
|
|
|
|
|
|
[source,shell]
|
|
|
|
./bin/kibana --<plugin ID>.enabled=false
|
2015-09-26 02:11:50 +02:00
|
|
|
|
2016-07-06 00:16:33 +02:00
|
|
|
You can find a plugin's plugin ID as the value of the `name` property in the plugin's `package.json` file.
|