kibana從入門到精通-Kibana安裝

做者其餘ELK快速入門系列文章

Elasticsearch從入門到精通

logstash快速入門實戰指南

簡介

Kibana 是一款開源的數據分析和可視化平臺，它是 Elastic Stack 成員之一，設計用於和 Elasticsearch 協做。您可使用 Kibana 對 Elasticsearch 索引中的數據進行搜索、查看、交互操做。您能夠很方便的利用圖表、表格及地圖對數據進行多元化的分析和呈現。

Kibana 可使大數據通俗易懂。它很簡單，基於瀏覽器的界面便於您快速建立和分享動態數據儀表板來追蹤 Elasticsearch 的實時數據變化。

搭建 Kibana 很是簡單。您能夠分分鐘完成 Kibana 的安裝並開始探索 Elasticsearch 的索引數據 — 沒有代碼、不須要額外的基礎設施。

界面

爲了給你們一個直觀的感受，先上個圖讓你們來圍觀一下它靚照：

 

 

支持的平臺

Kibana 有 Linux、Darwin 和 Windows 版本的安裝包。因爲 Kibana 基於 Node.js 運行，咱們在這些平臺上包含了一些必要的 Node.js 二進制文件。Kibana 不支持在獨立維護的 Node.js 版本上運行。

Elasticsearch 版本

Kibana 的版本須要和 Elasticsearch 的版本一致。這是官方支持的配置。

運行不一樣主版本號的 Kibana 和 Elasticsearch 是不支持的（例如 Kibana 5.x 和 Elasticsearch 2.x），若主版本號相同，運行 Kibana 子版本號比 Elasticsearch 子版本號新的版本也是不支持的（例如 Kibana 5.1 和 Elasticsearch 5.0）。

運行一個 Elasticsearch 子版本號大於 Kibana 的版本基本不會有問題，這種狀況通常是便於先將 Elasticsearch 升級（例如 Kibana 5.0 和 Elasticsearch 5.1）。在這種配置下，Kibana 啓動日誌中會出現一個警告，因此通常只是使用於 Kibana 即將要升級到和 Elasticsearch 相同版本的場景。

運行不一樣的 Kibana 和 Elasticsearch 補丁版本通常是支持的（例如：Kibana 5.0.0 和 Elasticsearch 5.0.1），儘管咱們鼓勵用戶去運行最新的補丁更新版本。

安裝 Kibana

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

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

tar.gz/zip	tar.gz 包用來在 Linux 和 Darwin 系統下安裝，也是最方便的一種選擇。 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	Elastic Docker 倉庫中有現有的能夠運行 Kibana 的 Docker 鏡像，並預裝了 X-Pack 。 Docker 容器中運行 Kibana

使用 .tar.gz 安裝 Kibana
Kibana 爲 Linux 和 Darwin 平臺提供了 .tar.gz 安裝包。這些類型的包很是容易使用。

Kibana 的最新穩定版本能夠在 Kibana 下載頁找到。其它版本能夠在 已發佈版本中查看。

下載安裝 Linux 64 位包

Kibana v6.0.0 的 Linux 文件能夠按照以下方式下載和安裝：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-linux-x86_64.tar.gz

sha1sum kibana-6.0.0-linux-x86_64.tar.gz

 

tar -xzf kibana-6.0.0-linux-x86_64.tar.gz

cd kibana/

 

	比較 sha1sum 或 shasum 產生的 SHA 跟 發佈 SHA是否一致。
	該目錄是 $KIBANA_HOME 。

下載安裝 Darwin 包

Kibana v6.0.0 的 Darwin 文件能夠按照以下方式下載和安裝：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-darwin-x86_64.tar.gz

shasum kibana-6.0.0-darwin-x86_64.tar.gz

 

tar -xzf kibana-6.0.0-darwin-x86_64.tar.gz

cd kibana/

 

	比較 sha1sum 或 shasum 產生的SHA 跟 發佈的 SHA是否一致。
	該目錄是 $KIBANA_HOME 。

從命令行啓動 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 home 目錄或 $KIBANA_HOME 。	解壓包時建立的目錄
bin	二進制腳本，包括 kibana 啓動 Kibana 服務和 kibana-plugin 安裝插件。	$KIBANA_HOME\bin
config	配置文件，包括 kibana.yml 。	$KIBANA_HOME\config
data	Kibana 和其插件寫入磁盤的數據文件位置。	$KIBANA_HOME\data
optimize	編譯過的源碼。某些管理操做(如，插件安裝)致使運行時從新編譯源碼。	$KIBANA_HOME\optimize
plugins	插件文件位置。每個插件都有一個單獨的二級目錄。	$KIBANA_HOME\plugins

 

