安装Kibana
托管的Kibana
如果你正在Elastic Cloud上运行托管的Elasticsearch服务,你可以通过单击访问Kibana。
自己安装Kibana
从6.0.0版本开始,Kibana只支持64位操作系统。
Kibana提供了如下的包格式:
tar.gz/zip
tar.gz包是在Linux和Darwin上安装的,是开始使用Kibana的最简单的选择。
zip包是惟一支持Windows的包。
deb
deb包适合Debian、Ubuntu和其他基于Debian的系统,Debian软件包可以从Elastic网站或我们的Debian存储库下载。
rpm
rpm包适合安装在Red Hat、Centos、SLES、OpenSuSE和其他基于RPM的系统上,RPM可以从Elastic网站或RPM存储库下载。
docker
可以运行Kibana作为Docker容器的镜像,可以从Elastic Docker注册表下载。
如果你的Elasticsearch安装受到X-Pack安全性的保护,请参阅在Kibana中配置安全性以获得更多的安装说明。
使用.tar.gz安装Kibana
Kibana为Linux和Darwin提供了.tar.gz包,这些包是获取Kibana时最容易使用的格式。
这些包在Elastic许可下可以免费使用,它们包含开放源码和免费的商业特性,以及对付费商业特性的访问,开始30天的体验尝试所有付费的商业功能,有关Elastic许可证级别的信息,请参阅订阅页面。
Kibana的最新稳定版本可以在下载Kibana页面找到,其他版本可以在过去的版本页面中找到。
下载并安装Linux 64位软件包
以下为下载和安装Kibana v6.4.2的Linux归档:
wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-linux-x86_64.tar.gz
shasum -a 512 kibana-6.4.2-linux-x86_64.tar.gz
tar -xzf kibana-6.4.2-linux-x86_64.tar.gz
cd kibana-6.4.2-linux-x86_64/
将shasum生产的SHA与已发布的SHA进行比较。
归档包解压的目录为$KIBANA_HOME
下载并安装Darwin软件包
以下为下载和安装Kibana v6.4.2的Darwin归档:
curl -O https://artifacts.elastic.co/downloads/kibana/kibana-6.3.2-darwin-x86_64.tar.gz
shasum -a 512 kibana-6.3.2-darwin-x86_64.tar.gz ①
tar -xzf kibana-6.3.2-darwin-x86_64.tar.gz
cd kibana-6.3.2-darwin-x86_64/ ②
将shasum生产的SHA与已发布的SHA进行比较。
归档包解压的目录为$KIBANA_HOME
从命令行运行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-plugin来安装插件的二进制脚本
$KIBANA_HOME\bin
config
包括kibana.yml的配置文件
$KIBANA_HOME\config
data
由Kibana和它的插件写入磁盘的数据文件的位置
$KIBANA_HOME\data
optimize
Transpiled源码,某些管理操作(例如插件安装)会导致源码被重新传输
$KIBANA_HOME\optimize
plugins
插件文件的位置,每个插件包含在一个子目录中
$KIBANA_HOME\plugins
使用Debian软件包安装Kibana
Kibana的Debian软件包可以从我们的网站或APT库下载,它可以用于在任何基于Debian的系统上安装Kibana,比如Debian和Ubuntu。
此包在Elastic许可下免费使用,它包含开放源码和免费的商业特性,以及对付费商业特性的访问,开始30天的体验尝试所有付费的商业功能,有关Elastic许可证级别的信息,请参阅订阅页面。
最新的稳定版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 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.4.2的Debian软件包可以从网站上下载并安装如下:
wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-amd64.deb
shasum -a 512 kibana-6.4.2-amd64.deb
sudo dpkg -i kibana-6.4.2-amd64.deb
将shasum生产的SHA与已发布的SHA进行比较。
SysV init和systemd
Kibana安装后不会自动启动,如何启动和停止Kibana取决于系统是使用SysV init还是systemd(用于更新的发行版),你可以通过运行这个命令来判断使用的是哪个:
ps -p 1
使用SysV init运行Kibana
使用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
config
包括kibana.yml的配置文件
/etc/kibana
data
由Kibana和它的插件写入磁盘的数据文件的位置
/var/lib/kibana
path.data
optimize
Transpiled源码,某些管理操作(例如插件安装)会导致源码被重新传输
/usr/share/kibana/optimize
plugins
插件文件的位置,每个插件包含在一个子目录中
/usr/share/kibana/plugins
使用RPM安装Kibana
Kibana的RPM可以从我们的网站或RPM存储库中下载,它可以用于在任何基于RPM的系统上安装Kibana,如OpenSuSE、SLES、Centos、Red Hat和Oracle Enterprise。
旧版本的RPM不支持RPM安装,比如SLES 11和CentOS 5,请参照使用.tar.gz安装Kibana替代。
此包在Elastic许可下免费使用,它包含开放源码和免费的商业特性,以及对付费商业特性的访问,开始30天的体验尝试所有付费的商业功能,有关Elastic许可证级别的信息,请参阅订阅页面。
最新的稳定版Kibana可以在下载Kibana页面找到,其他版本可以在过去的发行版页面中找到。
我们用带指纹的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存储库安装
在/etc/yum.repos.d/目录创建一个kibana.repo的文件用于基于RedHat的发行版,或者在/etc/zypp/repos.d/目录,用于基于OpenSuSE的发行版,包括:
[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
在CentOS和Red Hat旧的发行版使用yum
在Fedora和其他新的Red Hat发行版上使用dnf
在基于OpenSUSE的发行版上使用zypper
手动下载并安装RPM
Kibana v6.4.2的RPM可以从网站下载并安装如下:
wget https://artifacts.elastic.co/downloads/kibana/kibana-6.4.2-x86_64.rpm
shasum -a 512 kibana-6.4.2-x86_64.rpm
sudo rpm --install kibana-6.4.2-x86_64.rpm
将shasum生产的SHA与已发布的SHA进行比较。
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是否成功启动的反馈,相反,这些信息将被写入位于/var/log/kibana/的日志文件中。
通过配置文件配置Kibana
Kibana默认从/etc/kibana/kibana.yml加载它的配置,配置文件的格式在配置Kibana中进行了说明。
RPM软件包的目录结构
RPM将配置文件、日志和数据目录放在基于RPM的系统的适当位置:
类型
描述
默认位置
设置
home
Kibana主目录或$KIBANA_HOME
/usr/share/kibana
bin
包括kibana在内的启动kibana服务和kibana-plugin来安装插件的二进制脚本
/usr/share/kibana/bin
config
包括kibana.yml的配置文件
/etc/kibana
data
由Kibana和它的插件写入磁盘的数据文件的位置
/var/lib/kibana
path.data
optimize
Transpiled源码,某些管理操作(例如插件安装)会导致源码被重新传输
/usr/share/kibana/optimize
plugins
插件文件的位置,每个插件包含在一个子目录中
/usr/share/kibana/plugins
在Windows上安装Kibana
Kibana可以使用.zip包安装在Windows上。
此包在Elastic许可下免费使用,它包含开放源码和免费的商业特性,以及对付费商业特性的访问,开始30天的体验尝试所有付费的商业功能,有关Elastic许可证级别的信息,请参阅订阅页面。
最新的稳定版Kibana可以在下载Kibana页面找到,其他版本可以在过去的发行版页面中找到。
下载并安装.zip包
用你最喜欢的解压工具解压它,这将创建一个名为kibana-6.4.2-windows-x86_64的文件夹,我们将其称为$KIBANA_HOME,例如,在终端窗口中,CD到$KIBANA_HOME目录:
CD c:\kibana-6.4.2-windows-x86_64
从命令行运行Kibana
可以从命令行启动Kibana,如下所示:
.\bin\kibana.bat
默认情况下,Kibana在前台运行,将其日志打印到STDOUT,并可以通过按Ctrl-C停止。
通过配置文件配置Kibana
Kibana默认从$KIBANA_HOME/config/kibana.yml加载它的配置,配置文件的格式在配置Kibana中进行了说明。
.zip归档文件的目录结构
.zip包是完全独立的,默认情况下,所有文件和目录都包含在$KIBANA_HOME中 - 在解压归档文件时创建的目录。
这非常方便,因为你不必创建任何目录来开始使用Kibana,卸载Kibana就像删除$KIBANA_HOME目录一样简单。但是,建议更改配置和数据目录的默认位置,以便以后不删除重要数据。
类型
描述
默认位置
home
Kibana主目录或$KIBANA_HOME
解压归档创建的目录
bin
包括kibana在内的启动kibana服务和kibana-plugin来安装插件的二进制脚本
$KIBANA_HOME\bin
config
包括kibana.yml的配置文件
$KIBANA_HOME\config
data
由Kibana和它的插件写入磁盘的数据文件的位置
$KIBANA_HOME\data
optimize
Transpiled源码,某些管理操作(例如插件安装)会导致源码被重新传输
$KIBANA_HOME\optimize
plugins
插件文件的位置,每个插件包含在一个子目录中
$KIBANA_HOME\plugins