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