在 Windows 上安裝 Kibana

在 Windows 中安裝 Kibana 使用 .zip 包。

最新穩定版 Kibana 能夠從 Kibana 下載頁得到。其餘版本能夠在 已發佈版本中查看。

下載安裝 .zip 包

下載 Kibana v6.0.0 的 .zip windows 文件： https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-windows-x86_64.zip

用您喜歡的解壓工具解壓下載的 zip 包。會建立一個文件夾叫 kibana-6.0.0-windows-x86_64，也就是咱們指的 $KIBANA_HOME 。在一個終端窗口中， CD 到 $KIBANA_HOME 目錄，例如：

CD c:\kibana-6.0.0-windows-x86_64

從命令行啓動 Kibana

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

.\bin\kibana

默認狀況下，Kibana 在前臺啓動，輸出 log 到 STDOUT ，能夠經過 Ctrl-C 中止 Kibana。

經過配置文件配置 Kibana

Kibana 默認狀況下從 $KIBANA_HOME/config/kibana.yml 加載配置文件。該配置文件的格式在 配置 Kibana 中作了說明。

.zip 文件目錄

.zip 整個包是獨立的。默認狀況下，全部的文件和目錄都在 $KIBANA_HOME — 解壓包時建立的目錄下。這是很是方便的，由於您不須要建立任何目錄來使用 Kibana，卸載 Kibana 只須要簡單的刪除 $KIBANA_HOME目錄。但仍是建議修改一下配置文件和數據目錄，這樣就不會刪除重要數據。

類型	描述	默認位置	設置
home	Kibana home 目錄或 $KIBANA_HOME 。	解壓包時建立的目錄
bin	二進制腳本，包括 kibana 啓動 Kibana 服務和 kibana-plugin 安裝插件。	$KIBANA_HOME\bin
config	配置文件包括 kibana.yml 。	$KIBANA_HOME\config
data	Kibana 和其插件寫入磁盤的數據文件位置。	$KIBANA_HOME\data
optimize	編譯過的源碼。某些管理操做(如，插件安裝)致使運行時從新編譯源碼。	$KIBANA_HOME\optimize
plugins	插件文件位置。每個插件都一個單獨的二級目錄。	$KIBANA_HOME\plugins

 

使用 Debian 包安裝 Kibana

Kibana Debian 安裝包能夠在官網下載或者從APT 倉庫下載。它能夠用來在任何基於 Debian 的系統，如 Debian 和 Ubuntu 上安裝 Kibana。

Kibana 最新穩定版本能夠在官方 Kibana 下載頁找到。其餘版本能夠在 官方已發佈版本中查看。

導入 Elastic PGP 密鑰

