Отладка ошибок управления жизненным циклом индексов

Когда ILM выполняет политику жизненного цикла, могут возникнуть ошибки при выполнении необходимых операций над индексом на определенном шаге. В таком случае ILM переводит индекс в состояние ERROR. Если ILM не может автоматически устранить ошибку, выполнение останавливается до устранения проблем с политикой, индексом или кластером.

Например, у вас может быть политика shrink-index, которая уменьшает индекс до четырёх фрагментов, когда ему исполнится не менее пяти дней:

PUT _ilm/policy/shrink-index
{
  "policy": {
    "phases": {
      "warm": {
        "min_age": "5d",
        "actions": {
          "shrink": {
            "number_of_shards": 4
          }
        }
      }
    }
  }
}

Ничто не мешает применить политику shrink-index к новому индексу, у которого всего два фрагмента:

PUT /my-index-000001
{
  "settings": {
    "index.number_of_shards": 2,
    "index.lifecycle.name": "shrink-index"
  }
}

Через пять дней ILM пытается уменьшить my-index-000001 с двух фрагментов до четырёх. Поскольку действие уменьшения не может увеличить количество фрагментов, эта операция завершается ошибкой, и ILM переводит my-index-000001 в состояние ERROR.

Вы можете использовать API ILM Explain для получения информации о том, что пошло не так:

GET /my-index-000001/_ilm/explain

Что возвращает следующую информацию:

{
  "indices" : {
    "my-index-000001" : {
      "index" : "my-index-000001",
      "managed" : true,
      "policy" : "shrink-index",                
      "lifecycle_date_millis" : 1541717265865,
      "age": "5.1d",                            
      "phase" : "warm",                         
      "phase_time_millis" : 1541717272601,
      "action" : "shrink",                      
      "action_time_millis" : 1541717272601,
      "step" : "ERROR",                         
      "step_time_millis" : 1541717272688,
      "failed_step" : "shrink",                 
      "step_info" : {
        "type" : "illegal_argument_exception",  
        "reason" : "the number of target shards [4] must be less that the number of source shards [2]"
      },
      "phase_execution" : {
        "policy" : "shrink-index",
        "phase_definition" : {                  
          "min_age" : "5d",
          "actions" : {
            "shrink" : {
              "number_of_shards" : 4
            }
          }
        },
        "version" : 1,
        "modified_date_in_millis" : 1541717264230
      }
    }
  }
}

Чтобы исправить это, вы можете обновить политику, чтобы уменьшить индекс до одного фрагмента через 5 дней:

PUT _ilm/policy/shrink-index
{
  "policy": {
    "phases": {
      "warm": {
        "min_age": "5d",
        "actions": {
          "shrink": {
            "number_of_shards": 1
          }
        }
      }
    }
  }
}

После устранения проблемы, которая поместила индекс в состояние ERROR, вам может потребоваться явно попросить ILM повторить этот шаг:

POST /my-index-000001/_ilm/retry

ILM затем пытается повторно выполнить не удавшийся шаг. Вы можете отслеживать прогресс с помощью API ILM Explain.

Вот как устранить наиболее распространенные ошибки, сообщаемые на шаге ERROR.

Целевой алиас rollover указан в настройке шаблона индекса index.lifecycle.rollover_alias. Вам нужно явно настроить этот алиас один раз, когда вы инициализируете начальный индекс. Затем действие rollover управляет настройкой и обновлением алиаса для перехода к каждому последующему индексу.

Не настраивайте этот же алиас в разделе алиасов шаблона индекса.

Индекс использует неправильный алиас или алиас не существует.

Проверьте index.lifecycle.rollover_alias настройку индекса. Чтобы посмотреть, какие алиасы настроены, используйте _cat/aliases.

Настройка index.lifecycle.rollover_alias должна быть настроена для работы действия rollover.

Обновите настройки индекса, чтобы установить index.lifecycle.rollover_alias.

Только один индекс может быть назначен в качестве пишущего для конкретного алиаса.

Используйте API алиасов, чтобы установить is_write_index:false для всех индексов, кроме одного.

Имя индекса должно соответствовать регулярному выражению ^.*-\d+ для работы действия rollover. Наиболее распространённая проблема — имя индекса не содержит заключительных цифр. Например, my-index не соответствует требованию шаблона.

Добавьте числовое значение к имени индекса, например, my-index-000001.

Это указывает на то, что кластер сталкивается с ограничениями ресурсов.

Прежде чем продолжать настройку ILM, необходимо принять меры по устранению проблем с ресурсами. Дополнительную информацию см. в разделе об ошибках разрыва цепи.

Это указывает на то, что кластеру не хватает дискового места. Это может произойти, если вы не настроили управление жизненным циклом индексов для перехода с узлов "горячие" на узлы "тёплые".

Рассмотрите возможность добавления узлов, обновления оборудования или удаления ненужных индексов.

Это указывает на то, что действие ILM не может быть выполнено, потому что у пользователя, используемого ILM для выполнения действия, нет соответствующих привилегий. Это может произойти, когда привилегии пользователя были сняты после обновления политики ILM. Действия ILM выполняются так, как будто их выполнил последний пользователь, который изменял политику. Учётная запись, используемая для создания или изменения политики, должна иметь права на выполнение всех операций, которые являются частью этой политики.