Logstash 技术文档

1. 安装指南

系统要求

• 安装 JDK 版本 11 或 17，并确保设置 JAVA_HOME 环境变量指向 JDK 安装目录。
• 安装 JRuby 9.2.x，建议使用 Ruby 版本管理器，如 RVM 或 rbenv。
• 使用 gem install rake 和 gem install bundler 命令安装 rake 和 bundler 工具。

安装步骤

1. 克隆 Logstash 项目仓库。
2. 设置环境变量 OSS 为 true 以仅使用开源代码。
3. 使用 gradle 安装开发依赖和默认插件。

export OSS=true
./gradlew installDevelopmentGems
./gradlew installDefaultGems

4. 验证安装，运行以下命令启动 Logstash 并发送第一个事件。

bin/logstash -e 'input { stdin { } } output { stdout {} }'

输入 hello world 应该会看到以下输出：

hello world
2016-11-11T01:22:14.405+0000 0.0.0.0 hello world

2. 项目的使用说明

Logstash 是一个服务器端数据处理管道，它可以同时从多个数据源中摄入数据，进行转换，然后将其发送到您喜欢的存储系统中。Logstash 拥有超过 200 个插件，并且您可以非常容易地编写自己的插件。

• 更多信息，请查阅 Logstash 官方文档。
• 下载官方发布的 Logstash 二进制文件或其他支持平台的 debian/rpm 包，请访问 下载页面。

3. 项目API使用文档

Logstash 的 API 使用文档可以在官方文档中找到。由于文档内容与用户问题无关，这里不提供具体链接。

4. 项目安装方式

Logstash 支持多种安装方式：

• 使用 gradlew 命令构建和安装 Logstash。

./gradlew assembleTarDistribution
./gradlew assembleZipDistribution

• 使用 rake 命令构建 RPM 和 DEB 包。

rake artifact:rpm
rake artifact:deb

• 通过设置 custom.jruby.path Gradle 属性使用自定义 JRuby 分发。

./gradlew clean test -Pcustom.jruby.path="/path/to/jruby"

以上是 Logstash 技术文档的概览，具体使用和配置细节请参考官方文档和项目 Wiki。