Kibana：如何在 Linux，MacOS 及 Windows 上安装 Elastic 栈中的 Kibana

Elasticsearch 在 IT 界中非常流行。它提供了一种近实时的，REST 接口的数据查询。为大数据的查询及分析提供了方便。在今天的文章中，我们来介绍一下在 Elastic 栈中非常有名的 Kibana。这里我们主要来介绍一下 Kibana 的安装。我们会在以后的文章里慢慢介绍 Kibana 如何和 Elasticsearch 一起工作，展示数据并分析数据。

Kibana 是一个开源分析和可视化平台，旨在与 Elasticsearch 协同工作。 你使用 Kibana 搜索，查看和与存储在 Elasticsearch 索引中的数据进行交互。 你可以轻松执行高级数据分析，并在各种图表，表格和地图中可视化你的数据。

Kibana 使你可以轻松理解大量数据。 其简单的基于浏览器的界面使你能够快速创建和共享动态仪表板，实时显示 Elasticsearch 查询的更改。

设置 Kibana 非常容易。 你可以安装 Kibana 并在几分钟内开始探索你的 Elasticsearch 索引 - 无需代码，无需额外的基础架构。

前提条件

如果你还没有安装好自己的 Elasticsearch，请参阅文章 “如何在 Linux，MacOS 及 Windows 上进行安装 Elasticsearch” 来安装好 Elasticsearch。

设置 Kibana

本节包含有关如何设置 Kibana 并使其运行的信息，包括：

• 下载
• 安装
• 开始
• 配置
• 升级

支持的 platforms

针对 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 运行到补丁版本。

注意：从 6.0 版本开始，只支持64位的操作系统

在本篇文章中，我们只介绍从安装下载的文档里进行安装。如果大家对 hosted Elasticsearch Service 的安装感兴趣的话，请参阅 链接。在那里，我们只需很少的步骤就可以很轻松地安装我们所需要的 Kibana。

在如下的安装中，我们使用版本7.3.0为例来展示如何安装。在实际的使用过程中，我们可以选择最新的安装版本，比如7.5.1。我们只需要把命令行中的7.3.0替换成7.5.1即可。

Elastic Stack 8.x 安装

Elastic Stack 8.x 由于全面启动了安全设置，在一些步骤上稍微有些差异。Elastic Stack 8.0 的按照请参考如下的两篇文章尽管下面的安装步骤基本适用。

• Elastic：使用 Docker 安装 Elastic Stack 8.0 并开始使用

• Kibana：使用 Docker 安装 Kibana - 8.x

• Elastic Stack 8.0 安装 - 保护你的 Elastic Stack 现在比以往任何时候都简单
• Elasticsearch: 使用 Debian 安装包来安装 Elasticsearch 8.x
• Kibana：使用 Debian 安装包来安装 Kibana 8.x

• Elasticsearch：使用 RPM 安装包来安装 Elastic Stack 8.x

• Elasticsearch：在 Windows 下安装 Elastic Stack 8.x

• Elasticsearch：如何在 Docker 上运行 Elasticsearch 8.x 进行本地开发

• Elasticsearch：如何使用自定义的证书安装 Elastic Stack 8.x

使用 .tar.gz 安装 Kibana

Kibana 是为 Linux 和 Darwin 提供的 .tar.gz 包。 这些包是尝试 Kibana 时最简单的格式。

这些包可以在 Elastic 许可下免费使用。 它们包含开源和免费商业功能以及付费商业功能。 开始为期 30天的试用，试用所有付费商业功能。 有关弹性许可级别的信息，请参阅 “订阅” 页面。

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

下载并安装 Linux 64 位 package

可以按如下方式下载和安装 Kibana v7.3.0 的 Linux 归档文件：

wget https://artifacts.elastic.co/downloads/kibana/kibana-7.3.0-linux-x86_64.tar.gz
shasum -a 512 kibana-7.3.0-linux-x86_64.tar.gz 
tar -xzf kibana-7.3.0-linux-x86_64.tar.gz
cd kibana-7.3.0-linux-x86_64/ 

上面的第二个命令是用来比较由 shasum 所生产的 SHA 值和发布的值是否是一样的。如果网络好的情况，并且下载完整，我们可以忽略这一步。这一步是为了保证我们下载的文件的完整性。

在上面的命令的最后一步，我们所在的目录，我们称之为 $KIBANA_HOME。

下载并安装 Darwin package - macOS

可以下载和安装 Kibana v7.3.0 的 Darwin 存档，如下所示：

curl -O https://artifacts.elastic.co/downloads/kibana/kibana-7.3.0-darwin-x86_64.tar.gz
shasum -a 512 kibana-7.3.0-darwin-x86_64.tar.gz 
tar -xzf kibana-7.3.0-darwin-x86_64.tar.gz
cd kibana-7.3.0-darwin-x86_64/ 

上面的第二个命令是用来比较由 shasum 所生产的 SHA 值和发布的值是否是一样的。如果网络好的情况，并且下载完整，我们可以忽略这一步。这一步是为了保证我们下载的文件的完整性。

在 macOS 上，经常我们运行一个可执行文件时，系统有时会弹出一个安全提示框，说这个应用不是来做 App Store 里的，需要我们手动予以权限才可以运行。为了避免这样的提示，我们可以运行如下的命令：

