Kibana：使用 Debian 安装包来安装 Kibana 8.x

Posted 2022-03-19 Elastic 中国社区官方博客

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

该软件包包含免费和订阅功能。 开始 30 天试用以试用所有功能。

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

前提条件

因为 Kibana 是和 Elasticsearch 一起配合使用的，所以在安装 Kibana 之前，你需要安装和 Kibana 相一致的 Elasticsearch 版本。如果你还没有安装好自己的 Elasticsearch 的话，那么请参阅我之前的文章 “Elasticsearch: 使用 Debian 安装包来安装 Elasticsearch 8.x”。

导入 Elastic PGP key

我们使用带有指纹的 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-8.x.list：

echo "deb https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-8.x.list

警告：如果你已经按照之前安装 Elasticsearch 的文章 “Elasticsearch: 使用 Debian 安装包来安装 Elasticsearch 8.x” 安装过 Elasticsearch，请忽略上面的一步。否则会在 /etc/apt/sources.list.d/elastic-8.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/8.x/apt/ ...`

检查 /etc/apt/sources.list.d/elastic-8.x.list 中的重复条目或在 /etc/apt/sources.list.d/ 和 /etc/apt/ 中的文件中找到重复条目 source.list 文件。

我们可以通过如下的方式来查看 kibana 服务的运行状态：

parallels@liuxg:~$ service kibana status
● kibana.service - Kibana
     Loaded: loaded (/lib/systemd/system/kibana.service; disabled; vendor preset: enabled)
     Active: inactive (dead)
       Docs: https://www.elastic.co

上面显示 Kibana 的服务没有被启动起来。我们有如下的两种方法启动 kibana 服务：

1）使用 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 是否成功启动的反馈。 可以通过 journalctl -u kibana.service 访问日志信息。

2）直接启动 kibana 服务

有时我们不想在机器启动的时候自动启动 kibana 服务。我们可以在需要的时候来启动 kibana 服务：

sudo service kibana start

我们通过如下的命令来检查 kibana 服务的运行状态：

service kibana status

上面显示 kibana 服务正处于运行的状态。

我们可以在浏览器中进行访问 http://localhost:5601：

上面它要求我们输入一个 enrollment token。那么我们怎么才可以得到这个 enrollment token 呢？

我们可以再回头看看文章 “Elasticsearch: 使用 Debian 安装包来安装 Elasticsearch 8.x” 里 Elasticsearch 服务被启动时的输出信息：

在上面的输出信息中，它明确地告诉了我们如何获得 enrollment token 的生成方法。我们使用如下的命令：

sudo /usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s kibana

parallels@liuxg:~$ sudo /usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s kibana
eyJ2ZXIiOiI4LjEuMCIsImFkciI6WyIxOTIuMTY4LjAuMTA6OTIwMCJdLCJmZ3IiOiIzOTBhZWY5MmJjM2JlOGFiZDJhODY3MDRhOTE4YTA3MGY2ZTYxOGI0NWQxMGE0ZWI1ODMxODM0ZmQzODVjODA5Iiwia2V5IjoiOVl2U2xuOEJEQ0twNll5cXVUZHg6ZWF6dUNQR3FSS3FuTkZLQzRHTG9xUSJ9

请注意上面的 token 的有效期只有30分钟。我们必须在30分钟内使用它。否则，我们需要重新获取。

把获得的 token 填入到上面的框中，并点击 Configure Elastic：

 

我们需要获得  verification-code。我们可以通过如下的方式来获得：

parallels@liuxg:~$ journalctl -u kibana.service 
-- Logs begin at Sat 2021-03-13 16:28:18 CST, end at Thu 2022-03-17 15:43:28 CST. --
Mar 17 15:35:55 liuxg systemd[1]: Started Kibana.
Mar 17 15:36:00 liuxg kibana[43727]: [2022-03-17T15:36:00.471+08:00][INFO ][plugins-service] Plugin "metricsEntities" i>
Mar 17 15:36:00 liuxg kibana[43727]: [2022-03-17T15:36:00.516+08:00][INFO ][http.server.Preboot] http server running at>
Mar 17 15:36:00 liuxg kibana[43727]: [2022-03-17T15:36:00.533+08:00][INFO ][plugins-system.preboot] Setting up [1] plug>
Mar 17 15:36:00 liuxg kibana[43727]: [2022-03-17T15:36:00.534+08:00][INFO ][preboot] "interactiveSetup" plugin is holdi>
Mar 17 15:36:00 liuxg kibana[43727]: [2022-03-17T15:36:00.548+08:00][INFO ][root] Holding setup until preboot stage is >
Mar 17 15:36:00 liuxg kibana[43727]: i Kibana has not been configured.
Mar 17 15:36:00 liuxg kibana[43727]: Go to http://localhost:5601/?code=140472 to get started.
Mar 17 15:43:28 liuxg kibana[43727]: Your verification code is:  140 472

如上所示，这个 verification code 是 140 472。 在上面的画面中填入这个 verification code：

 

填入 elastic 超级用户的密码。这个是在之前启动 Elasticsearch 时可以看到的。点击 Log in：

这样我们就登录进入了 Kibana。

下载 debian 安装包并手动安装

Kibana v8.1.0 的 Debian 软件包可以从网站下载并安装如下：

wget https://artifacts.elastic.co/downloads/kibana/kibana-8.1.0-amd64.deb
shasum -a 512 kibana-8.1.0-amd64.deb 
sudo dpkg -i kibana-8.1.0-amd64.deb

关于生成 enrollment token 及登录 Kibana 和上面的步骤是一样的。

通过 config  文件配置 Kibana

Kibana 默认从 /etc/kibana/kibana.yml 文件加载其配置。 此配置文件的格式在配置 Kibana 中进行了说明。