簡介

Kibana是一個開源分析和視覺化平臺，旨在與Elasticsearch協同工作。您使用Kibana搜尋，檢視和與儲存在Elasticsearch索引中的資料進行互動。您可以輕鬆地執行高階資料分析，並在各種圖表，表格和地圖中視覺化您的資料。

Kibana使您可以輕鬆理解大量資料。其簡單的基於瀏覽器的介面使您能夠快速建立和共享動態儀表板，實時顯示Elasticsearch查詢的更改。

設定Kibana非常容易。您可以安裝Kibana並在幾分鐘內開始探索您的Elasticsearch索引 - 無需程式碼，無需額外的基礎架構。

安裝Kibana

本節包含有關如何設定Kibana並使其執行的資訊，包括：

• 下載
• 安裝
• 開始
• 配置
• 升級

支援的平臺

針對Linux，Darwin和Windows提供並測試了Kibana軟體包。由於Kibana在Node.js上執行，我們為這些平臺包含了必要的Node.js二進位制檔案。不支援針對單獨維護的Node.js版本執行Kibana。

Elasticsearch版本

應將Kibana和Elasticsearch配置為相同版本的，這是官方推薦的配置。

不支援Kibana和Elasticsearch執行在不同主要版本（例如Kibana 5.x和Elasticsearch 2.x），也不支援比Elasticsearch版本更新的Kibana次要版本（例如Kibana 5.1和Elasticsearch 5.0）。

執行高於Kibana的次要版本的Elasticsearch通常可以用於促進首先升級Elasticsearch的升級過程（例如Kibana 5.0和Elasticsearch 5.1）。在此配置中，將在Kibana伺服器啟動時記錄警告，因此在Kibana升級到與Elasticsearch相同的版本之前，它只是暫時的。

通常支援Kibana和Elasticsearch執行在不同補丁版本（例如Kibana 5.0.0和Elasticsearch 5.0.1），但我們鼓勵使用者將Kibana和Elasticsearch執行在相同的版本和補丁版本。

安裝Kibana

如果您 在Elastic Cloud上執行我們託管的Elasticsearch Service，只需單擊一下即可訪問Kibana。

自己安裝Kibana

從V6.0.0開始，Kibana僅支援64位作業系統。

Kibana提供以下格式的安裝包：

tar.gz/zip	這些tar.gz軟體包可以在Linux和Darwin上安裝，是開始使用Kibana的最簡單方法。zip程式包是Windows唯一支援的程式包。 .tar.gz包安裝Kibana 或 Windows下安裝Kibana
deb	該deb軟體包適用於Debian，Ubuntu和其他基於Debian的系統。Debian軟體包可以從Elastic網站或我們的Debian儲存庫下載。 使用Debian軟體包安裝Kibana
rpm	該rpm軟體包適合安裝在Red Hat，Centos，SLES，OpenSuSE和其他基於RPM的系統上。RPM可以從Elastic網站或我們的RPM儲存庫下載。 用RPM安裝Kibana
docker	影像可用於將Kibana作為Docker容器執行。它們可以從Elastic Docker Registry下載。 在Docker上執行Kibana

通過.tar.gz包安裝

下載並安裝Linux 64位軟體包

可以按如下方式下載和安裝Kibana v6.5.1的Linux歸檔檔案：

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

下載並安裝Darwin軟體包

可以下載和安裝Kibana v6.5.1的Darwin存檔，如下所示：

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

從命令列編輯執行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_HOME\bin
配置	配置檔案，包括 kibana.yml	$KIBANA_HOME\config
資料	Kibana和外掛寫入磁碟的資料檔案的位置	$KIBANA_HOME\data
優化	透明的原始碼。某些管理操作（例如外掛安裝）導致原始碼在執行中重新傳輸。	$KIBANA_HOME\optimize
外掛	外掛檔案位置。每個外掛都將包含在一個子目錄中。	$KIBANA_HOME\plugins

使用Debian Package 編輯安裝Kibana

可以在Download Kibana頁面上找到最新的穩定版 Kibana。其他版本可在“ 舊版本”頁面上找到。

匯入彈性PGP金鑰

我們使用帶有指紋的彈性簽名金鑰（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儲存庫安裝

apt-transport-https在繼續之前，您可能需要在Debian 上安裝軟體包：

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

Warning：
如果同一個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.5.1的Debian軟體包，安裝方法如下：

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

SysV init 與systemd的比較

安裝後Kibana不會自動啟動。如何啟動和停止Kibana取決於您的系統是使用SysV init還是 systemd（由較新的Linux發行版使用）。您可以通過執行以下命令來判斷正在使用哪個：

ps -p 1

使用該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
配置	配置檔案包括 kibana.yml	/etc/kibana
資料	Kibana及其外掛寫入磁碟的資料檔案的位置	/var/lib/kibana	path.data
優化	透明的原始碼。某些管理操作（例如外掛安裝）導致原始碼在執行中重新傳輸。	/usr/share/kibana/optimize
外掛	外掛檔案位置。每個外掛都將包含在一個子目錄中。	/usr/share/kibana/plugins

通過RPM安裝Kibana

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

舊版RPM的發行版不支援RPM安裝，例如SLES 11和CentOS
5.請參閱安裝Kibana.tar.gz。

匯入Elastic PGP 金鑰

我們使用帶有指紋的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儲存庫安裝

基於RedHat的發行版的kibana.repo在/etc/yum.repos.d/目錄中建立一個檔案，基於OpenSuSE的發行版在/etc/zypp/repos.d/的目錄中建立一個檔案，其中包含：

[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  

① yum用於CentOS和較舊的基於Red Hat的發行版。
② dnf用於Fedora和其他新的Red Hat分發。
③ zypper用於基於分佈的OpenSUSE

還提供了一個替代軟體包，kibana-oss其中僅包含Apache
2.0許可證下提供的功能。要安裝它，請baseurl在您的kibana.repo檔案中使用以下內容：
baseurl=https://artifacts.elastic.co/packages/oss-6.x/yum

手動安裝PRM包

可以從網站下載Kibana v6.5.2的RPM，並按如下方式安裝：

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

① 將生成的SHA shasum與釋出的SHA進行比較。

或者，您可以下載以下軟體包，其僅包含Apache 2.0許可下提供的功能：https://artifacts.elastic.co/downloads/kibana/kibana-oss-6.5.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

RPM將配置檔案，日誌和資料目錄放在基於RPM的系統的適當位置：

型別	描述	預設位置	設定
Home	Kibana主目錄或 $KIBANA_HOME	/usr/share/kibana
bin	二進位制指令碼包括kibana啟動Kibana伺服器和kibana-plugin安裝外掛	/usr/share/kibana/bin
配置	配置檔案包括 kibana.yml	/etc/kibana
資料	Kibana及其外掛寫入磁碟的資料檔案的位置	/var/lib/kibana	path.data
優化	透明的原始碼。某些管理操作（例如外掛安裝）導致原始碼在執行中重新傳輸。	/usr/share/kibana/optimize
外掛	外掛檔案位置。每個外掛都將包含在一個子目錄中。	/usr/share/kibana/plugins