导入现有 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
命令从 kibana
目录导入仪表板,该目录在 Beat 包中可用。
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
每个 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-*
。