![[Zephyr]](/views/front/img/head.png){kind=avatar}
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 |