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。