导入现有 Beat 仪表板

导入现有 Beat 仪表板编辑

官方 Beats 附带 Kibana 仪表板，从 6.0.0 版本开始，它们是每个 Beat 软件包的一部分。

您可以使用 Beat 可执行文件导入 Beat 的所有仪表板和索引模式，包括可视化和搜索等依赖项。

要导入仪表板，请运行 setup 命令。

./metricbeat setup

setup 阶段会加载多个依赖项，例如：

Elasticsearch 中的索引映射模板
Kibana 仪表板
摄取管道
ILM 策略

依赖项因您要设置的 Beat 而异。

有关 setup 命令的更多详细信息，请参阅命令行帮助。例如：

./metricbeat help setup

This command does initial setup of the environment:

 * Index mapping template in Elasticsearch to ensure fields are mapped.
 * Kibana dashboards (where available).
 * ML jobs (where available).
 * Ingest pipelines (where available).
 * ILM policy (for Elasticsearch 6.5 and newer).

Usage:
  metricbeat setup [flags]

Flags:
      --dashboards         Setup dashboards
  -h, --help               help for setup
      --index-management   Setup all components related to Elasticsearch index management, including template, ilm policy and rollover alias
      --pipelines          Setup Ingest pipelines

当您不想加载所有内容时，这些标志很有用。例如，要仅导入仪表板，请使用 --dashboards 标志。

./metricbeat setup --dashboards

从 Beats 6.0.0 开始，仪表板不再直接加载到 Elasticsearch 中。而是直接导入到 Kibana 中。因此，如果您的 Kibana 实例未在 localhost 上监听，或者您为 Kibana 启用了 X-Pack，则需要在 Beat 的配置中配置 Kibana 端点，或者将 Kibana 主机和凭据作为参数传递给 setup 命令。例如：

./metricbeat setup -E setup.kibana.host=192.168.3.206:5601 -E setup.kibana.username=elastic -E setup.kibana.password=secret

默认情况下，setup 命令从 Beat 软件包中提供的 kibana 目录导入仪表板。

保存的仪表板的格式在 Kibana 5.x 和 6.x 之间不兼容。因此，Kibana 5.x 仪表板在 5.x 目录中可用，而 Kibana 6.0 及更早版本的仪表板在 default 目录中可用。

如果您使用的是自定义仪表板，则可以导入它们：

从本地目录

./metricbeat setup -E setup.dashboards.directory=kibana

从本地 zip 存档

./metricbeat setup -E setup.dashboards.file=metricbeat-dashboards-6.0.zip

从在线提供的 zip 存档
```
./metricbeat setup -E setup.dashboards.url=path/to/url
```
有关 setup.dashboards 配置选项的说明，请参阅Kibana 仪表板配置。

导入用于开发的仪表板编辑

您可以使用 Beat GitHub 存储库中的 Magefile 导入仪表板。如果 Kibana 在 localhost 上运行，则可以从 Beat 的根目录运行以下命令：

mage dashboards

Kibana 仪表板配置编辑

每个 Beat 的配置文件 (*.reference.yml) 都包含 setup.dashboards 部分，用于配置从何处获取 Kibana 仪表板以及索引模式的名称。可以使用 -E 标志通过命令行选项覆盖这些配置选项中的每一个。

setup.dashboards.directory=<local_dir>: 包含已保存的仪表板及其依赖项的本地目录。默认值为 Beat 软件包中提供的 kibana 目录。
setup.dashboards.file=<local_archive>: 包含仪表板的本地 zip 存档。该存档可以包含单个 Beat 或多个 Beat 的 Kibana 仪表板。每个 Beat 的仪表板都放在一个单独的目录下，目录名称为 Beat 的名称。
setup.dashboards.url=<zip_url>: 包含仪表板的在线 zip 存档。该存档可以包含单个 Beat 或多个 Beat 的 Kibana 仪表板。每个 Beat 的仪表板都放在一个单独的目录下，目录名称为 Beat 的名称。
setup.dashboards.index <elasticsearch_index>: 仅当您要更改默认使用的索引模式名称时，才应使用此选项。例如，如果默认值为 metricbeat-*，则可以将其更改为 custombeat-*。

« 为 Beat 或 Beat 模块创建新的 Kibana 仪表板构建您自己的 Beat 仪表板 »