使用 Debian 包安装 Kibana

编辑

使用 Debian 包安装 Kibana

编辑

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

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

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 gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg

从 APT 仓库安装

编辑

在继续之前,您可能需要在 Debian 上安装 apt-transport-https

sudo apt-get install apt-transport-https

将存储库定义保存到 /etc/apt/sources.list.d/elastic-8.x.list

echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /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/kibana-8.x.list 中是否存在重复条目,或者在 /etc/apt/sources.list.d//etc/apt/sources.list 文件中查找重复条目。

手动下载并安装 Debian 包

编辑

Kibana v8.17.0 的 Debian 包可以从网站下载并按如下方式安装

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

shasum 生成的 SHA 与发布的 SHA 进行比较。

启动 Elasticsearch 并为 Kibana 生成注册令牌

编辑

当您首次启动 Elasticsearch 时,会自动进行以下安全配置

  • 启用身份验证和授权,并为 elastic 内置超级用户生成密码。
  • 为传输和 HTTP 层生成 TLS 证书和密钥,并使用这些密钥和证书启用和配置 TLS。

密码以及证书和密钥将输出到您的终端。

然后,您可以使用 elasticsearch-create-enrollment-token 工具为 Kibana 生成注册令牌

bin/elasticsearch-create-enrollment-token -s kibana

启动 Kibana 并输入注册令牌以安全地将 Kibana 与 Elasticsearch 连接。

使用 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 访问日志信息。

通过配置文件配置 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

KBN_PATH_CONF

data

Kibana 及其插件写入磁盘的数据文件的位置

/var/lib/kibana

path.data

logs

日志文件位置

/var/log/kibana

日志配置

plugins

插件文件位置。每个插件都将包含在一个子目录中。

/usr/share/kibana/plugins