Kibana教程之一：下载与安装

简介

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