xattr -r -d com.apple.quarantine ./node_modules/re2/build/Release/re2.node
xattr -r -d com.apple.quarantine ./bin/kibana

在上面的命令的最后一步，我们所在的目录，我们称之为 $KIBANA_HOME。

或者，你可以下载以下软件包，该软件包仅包含 Apache 2.0 许可证下提供的功能：https://artifacts.elastic.co/downloads/kibana/kibana-oss-7.3.0-darwin-x86_64.tar。

除了上面的安装方法之外，我们还可以使用如下的方法来进行安装：

brew install kibana

Windows 安装

我们需要选择和 Elasticsearch 相匹配的 Kibana 版本。首先我们坚持我们自己的 Elasticsearch 的版本，然后到地址Past Releases of Elastic Stack Software | Elastic 选择我们需要的版本进行下载：

1) 从 Kibana下载页面下载所需要的 Windows zip 文件。

2) 将 zip 文件的内容提取到计算机上的目录中，例如 C:\Program Files

3) 以管理员身份打开 Command Prompt，然后导航到包含解压缩文件的目录，例如：

cd C:\Program Files\kibana-7.3.0-windows

4) 启动 Kibana：

bin\kibana.bat

从命令运行 Kibana

可以从命令行启动 Kibana，如下所示：

./bin/kibana

默认情况下，Kibana 在前台运行，将其日志打印到标准输出（stdout），按 Ctrl-C 可以停止。

在我们的浏览器中，我们输入地址 http://localhost:5601。我们可以看到上面的界面。我们可以利用这个界面来对我们的数据进行分析，展示等。我们会在以后的文章里再做介绍。

我们也可以在浏览器中输入如下的地址 http://localhost:5601/status 以查看 Kibana 的状态：

通过 config 配置 Kibana

Kibana 默认从 $KIBANA_HOME/config/kibana.yml 文件加载其配置。 配置Kibana 中介绍了此配置文件的格式。如果你想把 Kibana 的界面设置为中文的界面，那么你可以在 kibana.yml 中进行如下的设置：

kibana.yml

i18n.locale: "zh-CN"

我们也可以在命令行中在不用修改 kibana.yml 文件的前提下运行 Kibana:

./bin/kibana --elasticsearch.hosts="http://localhost:9200" --host=0.0.0.0

在上面的命令中，我们定义了 Elasticsearch 的 IP 地址以及 host 地址。它们将覆盖任何在 kibana.yml 文件中的设置。针对 Elasticsearch 已经配置安全的设置，我们在不用修改 kibana.yml 的情况下，可以使用如下的命令来启动 Kibana:

./bin/kibana --elasticsearch.hosts="http://localhost:9200" --elasticsearch.username=kibana --elasticsearch.password=password

上面的 password 为在配置安全时所设置的密码。关于安全，我们可以参考文章 “Elasticsearch：设置 Elastic 账户安全”。

我们可以通过如下的命令来查看可以配置的参数：

./bin/kibana -h

上面的命令显示：

  Usage: bin/kibana [command=serve] [options]
  
  Kibana is an open source (Apache Licensed), browser based analytics and search dashboard for Elasticsearch.
  
  Commands:
    serve  [options]  Run the kibana server
    help  <command>   Get the help for a specific command
  
  "serve" Options:
  
    -e, --elasticsearch <uri1,uri2>  Elasticsearch instances
    -c, --config <path>              Path to the config file, use multiple --config args to include multiple config files (default: ["/Users/liuxg/elastic/kibana-7.8.0-darwin-x86_64/config/kibana.yml"])
    -p, --port <port>                The port to bind to
    -q, --quiet                      Prevent all logging except errors
    -Q, --silent                     Prevent all logging
    --verbose                        Turns on verbose logging
    -H, --host <host>                The host to bind to
    -l, --log-file <path>            The file to log to
    --plugin-dir <path>              A path to scan for plugins, this can be specified multiple times to specify multiple directories (default: ["/Users/liuxg/elastic/kibana-7.8.0-darwin-x86_64/plugins","/Users/liuxg/elastic/kibana-7.8.0-darwin-x86_64/src/legacy/core_plugins"])
    --plugin-path <path>             A path to a plugin which should be included by the server, this can be specified multiple times to specify multiple paths (default: [])
    --plugins <path>                 an alias for --plugin-dir
    --optimize                       Run the legacy plugin optimizer and then stop the server
    -h, --help                       output usage information

.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	透明的源代码。 某些管理操作（例如，插件安装）导致源代码在运行中被重新传输。	$KIBANA_HOME\optimize
plugins	插件文件位置。 每个插件都将包含在一个子目录中。	$KIBANA_HOME\plugins

至此，我们的 Kibana 已经安装好了。非常简单直接。我看可以参阅链接来进行其它形式的安装。

一旦安装好我们的 Elasticsearch 及 Kibana，我们就可以开始我们的 Elasticsearch 之旅。我们可以参考为接下来的文章“开始使用 Elasticsearch （1）”来了解如何使用 Elasticsearch。对于 Kibana 的介绍你可以阅读文章：

• Kibana：如何开始使用 Kibana

• Kibana：Kibana 入门 （一）

如果大家想更进一步安装安全方面的安装及配置，请参阅我的文章 “Elasticsearch：设置 Elastic 账户安全”。