Kibana 用戶指南（安裝Kibana）

安裝Kibana

託管的Kibana

若是你正在Elastic Cloud上運行託管的Elasticsearch服務，你能夠經過單擊訪問Kibana。

本身安裝Kibana

從6.0.0版本開始，Kibana只支持64位操做系統。

Kibana提供了以下的包格式:

tar.gz/zip

• tar.gz包是在Linux和Darwin上安裝的，是開始使用Kibana的最簡單的選擇。
• zip包是唯一支持Windows的包。

deb

• deb包適合Debian、Ubuntu和其餘基於Debian的系統，Debian軟件包能夠從Elastic網站或咱們的Debian存儲庫下載。

rpm

• rpm包適合安裝在Red Hat、Centos、SLES、OpenSuSE和其餘基於RPM的系統上，RPM能夠從Elastic網站或RPM存儲庫下載。

docker

• 能夠運行Kibana做爲Docker容器的鏡像，能夠從Elastic Docker註冊表下載。

若是你的Elasticsearch安裝受到 X-Pack安全性的保護，請參閱 在Kibana中配置安全性以得到更多的安裝說明。

使用.tar.gz安裝Kibana

Kibana爲Linux和Darwin提供了.tar.gz包，這些包是獲取Kibana時最容易使用的格式。

這些包在Elastic許可下能夠無償使用，它們包含開放源碼和免費的商業特性，以及對付費商業特性的訪問，開始30天的體驗嘗試全部付費的商業功能，有關Elastic許可證級別的信息，請參閱訂閱頁面。

Kibana的最新穩定版本能夠在下載Kibana頁面找到，其餘版本能夠在過去的版本頁面中找到。

下載並安裝Linux 64位軟件包

如下爲下載和安裝Kibana v6.4.2的Linux歸檔：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-linux-x86_64.tar.gz
shasum -a 512 kibana-6.4.2-linux-x86_64.tar.gz 
tar -xzf kibana-6.4.2-linux-x86_64.tar.gz
cd kibana-6.4.2-linux-x86_64/

• 將shasum生產的SHA與已發佈的SHA進行比較。
• 歸檔包解壓的目錄爲$KIBANA_HOME

下載並安裝Darwin軟件包

如下爲下載和安裝Kibana v6.4.2的Darwin歸檔：

curl -O https://artifacts.elastic.co/downloads/kibana/kibana-6.3.2-darwin-x86_64.tar.gz
shasum -a 512 kibana-6.3.2-darwin-x86_64.tar.gz ①
tar -xzf kibana-6.3.2-darwin-x86_64.tar.gz
cd kibana-6.3.2-darwin-x86_64/ ②

• 將shasum生產的SHA與已發佈的SHA進行比較。
• 歸檔包解壓的目錄爲$KIBANA_HOME

或者，你能夠下載如下包，其中只包含Apache 2.0許可下可用的特性：https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.4.2-darwin-x86_64.tar.gz。

從命令行運行Kibana

以下所示爲Kibana從命令行啓動：

./bin/kibana

默認狀況下，Kibana在前臺運行，將其日誌輸出到標準輸出（stdout），能夠按Ctrl-C中止。

經過配置文件配置Kibana

Kibana默認從$KIBANA_HOME/config/kibana.yml文件加載它的配置，配置文件的格式在配置Kibana中進行了說明。

.tar.gz歸檔的目錄結構

.tar.gz包是徹底獨立的，默認狀況下，全部文件和目錄都包含在$KIBANA_HOME中 - 在解壓歸檔文件時建立的目錄。

這很是方便，由於你沒必要建立任何目錄來開始使用Kibana，卸載Kibana就像刪除$KIBANA_HOME目錄同樣簡單。可是，建議更改配置和數據目錄的默認位置，以便之後不刪除重要數據。

類型	描述	默認位置
home	Kibana主目錄或$KIBANA_HOME	解壓歸檔建立的目錄
bin	包括kibana在內的啓動kibana服務和kibana-plugin來安裝插件的二進制腳本	$KIBANA_HOME\bin
config	包括kibana.yml的配置文件	$KIBANA_HOME\config
data	由Kibana和它的插件寫入磁盤的數據文件的位置	$KIBANA_HOME\data
optimize	Transpiled源碼，某些管理操做（例如插件安裝）會致使源碼被從新傳輸	$KIBANA_HOME\optimize
plugins	插件文件的位置，每一個插件包含在一個子目錄中	$KIBANA_HOME\plugins

使用Debian軟件包安裝Kibana

Kibana的Debian軟件包能夠從咱們的網站或APT庫下載，它能夠用於在任何基於Debian的系統上安裝Kibana，好比Debian和Ubuntu。

此包在Elastic許可下無償使用，它包含開放源碼和免費的商業特性，以及對付費商業特性的訪問，開始30天的體驗嘗試全部付費的商業功能，有關Elastic許可證級別的信息，請參閱訂閱頁面。

最新的穩定版Kibana能夠在下載Kibana頁面找到，其餘版本能夠在過去的發行版頁面中找到。

