Diagnosticar un paso ILM atascado y reintentarlo (_ilm/explain, _ilm/retry)

Comando

# Indices waiting in an error step:
GET log-*/_ilm/explain?only_errors=true
# Phase/action/step state and failure reason for one index:
GET log-000003/_ilm/explain?filter_path=indices.*.phase,indices.*.action,indices.*.step,indices.*.failed_step,indices.*.step_info,indices.*.is_auto_retryable_error
# After fixing the cause (example: missing rollover alias setting):
PUT log-000003/_settings
{
  "index.lifecycle.rollover_alias": "log"
}
POST log-000003/_ilm/retry
# Is ILM running (if STOPPED, POST _ilm/start):
GET _ilm/status

Qué hace

Muestra los índices que esperan en el paso ERROR, en qué fase/acción/paso están atascados y el motivo del fallo (step_info); vuelve a ejecutar el paso fallido una vez corregida la causa.

Cuándo usarlo

Cuando no se produce el rollover, no se borran los índices antiguos o el disco se llena con índices que ILM debería haber eliminado.

Precaución

_ilm/retry solo funciona para índices en el paso ERROR; de lo contrario devuelve 'has not encountered an error'. Causas comunes: falta el ajuste rollover_alias o el alias tiene is_write_index en otro índice, no hay disco suficiente en un solo nodo para el shrink, una regla de asignación (_tier_preference) no puede cumplirse. Borrar la política no quita la gestión de ILM de los índices; quite primero el ajuste de política de los índices.