plugin的安装

从 logstash 1.5.0 版本开始，logstash 将所有的插件都独立拆分成 gem 包。这样，每个插件都可以独立更新，不用等待 logstash 自身做整体更新的时候才能使用了。

为了达到这个目标，logstash 配置了专门的 plugins 管理命令。

plugin 用法说明

  1. Usage:
  2.     bin/logstash-plugin [OPTIONS] SUBCOMMAND [ARG] ...
  4. Parameters:
  5.     SUBCOMMAND                    subcommand
  6.     [ARG] ...                     subcommand arguments
  8. Subcommands:
  9.     install                       Install a plugin
  10.     uninstall                     Uninstall a plugin
  11.     update                        Install a plugin
  12.     list                          List all installed plugins
  14. Options:
  15.     -h, --help                    print help

示例

首先，你可以通过 bin/logstash-plugin list 查看本机现在有多少插件可用。(其实就在 vendor/bundle/jruby/1.9/gems/ 目录下)

然后，假如你看到 https://github.com/logstash-plugins/ 下新发布了一个 logstash-output-webhdfs 模块(当然目前还没有)。打算试试，就只需要运行：

  1. bin/logstash-plugin install logstash-output-webhdfs

就可以了。

同样，假如是升级，只需要运行：

  1. bin/logstash-plugin update logstash-input-tcp

即可。

本地插件安装

bin/logstash-plugin 不单可以通过 rubygems 平台安装插件，还可以读取本地路径的 gem 文件。这对自定义插件或者无外接网络的环境都非常有效：

  1. bin/logstash-plugin install /path/to/logstash-filter-crash.gem

执行成功以后。你会发现，logstash-5.0.0 目录下的 Gemfile 文件最后会多出一段内容：

  1. gem "logstash-filter-crash", "1.1.0", :path => "vendor/local_gems/d354312c/logstash-filter-mweibocrash-1.1.0"

同时 Gemfile.jruby-1.9.lock 文件开头也会多出一段内容：

  1. PATH
  2.   remote: vendor/local_gems/d354312c/logstash-filter-crash-1.1.0
  3.   specs:
  4.     logstash-filter-crash (1.1.0)
  5.       logstash-core (>= 1.4.0, < 2.0.0)