導入Elastic PGP密鑰

咱們用帶指紋的Elastic簽名密鑰（PGP密鑰D88E42B4，可從https://pgp.mit.edu得到）在全部的包上簽名：

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

下載並安裝公開簽名密鑰：

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

從APT存儲庫安裝

在繼續以前，你可能須要在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

不要使用 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條目，安裝工做將應該與預期的同樣。

你可使用Kibana Debian軟件包進行安裝：

sudo apt-get update && sudo apt-get install kibana

若是同一個Kibana存儲庫有兩個條目，那麼在 apt-get update期間，你將看到相似的錯誤：

Duplicate sources.list entry https://artifacts.elastic.co/packages/6.x/apt/ ...`

檢查/etc/apt/sources.list.d/kibana-6.x.list的重複條目或在/etc/apt/sources.list.d/和/etc/apt/sources.list文件中的文件中找到重複條目。

手動下載並安裝Debian軟件包

Kibana v6.4.2的Debian軟件包能夠從網站上下載並安裝以下：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-amd64.deb
shasum -a 512 kibana-6.4.2-amd64.deb 
sudo dpkg -i kibana-6.4.2-amd64.deb

將shasum生產的SHA與已發佈的SHA進行比較。

或者，你能夠下載如下包，其中只包含Apache 2.0許可下可用的特性：https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.4.2-amd64.deb。

SysV init和systemd

Kibana安裝後不會自動啓動，如何啓動和中止Kibana取決於系統是使用SysV init仍是systemd（用於更新的發行版），你能夠經過運行這個命令來判斷使用的是哪一個：

ps -p 1

使用SysV init運行Kibana

使用update-rc.d命令在系統啓動時將Kibana配置爲自動啓動：

sudo update-rc.d kibana defaults 95 10

你可使用service命令啓動和中止Kibana：

sudo -i service kibana start
sudo -i service kibana stop

若是Kibana由於任何緣由不能啓動，它將打印出失敗的緣由到STDOUT，日誌文件能夠在/var/log/kibana/中找到。

使用systemd運行Kibana

要配置Kibana在系統啓動時自動啓動，請運行如下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.service

Kibana的啓動和中止以下所示：

sudo systemctl start kibana.service
sudo systemctl stop kibana.service

這些命令沒有提供關於Kibana是否成功啓動的反饋，相反，這些信息將被寫入位於/var/log/kibana/的日誌文件中。

經過配置文件配置Kibana

Kibana默認從/etc/kibana/kibana.yml加載它的配置，配置文件的格式在配置Kibana中進行了說明。

Debian軟件包的目錄結構

Debian軟件包將配置文件、日誌和數據目錄放置在基於debian的系統的適當位置：

類型	描述	默認位置	設置
home	Kibana主目錄或$KIBANA_HOME	/usr/share/kibana
bin	包括kibana在內的啓動kibana服務和kibana-plugin來安裝插件的二進制腳本	/usr/share/kibana/bin
config	包括kibana.yml的配置文件	/etc/kibana
data	由Kibana和它的插件寫入磁盤的數據文件的位置	/var/lib/kibana	path.data
optimize	Transpiled源碼，某些管理操做（例如插件安裝）會致使源碼被從新傳輸	/usr/share/kibana/optimize
plugins	插件文件的位置，每一個插件包含在一個子目錄中	/usr/share/kibana/plugins

使用RPM安裝Kibana

Kibana的RPM能夠從咱們的網站或RPM存儲庫中下載，它能夠用於在任何基於RPM的系統上安裝Kibana，如OpenSuSE、SLES、Centos、Red Hat和Oracle Enterprise。

舊版本的RPM不支持RPM安裝，好比SLES 11和CentOS 5，請參照使用 .tar.gz安裝Kibana替代。

此包在Elastic許可下無償使用，它包含開放源碼和免費的商業特性，以及對付費商業特性的訪問，開始30天的體驗嘗試全部付費的商業功能，有關Elastic許可證級別的信息，請參閱訂閱頁面。

最新的穩定版Kibana能夠在下載Kibana頁面找到，其餘版本能夠在過去的發行版頁面中找到。

咱們用帶指紋的Elastic簽名密鑰（PGP密鑰D88E42B4，可從https://pgp.mit.edu得到）在全部的包裹上簽名：

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

下載並安裝公開簽名密鑰：

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

從RPM存儲庫安裝

在/etc/yum.repos.d/目錄建立一個kibana.repo的文件用於基於RedHat的發行版，或者在/etc/zypp/repos.d/目錄，用於基於OpenSuSE的發行版，包括：

[kibana-6.x]
name=Kibana 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

你的存儲庫已經準備好使用了，如今可使用如下命令之一安裝Kibana：

sudo yum install kibana 
sudo dnf install kibana 
sudo zypper install kibana

• 在CentOS和Red Hat舊的發行版使用yum
• 在Fedora和其餘新的Red Hat發行版上使用dnf
• 在基於OpenSUSE的發行版上使用zypper

手動下載並安裝RPM

