读：本文主要讨论如何在 Window 环境下构建 Logstash Java Output 插件的方式，并在服务器上安装和使用。

Gradle 安装

由于 Logstash 项目都是基于 Gradle 进行管理，所以我们需先在本地安装Gradle，详细步骤如下：

1、从 Gradle 官网下载 Gradle，官网提供了 binary-only（编译后版本） 和 complete（包括doc和源码） 两种版本，这里我们选择 binary-only 版本。

2、将下载下来 Gradle 压缩包进行解压

3、配置环境变量

• 新建系统环境 “GRADLE_HOME”，值为 D:\Program Files\gradle\gradle-6.7.1
• 修改path变量，在后面添加 %GRADLE_HOME%\bin;

4、在cmd命令里输入gradle -v如果能打出版本号，说明环境配置完毕

5、gradle下载的jar包仓库默认是在 C:\Users\Administrator\.gradle 目录下，我们可另建一个 D:\.gradle 作为仓库。

Logstash 编译生成 logstash-core-x.y.z.jar

由于插件 API 是 Logstash 代码库的一部分，依赖于 logstash-core-x.y.z.jar ，所以我们需要拉取 Logstash 项目并进行编译生成 logstash-core-x.y.z.jar 。

1、Logstash 代码拉取

// Logstash GitHub 地址，如果拉取速度较慢，可以借助gitee同步github，本地再从gitee拉取
https://github.com/elastic/logstash

2、配置 Gradle

打开IDEA file->setting->Build,Execution,Deployment->Build Tools -> Gradle，两处地方设置。

3、在项目的根目录下执行 gradlew assemble 进行编译，编译完成之后在 G:\github\logstash\logstash-core\build\libs 目录下会生成 logstash-core-8.0.0.jar

编译、构建和安装 Output 插件

1、拉取 logstash-output-java_output_example，并在 IDEA 中配置好 Gradle、JDK等。

// 官网提供的 logstash-output-java_output_example 地址
https://github.com/logstash-plugins/logstash-output-java_output_example

2、在该项目的根目录下创建一个 gradle.properties 文件，写入以下内容（这里的 <target_folder> 替换为 Logstash 项目根目录路径）

LOGSTASH_CORE_PATH=<target_folder>/logstash-core 

3、编译、构建 Output 插件

执行以下命令将Java 插件将被打包为 Ruby gems，根据官方文档描述：window 中使用 gradlew.bat 代替 ./gradlew。

gradlew.bat gem

如果出现下图的异常，可参考 paul.devereux 的解决方案：修改 build.gradle 文件 102 行处，增加 ()。

构建成功后在项目根目录下会生成 gem 文件

4、安装插件

在部署了 Logstash 的服务器上创建 $LOGSTASH_HOME/plugin 文件夹（$LOGSTASH_HOME 为你所安装的logstash路径），将生成的 gem 上传到该目录中。之后在 $LOGSTASH_HOME/bin 目录下执行以下命令安装插件。

./logstash-plugin install --no-verify --local $LOGSTASH_HOME/plugin/logstash-output-java_output_example-1.0.1.gem

安装成功后查看插件列表

./logstash-plugin list 

使用插件

// $LOGSTASH_HOME/config/ 目录下复制模板文件
cp logstash-sample.conf logstash-test.conf
// 编辑
vim  logstash-test.conf

写入以下内容

input {
  generator { message=> "Hello world!" count=> 10 }
}
output {
  java_output_example {}
}

在bin 目录执行

./logstash -f  $LOGSTASH_HOME/config/logstash-test.conf

输出结果

最后

以上便是将官方提供了简单java-outup插件进行编译构建和安装，并使用的流程步骤。基于此，我们可以通过参考官方文档关于该 demo 的详细讲解，并根据自身实际情况构建出符合需求的插件使用。

// 官网 how to write a Java output plungin 文档
https://www.elastic.co/guide/en/logstash/7.x/java-output-plugin.html#_package_and_deploy_4

感谢您的阅读，如果喜欢本文欢迎关注和转发，本头条号将坚持持续分享IT技术知识。对于文章内容有其他想法或意见建议等，欢迎提出共同讨论共同进步。