首页/数据/NoSQL 速查/ILM explain 查看索引所处阶段
Elasticsearch89 条

ILM explain 查看索引所处阶段

ILM explain 显示每个索引当前所在 phase、action、step 与可能的错误,用来回答"为什么这个索引没有按期滚动或删除"。

NoSQL 速查数据更新于 2026-10-12
接口GET /<index>/_ilm/explain
关键字段phase、action、step、age、policy、failed_step 与 step_info
常用参数only_errors=true 只看异常,only_managed=true 只看受策略管理的索引

示例

示例
GET /logs-*/_ilm/explain?only_errors=true
GET /logs-2024.07.01/_ilm/explain
滚动卡住时常见原因是索引名不匹配模板、缺少写别名或 shard 数不符合 shrink 条件。

易错点

  • 错误修复后 ILM 不一定自动重试当前 step,必要时用 POST /<index>/_ilm/retry 手动重试
  • 只加说明不排错:先看 step_info 的具体 message 再动手改配置

数据来源与参考

  • Elasticsearch Guide: Explain lifecycle API
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