Kibana v6.4.2的RPM能夠從網站下載並安裝以下：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-x86_64.rpm
shasum -a 512 kibana-6.4.2-x86_64.rpm 
sudo rpm --install kibana-6.4.2-x86_64.rpm

將shasum生產的SHA與已發佈的SHA進行比較。

或者，你能夠下載如下包，其中只包含Apache 2.0許可下可用的特性：https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.4.2-x86_64.rpm。

SysV init和systemd

Kibana安裝後不會自動啓動，如何啓動和中止Kibana取決於系統是使用SysV init仍是systemd（用於更新的發行版），你能夠經過運行這個命令來判斷使用的是哪一個：

ps -p 1

使用SysV init運行Kibana

使用chkconfig命令將Kibana配置爲在系統啓動時自動啓動：

sudo chkconfig --add kibana

你可使用service命令啓動和中止Kibana：

sudo -i service kibana start
sudo -i service kibana stop

若是Kibana因爲任何緣由沒法啓動，它將打印出失敗的緣由到STDOUT，日誌文件能夠在/var/log/kibana/中找到。

使用systemd運行Kibana

要配置Kibana在系統啓動時自動啓動，請運行如下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.service

Kibana的啓動和中止以下所示：

sudo systemctl start kibana.service
sudo systemctl stop kibana.service

這些命令沒有提供關於Kibana是否成功啓動的反饋，相反，這些信息將被寫入位於/var/log/kibana/的日誌文件中。

經過配置文件配置Kibana

Kibana默認從/etc/kibana/kibana.yml加載它的配置，配置文件的格式在配置Kibana中進行了說明。

RPM軟件包的目錄結構

RPM將配置文件、日誌和數據目錄放在基於RPM的系統的適當位置：

類型	描述	默認位置	設置
home	Kibana主目錄或$KIBANA_HOME	/usr/share/kibana
bin	包括kibana在內的啓動kibana服務和kibana-plugin來安裝插件的二進制腳本	/usr/share/kibana/bin
config	包括kibana.yml的配置文件	/etc/kibana
data	由Kibana和它的插件寫入磁盤的數據文件的位置	/var/lib/kibana	path.data
optimize	Transpiled源碼，某些管理操做（例如插件安裝）會致使源碼被從新傳輸	/usr/share/kibana/optimize
plugins	插件文件的位置，每一個插件包含在一個子目錄中	/usr/share/kibana/plugins

在Windows上安裝Kibana

Kibana可使用.zip包安裝在Windows上。

此包在Elastic許可下無償使用，它包含開放源碼和免費的商業特性，以及對付費商業特性的訪問，開始30天的體驗嘗試全部付費的商業功能，有關Elastic許可證級別的信息，請參閱訂閱頁面。

最新的穩定版Kibana能夠在下載Kibana頁面找到，其餘版本能夠在過去的發行版頁面中找到。

下載並安裝.zip包

下載Kibana v6.4.2的.zip windows歸檔：https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-windows-x86_64.zip。

用你最喜歡的解壓工具解壓它，這將建立一個名爲kibana-6.4.2-windows-x86_64的文件夾，咱們將其稱爲$KIBANA_HOME，例如，在終端窗口中，CD到$KIBANA_HOME目錄：

CD c:\kibana-6.4.2-windows-x86_64

或者，你能夠下載如下包，其中只包含Apache 2.0許可下可用的特性：https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.4.2-windows-x86_64.zip。

從命令行運行Kibana

能夠從命令行啓動Kibana，以下所示：

.\bin\kibana.bat

默認狀況下，Kibana在前臺運行，將其日誌打印到STDOUT，並能夠經過按Ctrl-C中止。

經過配置文件配置Kibana

Kibana默認從$KIBANA_HOME/config/kibana.yml加載它的配置，配置文件的格式在配置Kibana中進行了說明。

.zip歸檔文件的目錄結構

.zip包是徹底獨立的，默認狀況下，全部文件和目錄都包含在$KIBANA_HOME中 - 在解壓歸檔文件時建立的目錄。

這很是方便，由於你沒必要建立任何目錄來開始使用Kibana，卸載Kibana就像刪除$KIBANA_HOME目錄同樣簡單。可是，建議更改配置和數據目錄的默認位置，以便之後不刪除重要數據。

類型	描述	默認位置
home	Kibana主目錄或$KIBANA_HOME	解壓歸檔建立的目錄
bin	包括kibana在內的啓動kibana服務和kibana-plugin來安裝插件的二進制腳本	$KIBANA_HOME\bin
config	包括kibana.yml的配置文件	$KIBANA_HOME\config
data	由Kibana和它的插件寫入磁盤的數據文件的位置	$KIBANA_HOME\data
optimize	Transpiled源碼，某些管理操做（例如插件安裝）會致使源碼被從新傳輸	$KIBANA_HOME\optimize
plugins	插件文件的位置，每一個插件包含在一個子目錄中	$KIBANA_HOME\plugins

---

上一篇：目錄

下一篇：啓動和中止Kibana