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。