模板

要创建索引模板，请完成以下步骤

1. 使用导航菜单或全局搜索字段转到 Index Management 页面。

2. 在 索引模板 (Index Templates) 选项卡中，选择 创建模板 (Create template)。

   

3. 在 Logistics 页面上

   1. 为模板指定名称。

   2. 指定一个模式来匹配您要使用生命周期策略管理的索引。例如，my-index-*。请注意 避免命名模式冲突 与内置的 Elasticsearch 索引模板。

   3. 如果您正在存储持续生成且仅追加（append-only）的数据，您可以选择创建 数据流 而不是索引，以实现更高效的存储。

      注意

      当您启用数据流选项时，设置 数据保留 的选项也会变为可用。数据保留仅在您使用数据流生命周期时适用，它是索引生命周期管理的一种替代方案。有关详细信息，请参阅 数据流生命周期。

   4. 配置您想要的任何其他选项，包括

      • 用于所创建索引的 索引模式。
      • 模板优先级、版本和任何元数据。
      • 是否覆盖 action.auto_create_index 集群设置。

      有关这些选项的详细信息，请参阅 创建或更新索引模板 API 文档。

4. 在 组件模板 页面上，您可以使用搜索和过滤工具来选择要包含在索引模板中的任何 组件模板。索引模板将继承在组件模板中定义的设置 (S)、映射 (M) 和别名 (A)，并在创建索引时将其应用于索引。

5. 在 索引设置 页面上，您可以直接在索引模板中定义索引设置。当与组件模板一起使用时，在此页面上定义的映射将覆盖关联组件模板中的任何冲突定义。

   1. 可选：添加在创建索引时应应用于索引的任何其他 索引设置。例如，您可以设置每个索引的分片数和副本数，以及通过指定 ILM 设置 来配置 ILM 以应用于这些索引。

      {
        "index.lifecycle.name": "my_policy",
        "index.lifecycle.rollover_alias": "test-alias",
        "number_of_shards": 1,
        "number_of_replicas": 1
      }
      		

6. 可选：在 映射 页面上，自定义将文档索引到 Elasticsearch 时使用的字段和数据类型。当与组件模板一起使用时，这些映射会覆盖关联组件模板中的任何冲突定义。有关详细信息，请参阅 映射。

   1. 例如，您可以定义一个映射，其中包含一个名为 geo 的 对象 字段，以及一个名为 coordinates 的子 geo_point 字段。

      或者，您可以单击 加载 JSON 链接并将映射定义为 JSON

      {
        "properties": {
          "geo": {
            "properties": {
              "coordinates": {
                "type": "geo_point"
              }
            }
          }
        }
      }
      		

7. 可选：在 别名 页面上，为每个创建的索引指定一个 别名。例如，您可以定义一个名为 my-index 的别名。

   {
    "my-index": {}
   }
   		

   请注意，在配置 ILM 时这不是必需的，ILM 会使用 index.lifecycle.rollover_alias 设置来访问滚动索引。

8. 在 审阅 页面上，确认您的选择并选择 创建模板。您可以检查所选选项，以及将要创建的索引模板格式和关联的 API 请求。

新创建的索引模板将用于所有名称匹配指定模式的新索引，并且对于其中的每一个索引，都将应用指定的 ILM 策略。

使用 创建或更新索引模板 API 将索引模板添加到集群。

以下请求创建了一个索引模板，该模板由 组件模板 示例中显示的两个组件模板组成。

				PUT _index_template/template_1
					{
  "index_patterns": ["te*", "bar*"],
  "template": {
    "settings": {
      "number_of_shards": 1
    },
    "mappings": {
      "_source": {
        "enabled": true
      },
      "properties": {
        "host_name": {
          "type": "keyword"
        },
        "created_at": {
          "type": "date",
          "format": "EEE MMM dd HH:mm:ss Z yyyy"
        }
      }
    },
    "aliases": {
      "mydata": { }
    }
  },
  "priority": 501,
  "composed_of": ["component_template1", "runtime_component_template"],
  "version": 3,
  "_meta": {
    "description": "my custom"
  }
}
		

1. 选择可以 避免冲突 与内置 Elasticsearch 索引模板的模式。

您可以在 Kibana 的 索引管理 页面上创建、编辑、克隆和删除您的组件模板。请转到 组件模板 选项卡。

×

• 要显示详细信息并执行操作，请单击模板名称。
• 要创建新的组件模板，请使用 创建组件模板 向导。

您可以使用 组件模板 API 创建和管理组件模板。以下请求创建了上一个索引模板示例中使用的两个组件模板

				PUT _component_template/component_template1
					{
  "template": {
    "mappings": {
      "properties": {
        "@timestamp": {
          "type": "date"
        }
      }
    }
  }
}
				PUT _component_template/runtime_component_template
					{
  "template": {
    "mappings": {
      "runtime": {
        "day_of_week": {
          "type": "keyword",
          "script": {
            "source": "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))"
          }
        }
      }
    }
  }
}
		

1. 当新索引匹配该模板时，此组件模板会将名为 day_of_week 的 运行时字段 添加到映射中。