ElasticSearch中的索引模板详解

• 标准化配置：统一同一类索引的分片数、副本数、刷新间隔等设置
• 自动映射：提前定义字段类型、分词器、是否索引等属性，避免动态映射产生错误
• 简化操作：创建索引时自动应用配置，无需每次重复写参数
• 生命周期管理：配合ILM（索引生命周期管理）实现索引的自动轮转、删除等操作

从Elasticsearch 7.8版本开始，引入了可组合索引模板（Composable Index Template） 和 组件模板（Component Template），同时兼容旧版模板（Legacy Index Template）：

⚠️ 注意：旧版模板在8.x版本中已经被移除，建议7.x版本开始使用新的可组合模板体系

为什么需要索引模板？
ES的索引创建默认会自动推断字段类型（动态mapping），但生产环境往往需要统一规范：

• 所有日志类索引统一设置1分片1副本，不需要每次创建索引手动指定
• 所有字符串类型字段默认同时创建text（全文检索）和keyword（精确匹配）两个类型
• 所有时间字段统一用date类型，指定时间格式
• 业务专有字段统一使用IK分词器如果不用模板，每次创建新索引都要手动写一遍配置，不仅麻烦还容易出错，尤其适合按时间滚动的索引场景（比如日志、监控指标，每天/每小时生成一个新索引：log-2026.04.20、metric-2026.04.20）。

回到顶部

旧版索引模板创建实战案例

旧版索引模板比较简单粗暴，它是直接为一类索引定义了一个模板，后续直接使用即可

创建一个日志场景的索引模板

查看旧版本索引模板

旧版本索引模板的删除和更新

创建索引测试

回到顶部

新版本索引模板实战案例

新版本索引模板是在ES7.8版本开始引入的，新版本索引模板又称为可组合索引模板，其主要有以下部分组成：

• 组件模板
• 可组合索引模板
• 优先级规则

接下来我们一个一个讲解

组件模板

组件模板是可复用的配置单元，通常按功能拆分，比如：

• 通用设置组件：配置分片数、副本数
• 通用映射组件：配置的类型和分词器
• 别名组件：配置统一的查询别名

创建各类型组件模板

• 通用设置组件

• 通用映射组件

• 通用别名组件

组件模板其它运维操作

• 查询组件模板

• 删除组件模板

• 修改组件模板

可组合索引模板

可组合索引模板是真正给创建索引时使用的，其由三部分组成：

• 匹配规则：index_patterns 定义哪些索引会匹配这个模板，支持通配符，比如"logs-*"
• 优先级：priority 数值越大优先级越高，当多个模板匹配同一个索引时，高优先级的模板生效
• 配置来源：
  • composed_of：引用的组件模板列表，按顺序叠加配置
  • template：直接在索引模板中定义的配置，优先级高于引用的组件模板

创建一个可组合索引模板

创建日志索引模板，匹配 logs-* 索引，组合上述组件模板，并补充个性化配置。

查看新版本索引模板

新版本索引模板的删除和更新

创建一个索引测试

回到顶部

动态模板

动态模板是自定义未知字段的映射规则，解决默认动态映射的不确定性（如字符串被自动设为 text + keyword，浪费资源）

创建动态模板示例

所有字符串字段自动映射为 keyword，以 env_ 开头的字段不索引，减少存储开销。

匹配规则说明：

回到顶部

索引模板与索引生命周期管理（ILM）集成

索引生命周期管理（ILM）详解

ILM（Index Lifecycle Management） 是 ES 7.x 用于自动管理时序类索引（日志、指标、事件） 从创建、写入、查询、归档到删除全流程的核心功能，核心价值是自动实现热温冷架构、节省存储成本、优化性能、免人工运维。

ILM 通过定义 生命周期策略（Policy），让 ES 自动判断索引 “年龄、大小、文档数”，驱动索引在不同阶段流转，并执行滚动、收缩、合并、迁移、删除等操作

适用于日志（logs-）、监控指标（metrics-）、事件（events-*）等只追加、少更新、查询热度随时间递减的数据。