咱們全部部署包的簽名使用的是 Elastic Signing Key (PGP key 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.0.0 的 Debian 包可使用以下命令從網站下載安裝：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-amd64.deb

sha1sum kibana-6.0.0-amd64.deb

sudo dpkg -i kibana-6.0.0-amd64.deb

比較 sha1sum 或 shasum 產生的 SHA跟 發佈的 SHA。

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

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

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 默認狀況下從 $KIBANA_HOME/config/kibana.yml 加載配置文件。該配置文件的格式在 配置 Kibana 中有相關說明。

Debian 包目錄

在 Debian 包結構中，Debian 會把配置文件、日誌和數據目錄放在以下位置：

類型	描述	默認位置	設置
home	Kibana home 目錄或 $KIBANA_HOME 。	/usr/share/kibana
bin	二進制腳本，包括 kibana 啓動 Kibana server 和 kibana-plugin 安裝插件。	/usr/share/kibana/bin
config	配置文件，包括 kibana.yml 。	/etc/kibana
data	Kibana 和其插件寫入磁盤的數據文件位置。	/var/lib/kibana
optimize	編譯過的源碼。某些管理操做 (如，插件安裝) 致使運行時從新編譯源碼。	/usr/share/kibana/optimize
plugins	插件文件位置。每個插件都有一個單獨的二級目錄。	/usr/share/kibana/plugins

 

使用 RPM 包安裝 Kibana

Kibana RPM 包能夠從官方網站下載或者從官方推薦的 RPM 倉庫下載。RPM 包能夠用來安裝 Kibana 在任何基於 RPM 包管理的系統上，如 OpenSuSE 、SLES、Centos、Red Hat 和 Oracle 企業版等系統上。

 

RPM 安裝不支持舊的系統版本，例如 SLES 11 和 CentOS 5。詳情請參考 使用 .tar.gz 安裝 Kibana 。

Kibana 的最新穩定版本能夠在官方網站 Kibana 下載頁找到。其它版本能夠在 已發佈版本中查看。

導入 Elastic PGP 密鑰

咱們全部部署包的簽名使用的是 Elastic Signing Key (PGP key 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 的發行版，在 /etc/yum.repos.d/ 目錄下新建一個 kibana.repo 文件，對於 OpenSuSE 的發行版，在 /etc/zypp/repos.d/ 目錄下新建一個 kibana.repo 文件，包含以下內容:

[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.0.0 的 RPM 包可使用以下命令從網站下載安裝 ：

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-x86_64.rpm

sha1sum kibana-6.0.0-x86_64.rpm

sudo rpm --install kibana-6.0.0-x86_64.rpm

比較 sha1sum 或 shasum 產生的 SHA 跟 發佈的 SHA。

SysV init 和 systemd 對比

Kibana 安裝後不會自動啓動。如何啓動和中止 Kibana，依賴與您的操做系統。使用 SysV init 仍是 systemd （新的發行版使用），能夠經過如下命令來顯示使用的是哪一種：

ps -p 1

SysV init 運行 Kibana

使用 chkconfig 命令配置 Kibana 開機自動啓動：

sudo chkconfig --add kibana

Kibana 能夠用 service 命令來啓動和中止：

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 默認狀況下從 $KIBANA_HOME/config/kibana.yml 加載配置文件。該配置文件的格式在 配置 Kibana 中有相關說明。

RPM 文件目錄

在 RPM 包中，會把配置文件、日誌和數據目錄放在以下位置：

類型	描述	默認位置	設置
home	Kibana home 目錄或 $KIBANA_HOME 。	/usr/share/kibana
bin	二進制腳本，包括 kibana 啓動 Kibana server 和 kibana-plugin 安裝插件。	/usr/share/kibana/bin
config	配置文件，包括 kibana.yml 。	/etc/kibana
data	Kibana 和其插件寫入磁盤的數據文件位置。	/var/lib/kibana
optimize	編譯過的源碼。某些管理操做(如，插件安裝)致使運行時從新編譯源碼。	/usr/share/kibana/optimize
plugins	插件文件位置。每個插件都有一個單獨的二級目錄。	/usr/share/kibana/plugins

 

Docker 容器中運行 Kibana

Kibana 的 Docker 鏡像能夠從 Elastic 官網上的 Docker 鏡像倉庫獲取。該鏡像是隨 X-Pack 一塊兒打包的。

 

X-Pack 在這個 image 中是預裝好的。安裝了 X-Pack，Kibana 會去鏈接一樣帶有 X-Pack 的 Elasticsearch 集羣。

獲取鏡像

向 Elastic Docker 倉庫發送一條 docker pull 命令就能夠獲取 Kibana Docker 鏡像。

命令以下:

docker pull docker.elastic.co/kibana/kibana:6.0.0

配置 Docker 中的 Kibana

Docker 鏡像提供了幾種方法來配置 Kibana。傳統的方法是給出一個 配置 Kibana 中描述的配置文件 kibana.yml ，也可使用環境變量來定義設置項。

綁定配置

一種配置 Docker 中 Kibana 的方法是經過綁定配置文件 kibana.yml 。使用 docker-compose 工具，向下面這樣綁定：

services:

  kibana:

    image: docker.elastic.co/kibana/kibana:6.0.0

    volumes:

      - ./kibana.yml:/usr/share/kibana/config/kibana.yml

環境變量設置

在 Docker 中，Kibana 能夠經過環境變量的方法設置。環境變量以下：

 

表 1. Docker 環境變量

Environment Variable	Kibana Setting
ELASTICSEARCH_CUSTOMHEADERS	elasticsearch.customHeaders
ELASTICSEARCH_PASSWORD	elasticsearch.password
ELASTICSEARCH_PINGTIMEOUT	elasticsearch.pingTimeout
ELASTICSEARCH_PRESERVEHOST	elasticsearch.preserveHost
ELASTICSEARCH_REQUESTHEADERSWHITELIST	elasticsearch.requestHeadersWhitelist
ELASTICSEARCH_REQUESTTIMEOUT	elasticsearch.requestTimeout
ELASTICSEARCH_SHARDTIMEOUT	elasticsearch.shardTimeout
ELASTICSEARCH_SSL_CA	elasticsearch.ssl.ca
ELASTICSEARCH_SSL_CERT	elasticsearch.ssl.cert
ELASTICSEARCH_SSL_KEY	elasticsearch.ssl.key
ELASTICSEARCH_SSL_VERIFY	elasticsearch.ssl.verify
ELASTICSEARCH_STARTUPTIMEOUT	elasticsearch.startupTimeout
ELASTICSEARCH_URL	elasticsearch.url
ELASTICSEARCH_USERNAME	elasticsearch.username
KIBANA_DEFAULTAPPID	kibana.defaultAppId
KIBANA_INDEX	kibana.index
LOGGING_DEST	logging.dest
LOGGING_QUIET	logging.quiet
LOGGING_SILENT	logging.silent
LOGGING_VERBOSE	logging.verbose
OPS_INTERVAL	ops.interval
PID_FILE	pid.file
SERVER_BASEPATH	server.basePath
SERVER_HOST	server.host
SERVER_MAXPAYLOADBYTES	server.maxPayloadBytes
SERVER_NAME	server.name
SERVER_PORT	server.port
SERVER_SSL_CERT	server.ssl.cert
SERVER_SSL_KEY	server.ssl.key
XPACK_MONITORING_ELASTICSEARCH_URL	xpack.monitoring.elasticsearch.url
XPACK_MONITORING_ELASTICSEARCH_USERNAME	xpack.monitoring.elasticsearch.username
XPACK_MONITORING_ELASTICSEARCH_PASSWORD	xpack.monitoring.elasticsearch.password
XPACK_MONITORING_ENABLED	xpack.monitoring.enabled
XPACK_MONITORING_MAX_BUCKET_SIZE	xpack.monitoring.max_bucket_size
XPACK_MONITORING_MIN_INTERVAL_SECONDS	xpack.monitoring.min_interval_seconds
XPACK_MONITORING_NODE_RESOLVER	xpack.monitoring.node_resolver
XPACK_MONITORING_REPORT_STATS	xpack.monitoring.report_stats
XPACK_MONITORING_KIBANA_COLLECTION_ENABLED	xpack.monitoring.kibana.collection.enabled
XPACK_MONITORING_KIBANA_COLLECTION_INTERVAL	xpack.monitoring.kibana.collection.interval
XPACK_MONITORING_UI_CONTAINER_ELASTICSEARCH_ENABLED	xpack.monitoring.ui.container.elasticsearch.enabled
XPACK_SECURITY_ENABLED	xpack.security.enabled
XPACK_SECURITY_COOKIENAME	xpack.security.cookieName
XPACK_SECURITY_ENCRYPTIONKEY	xpack.security.encryptionKey
XPACK_SECURITY_SECURECOOKIES	xpack.security.secureCookies
XPACK_SECURITY_SESSIONTIMEOUT	xpack.security.sessionTimeout

 

這些變量能夠像下面這樣，用 docker-compose 設置：

services:

  kibana:

    image: docker.elastic.co/kibana/kibana:6.0.0

    environment:

      SERVER_NAME: kibana.example.org

      ELASTICSEARCH_URL: http://elasticsearch.example.org

優先使用環境變量，而後是配置文件 kibana.yml 中的配置項。

Docker 默認值

使用 Docker 時，下面的配置項有不一樣的默認值 ：

server.host	"0"
elasticsearch.url	http://elasticsearch:9200
elasticsearch.username	elastic
elasticsearch.password	changeme
xpack.monitoring.ui.container.elasticsearch.enabled	true

這些配置項的默認值在 kibana.yml 中設置。能夠經過 自定義 kibana.yml 或者 環境變量覆蓋這些默認值。

 

訪問 Kibana

 

Kibana 是一個 web 應用，能夠經過5601端口訪問。只須要在瀏覽器中指定 Kibana 運行的機器，而後指定端口號便可。例如， localhost:5601 或者 http://YOURDOMAIN.com:5601 ,詳見以前界面章節展示靚照。