查看 Elasticsearch 索引模板编辑

索引模板用于在创建数据流时配置其支持索引。这些索引模板由多个组件模板组成,这些组件模板是可重复使用的构建块,用于配置索引映射、设置和别名。

可以在 Kibana 中查看默认的 APM 索引模板。导航到 堆栈管理索引管理索引模板,并搜索 apm。选择任何 APM 索引模板以查看其相关的组件模板。

编辑 Elasticsearch 索引模板编辑

自定义索引映射可能会与 APM 集成定义的映射冲突,并可能破坏 APM 集成和 Kibana 中的 APM 应用程序。请勿更改或自定义任何默认映射。

安装 APM 集成后,Fleet 会为每个数据流创建一个默认的 @custom 组件模板。您可以编辑此 @custom 组件模板以自定义您的 Elasticsearch 索引。

首先,确定要编辑的 数据流。然后,打开 Kibana 并导航到 堆栈管理索引管理组件模板

自定义组件模板的命名遵循以下模式:<name_of_data_stream>@custom。搜索数据流的名称,例如 traces-apm,并选择其自定义组件模板。在本例中,即 traces-apm@custom。然后单击 管理编辑

添加任何自定义元数据、索引设置或映射。

索引设置编辑

索引设置 步骤中,您可以指定自定义的 索引设置。例如,您可以

  • 自定义应用于数据流的索引生命周期策略。有关详细说明,请参阅 自定义索引生命周期策略
  • 更改每个索引的 分片 数量。指定主分片的数量

    {
      "settings": {
        "number_of_shards": "4",
      }
    }
  • 更改每个索引的 副本 数量。指定副本分片的数量

    {
      "index": {
        "number_of_replicas": "2"
      }
    }
映射编辑

映射 是定义如何存储和索引文档及其包含的字段的过程。在 映射 步骤中,您可以添加自定义字段映射。例如,您可以

  • 添加可以索引和搜索的自定义字段映射。在 映射字段 选项卡中,添加一个包含 字段类型 的新字段

    Editing a component template to add a new mapped field
  • 添加在查询时计算的 运行时字段。在 运行时字段 选项卡中,单击 创建运行时字段 并提供字段名称、类型以及可选的脚本

    Editing a component template to add a new runtime field

滚动数据流编辑

对组件模板的更改不会追溯应用于现有索引。要使更改生效,您必须为数据流创建一个新的写入索引。这可以使用 Elasticsearch 滚动 API 完成。例如,要滚动 traces-apm-default 数据流,请运行

POST /traces-apm-default/_rollover/