Logstash 参考指南（安装Logstash）

安装Logstash

Logstash需要Java 8，不支持Java 9，使用官方Oracle发行版或开源发行版，如OpenJDK

要检查Java版本，请运行以下命令：

java -version

在安装了Java的系统上，该命令产生的输出类似于以下内容：

java version "1.8.0_65"
Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
Java HotSpot(TM) 64-Bit Server VM (build 25.65-b01, mixed mode)

在一些Linux系统上，在尝试安装之前，你可能还需要导出JAVA_HOME环境，尤其是在从tarball中安装Java时，这是因为Logstash在安装过程中使用Java自动检测环境并安装正确的启动方法（SysV init脚本、Upstart或systemd)。如果在包安装期间，Logstash无法找到JAVA_HOME环境变量，你可能会得到一条错误消息，并且Logstash将无法正常启动。

从下载的二进制文件中安装

下载与主机环境匹配的Logstash安装文件并解压文件，不要将Logstash安装到包含冒号（:）字符的目录路径中。

这些包在Elastic许可下可以免费使用，它们包含开源和免费的商业功能以及对付费商业功能的访问，开始一个30天的试用，以尝试所有付费的商业功能，有关Elastic许可级别的信息，请参阅订阅页面。

或者你可以下载一个oss包，它只包含Apache 2.0许可下可用的特性。

在支持的Linux操作系统上，你可以使用包管理器来安装Logstash。

从包存储库安装

我们也有用于APT和YUM的发行版的存储库，注意，我们只提供二进制包，但不提供源包，因为包是作为Logstash构建的一部分创建的。

我们将Logstash包存储库按版本划分为不同的url，以避免在主要版本之间意外升级，所有6.x.y releases使用6.x作为版本号。

我们使用PGP密钥D88E42B4，即Elastic的签名密钥，带有指纹

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

在所有的包上签名，它可以从https://pgp.mit.edu获得。

APT

下载并安装公开签名密钥：

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add

在进行之前，你可能需要在Debian上安装apt-transport-https软件包：

sudo apt-get install apt-transport-https

将存储库定义保存到/etc/apt/sources.list.d/elastic-6.x.list：

echo "deb https://artifacts.elastic.co/packages/6.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-6.x.list

使用上面描述的echo方法添加Logstash存储库，不要使用add-apt-repository，因为它也会添加deb-src条目，但是我们不提供源包。如果你已经添加了deb-src条目，你将会看到如下错误：

Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)

只需从/etc/apt/sources.list中删除deb-src条目文件并且安装应该按照预期工作。

运行sudo apt-get update，存储库就可以使用了，你可以这样安装：

sudo apt-get update && sudo apt-get install logstash

有关将Logstash作为系统服务的管理细节，请参阅运行Logstash。

YUM

下载并安装公开签名密钥：

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

在/etc/yum.repos.d/目录添加以下内容到.repo后缀的文件中，例如logstash.repo

[logstash-6.x]
name=Elastic repository for 6.x packages
baseurl=https://artifacts.elastic.co/packages/6.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md

你的存储库已经准备好使用了，你可以使用如下命令安装：

sudo yum install logstash

这些存储库不能与仍然使用RPM v3的旧的基于rpm的发行版使用，比如CentOS5。

有关将Logstash作为系统服务的管理细节，请参阅运行Logstash。

Docker

镜像可以作为Docker容器运行Logstash，它们可以从Elastic Docker注册表获得。

有关如何配置和运行Logstash Docker容器的详细信息，请参阅在Docker上运行Logstash。