ILM核心三要素：

• 生命周期策略（Policy）：ILM 的 “规则手册”，定义阶段、触发条件、执行动作。
• 索引模板（Index Template）：将 Policy 绑定到索引，新创建的匹配索引自动应用。
• 索引 / 数据流（Data Stream）：被管理的对象，数据流更适合时序场景（7.x 推荐）

ILM 五大生命周期阶段（Phases）详解

ILM把索引的生命周期分为五个阶段： Hot → Warm → Cold → Frozen → Delete 顺序流转，每个阶段有明确定位、触发条件和允许动作

每个阶段之间的流转是有固定规则的：

• 流转依据：min_age（最小年龄），从 索引创建时间 或 Rollover 时间 计算。
• 流转条件：当前阶段所有动作执行完成 + 达到下一阶段 min_age。
• 顺序固定：只能按 Hot→Warm→Cold→Frozen→Delete 单向流转，不可回退

Hot阶段（热阶段）—— 核心写入 + 高频查询

这个阶段是索引刚创建完成且数据正在写入、实时高频查询，数据最活跃

• 定位：索引正在写入、实时高频查询，数据最活跃。
• 硬件：高性能 SSD 节点、高内存、高 CPU。
• 默认触发：索引创建即进入（min_age: 0ms）。
• 核心目标：保障写入性能、稳定查询、触发滚动（Rollover）。
• 常用动作：
  • rollover（核心）：索引达阈值自动切新索引
  • set_priority：设高优先级（如 100）
  • unfollow：跨集群复制场景取消跟随

Warm 阶段（温阶段）—— 只读 + 中频查询

这个阶段索引中数据不再写入，仅用于查询

• 定位：停止写入、仍频繁查询，数据不再更新。
• 硬件：普通 SATA/HDD 节点、中等配置。
• 触发：Rollover 后或达到指定时长（如 7 天）。
• 核心目标：优化存储、提升查询效率、降资源占用。
• 常用动作：
  • readonly：设为只读，防误写
  • forcemerge：合并段文件，删删除标记
  • shrink：收缩主分片（如 5→1）
  • allocate：迁移到温节点、降副本数
  • set_priority：降优先级（如 50）

Cold 阶段（冷阶段）—— 极少查询 + 归档

这个阶段查询很少，但是数据仍需保留一段时间

• 定位：不写、极少查询，需保留但允许慢查询。
• 硬件：廉价大容量存储、低配置节点。
• 触发：进入 Warm 后 N 天（如 30 天）。
• 核心目标：极致省存储、最小化资源占用。
• 常用动作：
  • allocate：迁冷节点、副本数设 0
  • freeze：冻结索引（卸载内存、只读）
  • searchable_snapshot：转为可搜索快照（7.10+）
  • set_priority：最低优先级（如 0）

Frozen 阶段（冻结阶段，7.7+）—— 超冷归档

• 定位：几乎不查询、必须留存，查询极慢也可接受。
• 硬件：对象存储 / 远程仓库，几乎不占本地资源。
• 触发：进入 Cold 后 N 天（如 60 天）。
• 核心动作：searchable_snapshot（基于快照搜索，本地几乎不占资源）

Delete 阶段（删除阶段）—— 数据销毁

• 定位：数据过期、无需留存，安全删除。
• 触发：进入前一阶段后 N 天（如 90 天）。
• 核心动作：delete：永久删除索引 + 数据。
• 可选：wait_for_snapshot：先备份快照再删

实战案例

创建ILM策略

描述：
Hot：50GB 或 7 天 Rollover
Warm：Rollover 后 1 天进入，缩分片、合并段
Cold：Warm 后 30 天进入，降副本、迁冷节点
Delete：Cold 后 60 天删除（总留存 90 天）

创建可组合索引模板

• 创建组件模板

• 创建可组合索引模板

ILM常用管理命令

• 查看ILM

• 查看索引 ILM 状态

• 手动触发 Rollover

• 删除 ILM 策略