使用 Debian 包安装 Kibana

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

Kibana 最新稳定版本可以在 Kibana 下载页找到。其他版本可以在 已发布版本中查看。

导入 Elastic PGP 密钥

我们所有部署包的签名使用的是 Elastic Signing Key (PGP key 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.0.0 的 Debian 包可以使用如下命令从网站下载安装:

wget https://artifacts.elastic.co/downloads/kibana/kibana-6.0.0-amd64.debsha1sum kibana-6.0.0-amd64.deb sudo dpkg -i kibana-6.0.0-amd64.deb

比较 sha1sumshasum 产生的 SHA跟 发布的 SHA

SysV initsystemd 对比

Kibana 安装后不会自动启动。如何启动和停止 Kibana,依赖与您的操作系统。使用 SysV init 还是 systemd (新的发行版使用),可以通过以下命令来显示使用的是哪种:

ps -p 1

使用 SysV init 运行 Kibana

使用 update-rc.d 命令配置 Kibana 开机自动启动:

sudo update-rc.d kibana defaults 95 10

Kibana 可以使用 service 命令来启动和停止:

sudo -i service kibana startsudo -i service kibana stop

不管什么原因,如果 Kibana 启动失败,它会输出失败原因到 STDOUT。日志文件在 /var/log/kibana/ 目录下面。

使用 systemd 运行 Kibana

配置 Kibana 开机自动启动,执行以下命令:

sudo /bin/systemctl daemon-reloadsudo /bin/systemctl enable kibana.service

Kibana 启动和停止命令如下:

sudo systemctl start kibana.servicesudo systemctl stop kibana.service

这些命令不会提供任何关于 Kibana 是否成功启动的反馈信息。而是将这些信息写入日志文件中,日志文件的位置在 /var/log/kibana/

通过配置文件配置 Kibana

Kibana 默认情况下从 $KIBANA_HOME/config/kibana.yml 加载配置文件。该配置文件的格式在 配置 Kibana 中有相关说明。

Debian 包目录

在 Debian 包结构中,Debian 会把配置文件、日志和数据目录放在如下位置:

类型 描述 默认位置 设置

home

Kibana home 目录或 $KIBANA_HOME

/usr/share/kibana

bin

二进制脚本,包括 kibana 启动 Kibana server 和 kibana-plugin 安装插件。

/usr/share/kibana/bin

config

配置文件,包括 kibana.yml

/etc/kibana

data

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

/var/lib/kibana

optimize

编译过的源码。某些管理操作 (如,插件安装) 导致运行时重新编译源码。

/usr/share/kibana/optimize

plugins

插件文件位置。每一个插件都有一个单独的二级目录。

/usr/share/kibana/plugins