ES索引模板.md

filebeat.yml配置文件的setup.template部分指定用于在Elasticsearch中设置映射的索引模板。如果启用了模板加载（默认），FileBeat会在成功连接到Elasticsearch后自动加载索引模板。

加载索引模板需要连接到Elasticsearch。如果配置的输出不是Elasticsearch（或Elasticsearch Service），则必须手动加载模板。

您可以调整以下设置以加载您自己的模板或覆盖现有模板。

setup.template.enabled

设置为false以禁用模板加载。如果设置为false，则必须手动加载模板。

setup.template.name

模板的名称。默认值是 filebeat。The Filebeat version is always appended to the given name, so the final name is filebeat-%{[agent.version]}.

setup.template.pattern

要应用于默认索引设置的模板模式。默认模式是filebeat。FileBeat版本始终包含在模式中，因此最终模式是filebeat-%{[agent.version]}。

示例：

setup.template.name: "filebeat"
setup.template.pattern: "filebeat"

setup.template.fields

描述字段的YAML文件的路径。默认为fields.yml。如果设置了相对路径，则将其视为相对于配置路径。有关详细信息，请参阅目录布局部分。

setup.template.overwrite

指定是否覆盖现有模板。默认值为false。如果您同时启动多个FileBeat实例，请不要启用此选项。它会通过发送过多的模板更新请求来重载Elasticsearch。

setup.template.settings

要放入Elasticsearch模板settings.index字典的设置字典。有关可用Elasticsearch映射选项的更多详细信息，请参阅Elasticsearch映射参考。

示例：

setup.template.name: "filebeat"
setup.template.fields: "fields.yml"
setup.template.overwrite: false
setup.template.settings:
  index.number_of_shards: 1
  index.number_of_replicas: 1

setup.template.settings._source

_source字段的设置字典。有关可用设置，请参阅Elasticsearch参考。

示例：

setup.template.name: "filebeat"
setup.template.fields: "fields.yml"
setup.template.overwrite: false
setup.template.settings:
  _source.enabled: false

setup.template.append_fields

要添加到模板和Kibana索引模式的字段列表。此设置添加新字段。它不会覆盖或更改现有字段。

当您的数据包含FileBeat事先不知道的字段时，此设置很有用。

如果在指定append_fields的同时还指定了overwrite: true，则FileBeat将覆盖现有模板，并在创建新索引时应用新模板。现有索引不受影响。如果使用不同的append_fields设置运行多个FileBeat实例，则编写模板的最后一个实例优先。

对此设置的任何更改也会影响Kibana索引模式。

示例配置：

setup.template.overwrite: true
setup.template.append_fields:
- name: test.name
  type: keyword
- name: test.hostname
  type: long

setup.template.json.enabled

设置为true以加载基于JSON的模板文件。指定Elasticsearch索引模板文件的路径并设置模板的名称。

setup.template.json.enabled: true
setup.template.json.path: "template.json"
setup.template.json.name: "template-name"
setup.template.json.data_stream: false

如果使用JSON模板，则跳过模板生成的fields.yml。

如果JSON模板是数据流，则设置setup.template.json.data_stream。