Kibana【从无到有从有到无】【搜索引擎】【K1】简介.搭建.变更
参考：官方文档7.2
1.简介
Kibana是一个开源分析和可视化平台，旨在与ElasticSearch合作。您可以使用Kibana来搜索、查看和与存储在ElasticSearch索引中的数据交互。您可以轻松地执行高级数据分析，并在各种图表、表格和地图中可视化数据。
Kibana使理解大量数据变得容易。它简单、基于浏览器的界面使您能够快速创建和共享动态仪表盘，这些仪表盘实时显示对ElasticSearch查询的更改。
设置Kibana很简单。您可以在几分钟内安装Kibana并开始探索您的ElasticSearch索引-无代码，不需要额外的基础设施。
2.设置
以下介绍
有关如何设置Kibana并使其运行的信息，包括：
- 下载
- 安装
- 启动
- 正在配置
- 升级
2.1.支持的平台
Kibana的软件包是针对Linux、Darwin和Windows提供和测试的。由于kibana在node.js上运行，因此我们为这些平台提供了必要的node.js二进制文件。不支持对单独维护的node.js版本运行kibana。
2.2.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运行到补丁版本。
3.搭建
3.1.安装Kibana
如果您 在Elastic Cloud上运行我们托管的Elasticsearch Service，只需单击一下即可访问Kibana。
3.1.1.安装Kibana
从V6.0.0开始，Kibana仅支持64位操作系统。Kibana以以下包格式提供：
|
|
这些 该
|
|
|
该 使用Debian软件包安装Kibana |
|
|
该 用RPM安装Kibana |
|
|
图像可用于将Kibana作为Docker容器运行。它们可以从Elastic Docker Registry下载。 在Docker上运行Kibana |
|
|
可以从Elastic Homebrew tap获得配方，用于在Homebrew软件包管理器上安装Kibana。 使用Homebrew在macOS上安装Kibana |
如果您的Elasticsearch安装受X-Pack安全保护， 请参阅 在Kibana中配置安全性以获取其他设置说明。
3.2.通过.tar.gz安装Kibana
Kibana作为Linux和Darwin提供.tar.gz。这些包是尝试Kibana时最简单的格式。
这些包可以在Elastic许可下免费使用。它们包含开源和免费商业功能以及付费商业功能。 开始为期30天的试用，试用所有付费商业功能。有关弹性许可级别的信息，请参阅“ 订阅”页面。
可以在Download Kibana页面上找到最新的稳定版 Kibana。其他版本可在“ 过去版本”页面上找到 。
3.2.1.下载并安装Linux 64位软件包
可以按如下方式下载和安装Kibana v7.2.0的Linux归档文件：
wget https://artifacts.elastic.co/downloads/kibana/kibana-7.2.0-linux-x86_64.tar.gz
shasum -a 512 kibana-7.2.0-linux-x86_64.tar.gz 将生成的SHA shasum与 发布的SHA进行比较。
tar -xzf kibana-7.2.0-linux-x86_64.tar.gz
cd kibana-7.2.0-linux-x86_64 / 该目录称为$KIBANA_HOME
3.2.2.下载并安装Darwin软件包
可以按如下方式下载和安装Kibana v7.2.0的Darwin存档：
curl -O https://artifacts.elastic.co/downloads/kibana/kibana-7.2.0-darwin-x86_64.tar.gz
shasum -a 512 kibana-7.2.0-darwin-x86_64.tar.gz 将生成的SHA shasum与 发布的SHA进行比较。
tar -xzf kibana-7.2.0-darwin-x86_64.tar.gz
cd kibana-7.2.0-darwin-x86_64 / 该目录称为$KIBANA_HOME
或者，您可以下载以下软件包，其中仅包含Apache 2.0许可下提供的功能：https：//artifacts.elastic.co/downloads/kibana/kibana-oss-7.2.0-darwin-x86_64.tar。 GZ
3.2.3.从命令行运行Kibana
可以从命令行启动Kibana，如下所示：
./bin/kibana
默认情况下，Kibana在前台运行，将其日志打印到标准输出（stdout），然后按Ctrl-C可以停止。
3.2.4.通过配置文件编辑配置Kibana
Kibana $KIBANA_HOME/config/kibana.yml 默认从文件加载其配置。配置Kibana中介绍了此配置文件的格式
3.2.5..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 |
3.3.使用Debian Package 安装Kibana
可以从我们的网站 或我们的APT存储库下载适用于Kibana的Debian软件包。它可以用于在任何基于Debian的系统上安装Kibana，例如Debian和Ubuntu。
此软件包可在Elastic许可下免费使用。它包含开源和免费商业功能以及付费商业功能。 开始为期30天的试用，试用所有付费商业功能。有关弹性许可级别的信息，请参阅“ 订阅”页面。
可以在Download Kibana页面上找到最新的稳定版 Kibana。其他版本可在“ 过去版本”页面上找到。
3.3.1.导入弹性PGP密钥
我们使用带有指纹的弹性签名密钥（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 -
3.3.2.从APT存储库安装
apt-transport-https在继续之前，您可能需要在Debian 上安装软件包：
sudo apt-get install apt-transport-https
将存储库定义保存到 /etc/apt/sources.list.d/elastic-7.x.list：
echo"deb https://artifacts.elastic.co/packages/7.x/apt stable main"| sudo tee -a /etc/apt/sources.list.d/elastic-7.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)
deb-src从/etc/apt/sources.list文件中删除条目，安装应按预期工作。您可以安装Kibana Debian软件包：
sudo apt-get update && sudo apt-get install kibana
如果同一个Kibana存储库存在两个条目，您将在以下期间看到如下错误apt-get update：
Duplicate sources.list entry https://artifacts.elastic.co/packages/7.x/apt/ ...`
检查/etc/apt/sources.list.d/kibana-7.x.list重复条目
或在文件/etc/apt/sources.list.d/和文件中找到重复条目/etc/apt/sources.list。
还提供了一个替代软件包，kibana-oss其中仅包含Apache 2.0许可证下提供的功能。要安装它，请使用以下源列表：
echo "deb https://artifacts.elastic.co/packages/oss-7.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-7.x.list3.3.3.手动下载并安装Debian软件包
可以从网站下载适用于Kibana v7.2.0的Debian软件包，安装如下：
wget https://artifacts.elastic.co/downloads/kibana/kibana-7.2.0-amd64.deb
shasum -a 512 kibana-7.2.0-amd64.deb 将生成的SHA shasum 与 发布的SHA进行比较。
sudo dpkg -i kibana-7.2.0-amd64.deb或者，您可以下载以下软件包，其中仅包含Apache 2.0许可下提供的功能：https：//artifacts.elastic.co/downloads/kibana/kibana-oss-7.2.0-amd64.deb
3.3.4.SysV initvs systemd
安装后Kibana不会自动启动。如何启动和停止Kibana取决于您的系统是使用SysV init还是systemd（由较新的发行版使用）。您可以通过运行此命令来判断正在使用哪个：
ps -p 1
3.3.5.使用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/。
3.3.6.通过systemd运行Kibana
要将Kibana配置为在系统引导时自动启动，请运行以下命令：
sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.serviceKibana可以按如下方式启动和停止：
sudo systemctl start kibana.service
sudo systemctl stop kibana.service这些命令没有提供关于Kibana是否成功启动的反馈。相反，此信息将写入位于的日志文件中/var/log/kibana/。
3.3.7.通过配置文件配置Kibana
Kibana /etc/kibana/kibana.yml 默认从文件加载其配置。配置Kibana中介绍了此配置文件的格式 。
3.3.8.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 (优化) |
编译过的源码。某些管理操作(如，插件安装)导致运行时重新编译源码 | /usr/share/kibana/optimize | |
| plugins | 插件文件位置。每个插件都将包含在一个子目录中。 | /usr/share/kibana/plugins |
3.4.使用RPM安装Kibana
Kibana的RPM可以从我们的网站 或我们的RPM存储库下载。它可用于在任何基于RPM的系统上安装Kibana，例如OpenSuSE，SLES，Centos，Red Hat和Oracle Enterprise。
旧版RPM的发行版不支持RPM安装，例如SLES 11和CentOS 5.请参阅安装Kibana.tar.gz。
此软件包可在Elastic许可下免费使用。它包含开源和免费商业功能以及付费商业功能。 开始为期30天的试用，试用所有付费商业功能。有关弹性许可级别的信息，请参阅“ 订阅”页面。
可以在Download Kibana页面上找到最新的稳定版 Kibana。其他版本可在“ 过去版本”页面上找到
3.4.1.导入弹性PGP密钥
我们使用带有指纹的弹性签名密钥（PGP密钥D88E42B4，可从https://pgp.mit.edu获得）签署我们的所有软件包 ：
4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
下载并安装公共签名密钥：
rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch3.4.2.从RPM存储库安装
kibana.repo在/etc/yum.repos.d/基于RedHat的发行版的目录中创建一个文件，或者在/etc/zypp/repos.d/基于OpenSuSE的发行版的目录中创建一个文件，其中包含：
[kibana-7.x]
name=Kibana repository for 7.x packages
baseurl=https://artifacts.elastic.co/packages/7.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md您的存储库已准备就绪。您现在可以使用以下命令之一安装Kibana：
sudo yum install kibana 用于yum CentOS和较旧的基于Red Hat的发行版。
sudo dnf install kibana 使用dnf 的Fedora和其他新的Red Hat分发。
sudo zypper install kibana 使用zypper 基于分布的OpenSUSE还提供了一个替代软件包，kibana-oss其中仅包含Apache 2.0许可证下提供的功能。
要安装它，请baseurl在您的kibana.repo文件中使用以下内容：
baseurl=https://artifacts.elastic.co/packages/oss-7.x/yum3.4.3.手动下载并安装RPM
可以从网站下载Kibana v7.2.0的RPM并按如下方式安装：
wget https://artifacts.elastic.co/downloads/kibana/kibana-7.2.0-x86_64.rpm
shasum -a 512 kibana-7.2.0-x86_64.rpm 将生成的SHA shasum与 发布的SHA进行比较。
sudo rpm --install kibana-7.2.0-x86_64.rpm或者，您可以下载以下软件包，其中仅包含Apache 2.0许可下提供的功能：https：//artifacts.elastic.co/downloads/kibana/kibana-oss-7.2.0-x86_64.rpm
3.4.4.SysV init vs systemd
安装后Kibana不会自动启动。如何启动和停止Kibana取决于您的系统是使用SysV init还是systemd（由较新的发行版使用）。您可以通过运行此命令来判断正在使用哪个：
ps -p 1
3.4.5.使用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/。
3.4.6.使用systemd运行kibana
要将Kibana配置为在系统引导时自动启动，请运行以下命令：
sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.serviceKibana可以按如下方式启动和停止：
sudo systemctl start kibana.service
sudo systemctl stop kibana.service这些命令没有提供关于Kibana是否成功启动的反馈。相反，此信息将写入位于的日志文件中/var/log/kibana/。
3.4.7.通过配置文件配置Kibana
ibana /etc/kibana/kibana.yml 默认从文件加载其配置。配置Kibana中介绍了此配置文件的格式 。
3.4.7.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 (优化) |
编译过的源码。某些管理操作(如，插件安装)导致运行时重新编译源码 | /usr/share/kibana/optimize | |
| plugins | 插件文件位置。每个插件都将包含在一个子目录中。 | /usr/share/kibana/plugins |
3.5.在Windows上安装Kibana
可以使用该.zip软件包在Windows上安装Kibana 。
此软件包可在Elastic许可下免费使用。它包含开源和免费商业功能以及付费商业功能。 开始为期30天的试用，试用所有付费商业功能。有关弹性许可级别的信息，请参阅“ 订阅”页面。
可以在Download Kibana页面上找到最新的稳定版 Kibana。其他版本可在“ 过去版本”页面上找到 。
3.5.1.下载并安装.zip包
.zip从https://artifacts.elastic.co/downloads/kibana/kibana-7.2.0-windows-x86_64.zip下载Kibana v7.2.0 的Windows归档文件
用你最喜欢的解压缩工具解压缩它。这将创建一个名为kibana-7.2.0-windows-x86_64的文件夹，我们将其称为$KIBANA_HOME。在终端窗口中，CD到$KIBANA_HOME目录，例如：
CD c:\kibana-7.2.0-windows-x86_64或者，您可以下载以下软件包，其中仅包含Apache 2.0许可下提供的功能：https：//artifacts.elastic.co/downloads/kibana/kibana-oss-7.2.0-windows-x86_64.zip
3.5.2.从命令行运行Kibana
可以从命令行启动Kibana，如下所示：
.\bin\kibana.bat默认情况下，Kibana 在前台启动，输出 log 到 STDOUT ，可以通过 Ctrl-C 停止 Kibana。
3.5.3.通过配置文件配置 Kibana
Kibana 默认情况下从 $KIBANA_HOME/config/kibana.yml 加载配置文件。该配置文件的格式在 配置 Kibana 中做了说明。
3.5.4. .zip 文件目录
.zip 整个包是独立的。默认情况下，所有的文件和目录都在 $KIBANA_HOME — 解压包时创建的目录下。这是非常方便的，因为您不需要创建任何目录来使用 Kibana，卸载 Kibana 只需要简单的删除 $KIBANA_HOME目录。但还是建议修改一下配置文件和数据目录，这样就不会删除重要数据。
| 类型 | 描述 | 默认位置 | 设置 |
| home | Kibana home 目录或 $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 |
3.6.配置 Kibana
Kibana server 启动时从 kibana.yml 文件中读取配置属性。Kibana 默认配置 localhost:5601 。改变主机和端口号，或者连接其他机器上的 Elasticsearch，需要更新 kibana.yml 文件。也可以启用 SSL 和设置其他选项。
Kibana 配置项
server.port:
默认值: 5601 Kibana 由后端服务器提供服务，该配置指定使用的端口号。
server.host:
默认值: "localhost" 指定后端服务器的主机地址。
server.basePath:
如果启用了代理，指定 Kibana 的路径，该配置项只影响 Kibana 生成的 URLs，转发请求到 Kibana 时代理会移除基础路径值，该配置项不能以斜杠 (/)结尾。
server.maxPayloadBytes:
默认值: 1048576 服务器请求的最大负载，单位字节。
server.name:
默认值: "您的主机名" Kibana 实例对外展示的名称。
server.defaultRoute:
默认值: "/app/kibana" Kibana 的默认路径，该配置项可改变 Kibana 的登录页面。
elasticsearch.url:
默认值: "http://localhost:9200" 用来处理所有查询的 Elasticsearch 实例的 URL 。
elasticsearch.preserveHost:
默认值: true 该设置项的值为 true 时，Kibana 使用 server.host 设定的主机名，该设置项的值为 false时，Kibana 使用主机的主机名来连接 Kibana 实例。
kibana.index:
默认值: ".kibana" Kibana 使用 Elasticsearch 中的索引来存储保存的检索，可视化控件以及仪表板。如果没有索引，Kibana 会创建一个新的索引。
kibana.defaultAppId:
默认值: "discover" 默认加载的应用。
tilemap.url:
Kibana 用来在 tile 地图可视化组件中展示地图服务的 URL。默认时，Kibana 从外部的元数据服务读取 url，用户也可以覆盖该参数，使用自己的 tile 地图服务。例如："https://tiles.elastic.co/v2/default/{z}/{x}/{y}.png?elastic_tile_service_tos=agree&my_app_name=kibana"
tilemap.options.minZoom:
默认值: 1 最小缩放级别。
tilemap.options.maxZoom:
默认值: 10 最大缩放级别。
tilemap.options.attribution:
默认值: "© [Elastic Tile Service](https://www.elastic.co/elastic-tile-service)" 地图属性字符串。
tilemap.options.subdomains:
服务使用的二级域名列表，用 {s} 指定二级域名的 URL 地址。
elasticsearch.username:和elasticsearch.password:
Elasticsearch 设置了基本的权限认证，该配置项提供了用户名和密码，用于 Kibana 启动时维护索引。Kibana 用户仍需要 Elasticsearch 由 Kibana 服务端代理的认证。
server.ssl.enabled
默认值: "false" 对到浏览器端的请求启用 SSL，设为 true 时， server.ssl.certificate 和 server.ssl.key 也要设置。
server.ssl.certificate:和server.ssl.key:
PEM 格式 SSL 证书和 SSL 密钥文件的路径。
server.ssl.keyPassphrase
解密私钥的口令，该设置项可选，因为密钥可能没有加密。
server.ssl.certificateAuthorities
可信任 PEM 编码的证书文件路径列表。
server.ssl.supportedProtocols
默认值: TLSv1、TLSv1.1、TLSv1.2 版本支持的协议，有效的协议类型: TLSv1 、 TLSv1.1 、 TLSv1.2 。
server.ssl.cipherSuites
默认值: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES256-GCM-SHA384, DHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-SHA256, DHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, DHE-RSA-AES256-SHA384, ECDHE-RSA-AES256-SHA256, DHE-RSA-AES256-SHA256, HIGH,!aNULL, !eNULL, !EXPORT, !DES, !RC4, !MD5, !PSK, !SRP, !CAMELLIA. 具体格式和有效参数可通过[OpenSSL cipher list format documentation](https://www.openssl.org/docs/man1.0.2/apps/ciphers.html#CIPHER-LIST-FORMAT) 获得。
elasticsearch.ssl.certificate:和elasticsearch.ssl.key:
可选配置项，提供 PEM格式 SSL 证书和密钥文件的路径。这些文件确保 Elasticsearch 后端使用同样的密钥文件。
elasticsearch.ssl.keyPassphrase
解密私钥的口令，该设置项可选，因为密钥可能没有加密。
elasticsearch.ssl.certificateAuthorities:
指定用于 Elasticsearch 实例的 PEM 证书文件路径。
elasticsearch.ssl.verificationMode:
默认值: full 控制证书的认证，可用的值有 none 、 certificate 、 full 。 full 执行主机名验证，certificate 不执行主机名验证。
elasticsearch.pingTimeout:
默认值: elasticsearch.requestTimeout setting 的值，等待 Elasticsearch 的响应时间。
elasticsearch.requestTimeout:
默认值: 30000 等待后端或 Elasticsearch 的响应时间，单位微秒，该值必须为正整数。
elasticsearch.requestHeadersWhitelist:
默认值: [ 'authorization' ] Kibana 客户端发送到 Elasticsearch 头体，发送 no 头体，设置该值为[]。
elasticsearch.customHeaders:
默认值: {} 发往 Elasticsearch的头体和值， 不管 elasticsearch.requestHeadersWhitelist 如何配置，任何自定义的头体不会被客户端头体覆盖。
elasticsearch.shardTimeout:
默认值: 0 Elasticsearch 等待分片响应时间，单位微秒，0即禁用。
elasticsearch.startupTimeout:
默认值: 5000 Kibana 启动时等待 Elasticsearch 的时间，单位微秒。
pid.file:
指定 Kibana 的进程 ID 文件的路径。
logging.dest:
默认值: stdout 指定 Kibana 日志输出的文件。
logging.silent:
默认值: false 该值设为 true 时，禁止所有日志输出。
logging.quiet:
默认值: false 该值设为 true 时，禁止除错误信息除外的所有日志输出。
logging.verbose
默认值: false 该值设为 true 时，记下所有事件包括系统使用信息和所有请求的日志。
ops.interval
默认值: 5000 设置系统和进程取样间隔，单位微妙，最小值100。
status.allowAnonymous
默认值: false 如果启用了权限，该项设置为 true 即允许所有非授权用户访问 Kibana 服务端 API 和状态页面。
cpu.cgroup.path.override
如果挂载点跟 /proc/self/cgroup 不一致，覆盖 cgroup cpu 路径。
cpuacct.cgroup.path.override
如果挂载点跟 /proc/self/cgroup 不一致，覆盖 cgroup cpuacct 路径。
console.enabled
默认值: true 设为 false 来禁用控制台，切换该值后服务端下次启动时会重新生成资源文件，因此会导致页面服务有点延迟。
elasticsearch.tribe.url:
Elasticsearch tribe 实例的 URL，用于所有查询。
elasticsearch.tribe.username:和elasticsearch.tribe.password:
Elasticsearch 设置了基本的权限认证，该配置项提供了用户名和密码，用于 Kibana 启动时维护索引。Kibana 用户仍需要 Elasticsearch 由 Kibana 服务端代理的认证。
elasticsearch.tribe.ssl.certificate:和elasticsearch.tribe.ssl.key:
可选配置项，提供 PEM 格式 SSL 证书和密钥文件的路径。这些文件确保 Elasticsearch 后端使用同样的密钥文件。
elasticsearch.tribe.ssl.keyPassphrase
解密私钥的口令，该设置项可选，因为密钥可能没有加密。
elasticsearch.tribe.ssl.certificateAuthorities:
指定用于 Elasticsearch tribe 实例的 PEM 证书文件路径。
elasticsearch.tribe.ssl.verificationMode:
默认值: full 控制证书的认证，可用的值有 none 、 certificate 、 full 。 full 执行主机名验证， certificate 不执行主机名验证。
elasticsearch.tribe.pingTimeout:
默认值: elasticsearch.tribe.requestTimeout setting 的值，等待 Elasticsearch 的响应时间。
elasticsearch.tribe.requestTimeout:
Default: 30000 等待后端或 Elasticsearch 的响应时间，单位微秒，该值必须为正整数。
elasticsearch.tribe.requestHeadersWhitelist:
默认值: [ 'authorization' ] Kibana 发往 Elasticsearch 的客户端头体，发送 no 头体，设置该值为[]。
elasticsearch.tribe.customHeaders:
默认值: {} 发往 Elasticsearch的头体和值，不管 elasticsearch.tribe.requestHeadersWhitelist 如何配置，任何自定义的头体不会被客户端头体覆盖。
3.7.Docker 容器中运行 Kibana
Kibana 的 Docker 镜像可以从 Elastic 官网上的 Docker 镜像仓库获取。该镜像是随 X-Pack 一起打包的。
X-Pack 在这个 image 中是预装好的。安装了 X-Pack，Kibana 会去连接同样带有 X-Pack 的 Elasticsearch 集群。
3.7.1.获取镜像
向 Elastic Docker 仓库发送一条 docker pull 命令就可以获取 Kibana Docker 镜像。
命令如下:
docker pull docker.elastic.co/kibana/kibana:6.0.03.7.2.配置 Docker 中的 Kibana
Docker 镜像提供了几种方法来配置 Kibana。传统的方法是给出一个 配置 Kibana 中描述的配置文件 kibana.yml ，也可以使用环境变量来定义设置项。
3.7.3.绑定配置
一种配置 Docker 中 Kibana 的方法是通过绑定配置文件 kibana.yml 。使用 docker-compose 工具，向下面这样绑定：
services:
kibana:
image: docker.elastic.co/kibana/kibana:6.0.0
volumes:
- ./kibana.yml:/usr/share/kibana/config/kibana.yml3.7.4.环境变量设置
在 Docker 中，Kibana 可以通过环境变量的方法设置。环境变量如下：
表 1. Docker 环境变量
| Environment Variable |
Kibana Setting |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
这些变量可以像下面这样，用 docker-compose 设置：
services:
kibana:
image: docker.elastic.co/kibana/kibana:6.0.0
environment:
SERVER_NAME: kibana.example.org
ELASTICSEARCH_URL: http://elasticsearch.example.org优先使用环境变量，然后是配置文件 kibana.yml 中的配置项。
3.7.5.Docker 默认值
使用 Docker 时，下面的配置项有不同的默认值 ：
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
些配置项的默认值在 kibana.yml 中设置。可以通过 自定义 kibana.yml 或者 环境变量覆盖这些默认值。
3.8.访问 Kibana
Kibana 是一个 web 应用，可以通过5601端口访问。只需要在浏览器中指定 Kibana 运行的机器，然后指定端口号即可。例如， localhost:5601 或者 http://YOURDOMAIN.com:5601 。
当访问 Kibana 时，Discover 页默认会加载默认的索引模式。时间过滤器设置的时间为过去15分钟，查询设置为匹配所有 (\*) 。
如果看不到任何文档，试着把时间过滤器的范围调大。如果还是看不到任何结果，很可能是根本就 没有 任何文档。
3.8.1.检查 Kibana 状态
您可以通过 localhost:5601/status 来访问 Kibana 的服务器状态页，状态页展示了服务器资源使用情况和已安装插件列表。
3.9.连接 Kibana 和 Elasticsearch
开始使用 Kibana 前，需要告诉 Kibana 您想要探索的 Elasticsearch 索引。第一次访问 Kibana 时，会提示您定义一个 index pattern(索引模式) 匹配一个或多个索引。这就是初次使用 Kibana 时所有需要配置的。任何时候都可以在 Management 页面增加索引模式。
默认情况下，Kibana 会连接运行在 localhost 上的 Elasticsearch 实例。如果需要连接不同的 Elasticsearch实例，可以修改 kibana.yml 配置文件中的 Elasticsearch URL 配置项并重启 Kibana。如果在生产环境节点上使用 Kibana，请参考 生产环境中使用 Kibana 。 |
设置您想通过 Kibana 访问的 Elasticsearch 索引：
1. 浏览器中指定端口号5601来访问 Kibana UI 页面。例如， localhost:5601 或者 http://YOURDOMAIN.com:5601 。
2. 指定一个索引模式来匹配一个或多个 Elasticsearch 索引名称。默认情况下，Kibana 会认为数据是通过 Logstash 解析送进 Elasticsearch 的。这种情况可以使用默认的 logstash-* 作为索引模式。星号 (*) 匹配0或多个索引名称中的字符。如果 Elasticsearch 索引遵循其他命名约定，请输入一个恰当的模式。该模式也可以直接用单个索引的名称。
3. 如果您想做一些基于时间序列的数据比较，可以选择索引中包含时间戳的字段。Kibana 会读取索引映射，列出包含时间戳的所有字段。如果索引中没有基于时间序列的数据，则禁用 Index contains time-based events 选项。
使用事件时间来创建索引名称在这个版本的 Kibana 中会被标记成 deprecated 。这个功能将在下一个 Kibana 的主要版本中被彻移除。
Elasticsearch 2.1 拥有强大的日期解析 API 用于分割日期信息，没必要在索引模式名称中指定日期。4. 点击 Create 增加索引模式。默认情况下，第一个模式被自动配置为默认的。当索引模式不止一个时，可以通过点击 Management > Index Patterns 索引模式题目上的星星图标来指定默认的索引模式。
全部设置完毕！Kibana 连接了 Elasticsearch 的数据。展示了一个匹配到的索引的字段只读列表。
Kibana 可视化控件中的字段以及 .kibana 索引管理依赖动态映射（dynamic mapping）功能，
如果动态映射被关闭，您需要手动提供字段的映射以便于 Kibana 用于正确的创建可视化控件。
更多信息，请参考 Kibana 和 Elasticsearch 动态映射 。
3.9.1.开始探索您的数据！
准备挖掘您的数据：
- 在 Discover 页搜索和浏览数据。
- 在 Visualize 页做数据图表映射。
- 在 Dashboard 页创建并查看自定义仪表板。
您可以通过查看 基础入门来获取 Kibana 的主要内容介绍。
3.9.2.Kibana 和 Elasticsearch 动态映射
默认情况下，Elasticsearch 启用了字段的 动态映射。Kibana 需要利用动态映射在可视化控件中正确使用字段，同时管理 .kibana 索引，这些索引存储了已保存的搜索、可视化图表和仪表板。
如果 Elasticsearch 使用场景需要禁止动态映射，这就需要手动提供创建可视化控件所需要字段的映射，并手动启用 .kibana 索引的动态映射。
下面的步骤假定 Elasticsearch 中不存在索引 .kibana ，且 elasticsearch.yml 中 index.mapper.dynamic 配置为 false ：
- 启动 Elasticsearch。
-
创建
.kibana索引并只针对该索引打开动态映射：PUT .kibana { "index.mapper.dynamic": true } - 启动 Kibana ，转到 web 页面，确认没有动态映射相关的错误。
3.9.3.使用 Kibana Tribe 节点
Kibana 可以配置连接 Tribe 节点用于数据检索。因为 tribe 节点不能创建索引，Kibana 额外需要一个独立的连接来维护节点状态。当配置好后，搜索和可视化控件会使用 tribe 节点检索数据，管理操作（如保存仪表板）会发送给非 tribe 节点。
3.9.4.配置 Kibana Tribe 节点
当 kibana.yml 中配置了 elasticsearch 时，Tribe 节点使用相同的配置。Tribe 配置的前缀是 elasticsearch.tribe ，至少需要配置一个 url：
elasticsearch.url: "" elasticsearch.tribe.url: " "
当配置了 tribe 节点时，改变 Kibana 状态的操作会发给 elasticsearch.url 配置的地址。搜索和可视化控件会从 elasticsearch.tribe.url 节点检索数据。 elasticsearch.url 配置的节点可以是 tribe 节点所连接集群中的其中一个。
整个配置列表请见 配置 Kibana 。
3.9.5.局限性
由于使用哪个集群会存在歧义，Kibana 一些特性不可用：
- 控制台
- x-pack 插件的用户和角色管理
3.10.生产环境中使用 Kibana
- Kibana 中使用 X-Pack
- 打开 SSL
- Elasticsearch 多节点负载均衡
Kibana 的配置很大程度上依赖于您的使用场景。如果只有自己使用，可以在自己的机器上运行 Kibana，配置它指向任何您想要交互的 Elasticsearch 实例。相反，如果有大量的 Kibana 使用者，需要多个 Kibana 实例连接至同一个 Elasticsearch 节点，来保证负载均衡。
尽管 Kibana 不是非常耗费资源，我们仍然建议运行 Kibana 的节点和 Elasticsearch 数据或主节点分开。在 Elasticsearch 集群中分配 Kibana，可以在 Elasticsearch 客户端节点上运行 Kibana。更多信息请访问 Elasticsearch 多节点负载均衡。
3.10.1.在 Kibana 中使用 X-Pack
使用 X-Pack 安全模块 控制用户通过 Kibana 可以访问哪些 Elasticsearch 数据。
当安装 X-Pack 时，Kibana 用户必须登陆。这些用户需要用 kibana_user 角色来访问通过 Kibana 管理的索引库。
如果一个用户要通过 Kibana 仪表板访问某个索引库中的数据，但没有权限查看，他们会收到一个错误提示：索引不存在。X-Pack 的安全机制目前还不能提供一种方法来控制不同的用户加载不同的仪表板。
关于设置 Kibana 用户和 X-Pack 信息，请参见 X-Pack 安全插件.
3.10.2.启用 SSL
不管是客户端的请求，还是 Kibana 服务端发给 Elasticsearch 的请求，Kibana 都支持 SSL 加密。
要加密浏览器和 Kibana 服务端之间的会话，请配置 kibana.yml 文件中的 server.ssl.enabled 、 server.ssl.certificate 和 server.ssl.key 属性：
# SSL for outgoing requests from the Kibana Server (PEM formatted) server.ssl.enabled: true server.ssl.key: /path/to/your/server.key server.ssl.certificate: /path/to/your/server.crt
如果 Elasticsearch 使用 X-Pack 安全协议或者设置了 HTTPS 代理。您可以设置 Kibana 通过 HTTPS 访问 Elasticsearch，这样 Kibana 服务端和 Elasticsearch 的会话就会被加密。
需要这样的话，就得在配置文件 kibana.yml 中设置 Elasticsearch URL 指定使用 HTTPS 协议：
elasticsearch.url: "https://.com:9200"
如果 Elasticsearch 使用了自签名证书，设置 kibana.yml 文件中的 certificateAuthorities 属性指向 PEM 文件的位置，设置 certificateAuthorities 属性可以使用默认的 verificationMode 选项 full 。
# If you need to provide a CA certificate for your Elasticsearch instance, put # the path of the pem file here. elasticsearch.ssl.certificateAuthorities: [ "/path/to/your/ca/cacert.pem" ]
3.10.4.多个 Elasticsearch 节点间的负载均衡
如果 Elasticsearch 集群有多个节点，分发 Kibana 节点之间请求的最简单的方法就是在 Kibana 机器上运行一个 Elasticsearch 协调（Coordinating only node） 的节点。Elasticsearch 协调节点本质上是智能负载均衡器，也是集群的一部分，如果有需要，这些节点会处理传入 HTTP 请求，重定向操作给集群中其它节点，收集并返回结果。更多详细信息，请参考 节点 部分。
使用本地客户端节点负载均衡 Kibana 请求：
1. 在安装 Kibana 的机器上安装 Elasticsearch。
2. 配置节点为协调节点。在配置文件 elasticsearch.yml 中，设置 node.data 、 node.master 和 node.ingest 为 false ：
# 3. You want this node to be neither master nor data node nor ingest node, but
# to act as a "search load balancer" (fetching data from nodes,
# aggregating results, etc.)
#
node.master: false
node.data: false
node.ingest: false 3. 设置客户端节点接入 Elasticsearch 集群。在配置文件 elasticsearch.yml 中，通过 cluster.name选项设定集群名字。
cluster.name: "my_cluster" 4. 检查 elasticsearch.yml 中的 transport 和 HTTP 主机配置： network.host 和 transport.host。transport.host 需要为集群中其它成员网络可达， network.host 是访问 Kibana 的 HTTP 网络连接(默认为 localhost:9200 )。
network.host: localhost
http.port: 9200
# by default transport.host refers to network.host
transport.host:
transport.tcp.port: 9300 - 9400 5. 请确认 Kibana 设置为指向本地客户端节点。在配置文件 kibana.yml 中，elasticsearch.url 应设为 localhost:9200 。
# The Elasticsearch instance to use for all your queries.
elasticsearch.url: "http://localhost:9200"3.11.升级 Kibana
在升级 Kibana 之前：
- 请参考重要变更文档。
- 在升级生产服务之前请先在测试环境测试升级。
- 使用 Elasticsearch 的 snapshots 特性备份数据。除非存在备份数据，否则版本 不能向前回滚 。
- 如果使用了自定义插件，检查其是否有兼容版本。
从不同的 Kibana 版本进行升级，过程也不相同。请参考以下表格决定需要按照哪个过程进行升级：
| 当前版本 | 目标版本 | 支持的升级类型 |
|---|---|---|
|
|
|
全新安装 |
|
|
|
标准升级及索引重建 |
|
|
|
标准升级 |
|
|
|
标准升级及索引重建 |
|
|
|
标准升级 (where |
只要是从 Kibana 4.1 或 4.0 升级上来的，就需要进行索引重建。
即使您现在运行的 Kibana 版本为 4.2 或更高，如果之前是从 Kibana 4.0 或 4.1 升级过来的，
您仍需要进行一次标准升级及索引重建来升级到 5.x。
这是因为 Elasticsearch 需要对所有在 Elasticsearch 2.0 之前创建的索引进行重建，
哪怕目前工作的版本是 Elasticsearch 2.x。
升级到 5.x 的过程只需要进行一次索引重建。由 Kibana 4.x 保存的查询、视图和仪表板一般兼容 5.x。
3.11.1.标准升级
标准升级是升级 Kibana 最直接的方法，仅支持 4.2 及以上的版本。
如果您之前没有升级过 Kibana，参考该表格来验证您的版本是否支持标准升级。
| 如果您从 Kibana 中保存或导出过依赖 Elasticsearch Query DSL 的对象，确保参考过 Elasticsearch 重要变更文档并且按照其指引进行过必要的修复。 |
3.11.1.1.用 deb 或 rpm 包进行升级
- 在当前系统中使用相应的命令停止当前运行的 Kibana 进程。
- 使用
rpm或dpkg安装新的包。所有的文件应该被放置到相应的位置并且配置文件不应该被覆盖。 - 运用以下方法升级插件：删除已存在的插件，使用
kibana-plugin脚本重新安装相应的版本。参考插件文档获取更多信息。 - 在当前系统中使用相应的命令启动新的 Kibana 进程。
Kibana 4.x 的配置文件路径不同于 5.0+，所以如果您是从 4.x 升级的，
您需要把配置从原有的配置文件(/opt/kibana/config/kibana.yml)拷贝到新的配置文件(/etc/kibana/kibana.yml)。
确保您移动或者升级了重要变更文件中指明的配置项，否则 Kibana 将无法启动。
3.11.1.2.用 zip 或 tar.gz 压缩包进行升级
- 将
zip或tar.gz压缩包解压到一个新的文件夹，确保config或data文件夹没有被覆盖。 - 将原来安装的
config文件夹下的所有文件拷贝到新安装目录中。确保您移动或者升级了重要变更文件中指明的配置项，否则 Kibana 将无法启动。 - 将原来安装的
data文件夹下的所有文件拷贝到新安装目录中。 - 使用
kibana-plugin脚本重新安装相应的版本。参考插件文档获取更多信息。 - 关闭原 Kibana 进程。
- 开启新 Kibana 进程。
3.11.2.重建索引进行标准升级
无论何时对一个含有早于 Elasticsearch 2.0 版本创建的 .kibana 索引的 Kibana 进行升级，都必须在 Elasticsearch 中进行一次索引重建。
例如，从 Kibana 4.1 或 4.0 直接升级或者从之前由 4.1 或 4.0 升级上来的 4.2+ 进行升级。
重建索引是从已有的索引升级语法、映射而创建一个新索引的过程。尽管这支持手动进行，我们仍然推荐使用在 Elasticsearch 重建索引升级指南中提到的 Elasticsearch 迁移插件。
Elasticsearch 迁移插件创建一个新版本的 .kibana 索引并创建一个 索引别名 指向它。
Kibana 5.0 支持这个索引别名，但是如果想在 Elastic stack 升级的过程中运行 Kibana 4.x，就需要配置 4.x 安装时指向该版本索引，
使用 kibana.yml 文件中的 kibana.index 配置项进行配置。一旦重建索引完成了，就可以遵循标准升级的指引继续升级。
3.11.3.全新安装
Kibana 4.0 进行了一次重要的架构重构，导致底层的 .kibana 索引模式改变很大，以至于从 Kibana 3.x 升级需要重建所有的视图、仪表板等。
如果您需要从 3.x 升级，请遵循安装指引来安装 Kibana，然后手动重建查询、视图和仪表板。
3.12.重要变更
在将应用程序从一个版本的 Kibana 迁移到另一个版本时需要注意的变化。
3.12.1. 6.0 版本中的重要更新
1. 不能再继续使用不支持的脚本语言
说明： Kibana 5.x 允许用户使用 Elasticsearch 支持的任何脚本语言创建脚本化的字段。而 Kibana 6.0 将只支持基于 Painless 和 Lucene 表达式的脚本。
影响： 您需要迁移您用 groovy、python、javascript 等脚本创建的字段，将其修改为 Painless 或者 Lucene 的表达式。
2. 修改了状态（status） API 的响应格式
说明： 为了使风格具有一致性，并提供易于理解的响应，状态 API 做了如下修改：
- 属性的名称现在已经使用了 snake case 命名法（名称如果是复合词或者包含短语，各个单词之间用下划线分割，不能有空格），部分属性名称已经做了修改。
- 指标现在提供最新的可用数据，而不是随着时间变化的采样。
影响： 您需要更新使用了状态 API 的地方。
3. Timelion 中需要使用逗号来分割多个查询
说明： Kibana 5.x 的 timelion 中，用户可以使用空格作为查询的分隔符，例如： .es(400) .es(500) ， 现在只有逗号才能作为有效的查询分隔符。例如： .es(400), .es(500) 。
影响： 您需要使用新的语法重写 timelion 中存储的查询。
4. NODE_ENV 环境变量不再影响 Kibana
说明： 设置 NODE_ENV 环境变量有可能会以意想不到的方式中断 Kibana 进程，不幸的是，它往往是系统中的常见设置，您不会希望它导致 Kibana 出现任何异常。 所以，现在 kibana 将会完全忽略 NODE_ENV 环境变量的设置。
影响： 如果您正在开发一个依赖于 NODE_ENV 环境变量的定制化插件，您需要将其更新为依赖另外一个不同名称的的环境变量。
5. 使用 _ 而不是 . 作为分隔符的 Kibana 4.x 式的配置命名规则已经不再被支持
说明： 在 Kibana 4.2 中，我们使用 . 字符作为分隔符替换 _ 字符，重命名了配置文件 kibana.yml 中的所有配置名称，传统方式的配置依然是可以正常工作的。在 5.0 版本中，当遇到传统配置时我们开始记录过期申明。 在 6.0 及其以后版本中，这些使用下划线而不是 . 字符的旧配置名称将不再起作用。
影响： kibana.yml 配置中任何使用下划线字符分割配置名称的地方，都需要更新为当前版本支持的用法。具体用法请参考 配置 Kibana 章节。