Kibana 用户指南（安装Kibana）

摘要：使用安装为和提供了包，这些包是获取时最容易使用的格式。下载并安装位软件包以下为下载和安装的归档将生产的与已发布的进行比较。旧版本的不支持安装，比如和，请参照使用安装替代。

如果你正在Elastic Cloud上运行托管的Elasticsearch服务，你可以通过单击访问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中配置安全性以获得更多的安装说明。

Kibana为Linux和Darwin提供了.tar.gz包，这些包是获取Kibana时最容易使用的格式。

这些包在Elastic许可下可以免费使用，它们包含开放源码和免费的商业特性，以及对付费商业特性的访问，开始30天的体验尝试所有付费的商业功能，有关Elastic许可证级别的信息，请参阅订阅页面。

Kibana的最新稳定版本可以在下载Kibana页面找到，其他版本可以在过去的版本页面中找到。

以下为下载和安装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

以下为下载和安装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从命令行启动：

./bin/kibana

默认情况下，Kibana在前台运行，将其日志输出到标准输出（stdout），可以按Ctrl-C停止。

Kibana默认从$KIBANA_HOME/config/kibana.yml文件加载它的配置，配置文件的格式在配置Kibana中进行了说明。

.tar.gz包是完全独立的，默认情况下，所有文件和目录都包含在$KIBANA_HOME中 - 在解压归档文件时创建的目录。

这非常方便，因为你不必创建任何目录来开始使用Kibana，卸载Kibana就像删除$KIBANA_HOME目录一样简单。但是，建议更改配置和数据目录的默认位置，以便以后不删除重要数据。

Kibana的Debian软件包可以从我们的网站或APT库下载，它可以用于在任何基于Debian的系统上安装Kibana，比如Debian和Ubuntu。

此包在Elastic许可下免费使用，它包含开放源码和免费的商业特性，以及对付费商业特性的访问，开始30天的体验尝试所有付费的商业功能，有关Elastic许可证级别的信息，请参阅订阅页面。

最新的稳定版Kibana可以在下载Kibana页面找到，其他版本可以在过去的发行版页面中找到。

我们用带指纹的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 -

在继续之前，你可能需要在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文件中的文件中找到重复条目。

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。

Kibana安装后不会自动启动，如何启动和停止Kibana取决于系统是使用SysV init还是systemd（用于更新的发行版），你可以通过运行这个命令来判断使用的是哪个：

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/中找到。

要配置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默认从/etc/kibana/kibana.yml加载它的配置，配置文件的格式在配置Kibana中进行了说明。

Debian软件包将配置文件、日志和数据目录放置在基于debian的系统的适当位置：

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

在/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

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。

Kibana安装后不会自动启动，如何启动和停止Kibana取决于系统是使用SysV init还是systemd（用于更新的发行版），你可以通过运行这个命令来判断使用的是哪个：

ps -p 1

使用chkconfig命令将Kibana配置为在系统启动时自动启动：

sudo chkconfig --add kibana

你可以使用service命令启动和停止Kibana：

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

如果Kibana由于任何原因无法启动，它将打印出失败的原因到STDOUT，日志文件可以在/var/log/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默认从/etc/kibana/kibana.yml加载它的配置，配置文件的格式在配置Kibana中进行了说明。

RPM将配置文件、日志和数据目录放在基于RPM的系统的适当位置：

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

此包在Elastic许可下免费使用，它包含开放源码和免费的商业特性，以及对付费商业特性的访问，开始30天的体验尝试所有付费的商业功能，有关Elastic许可证级别的信息，请参阅订阅页面。

最新的稳定版Kibana可以在下载Kibana页面找到，其他版本可以在过去的发行版页面中找到。

下载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，如下所示：

.inkibana.bat

默认情况下，Kibana在前台运行，将其日志打印到STDOUT，并可以通过按Ctrl-C停止。

Kibana默认从$KIBANA_HOME/config/kibana.yml加载它的配置，配置文件的格式在配置Kibana中进行了说明。

.zip包是完全独立的，默认情况下，所有文件和目录都包含在$KIBANA_HOME中 - 在解压归档文件时创建的目录。

这非常方便，因为你不必创建任何目录来开始使用Kibana，卸载Kibana就像删除$KIBANA_HOME目录一样简单。但是，建议更改配置和数据目录的默认位置，以便以后不删除重要数据。