安装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

从命令行运行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进行比较。

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进行比较。

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-6.4.2-windows-x86_64的文件夹，我们将其称为$KIBANA_HOME，例如，在终端窗口中，CD到$KIBANA_HOME目录：

CD c:\kibana-6.4.2-windows-x86_64

从命令行运行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