Настройка политики жизненного цикла

Для управления индексом с помощью ILM необходимо указать действительную политику в настройке индекса index.lifecycle.name.

Чтобы настроить политику жизненного цикла для переролирования индексов, создайте политику и добавьте её в шаблон индекса.

Чтобы использовать политику для управления индексом, который не переролируется, вы можете указать политику жизненного цикла при создании индекса или применить политику непосредственно к существующему индексу.

Политики ILM хранятся в глобальном состоянии кластера и могут быть включены в снимки, установив include_global_state на значение true при создании снимка. При восстановлении снимка все политики из глобального состояния восстанавливаются, и любые локальные политики с одинаковыми именами перезаписываются.

Чтобы создать политику жизненного цикла из Kibana, откройте меню и перейдите к Управление стеком > Политики жизненного цикла индексов. Нажмите Создать политику.

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

API создания или обновления политики вызывается для добавления политики в кластер Elasticsearch.

PUT _ilm/policy/my_policy
{
  "policy": {
    "phases": {
      "hot": {
        "actions": {
          "rollover": {
            "max_primary_shard_size": "25GB" 
          }
        }
      },
      "delete": {
        "min_age": "30d",
        "actions": {
          "delete": {} 
        }
      }
    }
  }
}

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

Вы можете использовать мастер создания шаблонов Kibana для создания шаблона. Чтобы получить доступ к мастеру, откройте меню и перейдите к Управление стеком > Управление индексами. На вкладке Шаблоны индексов нажмите Создать шаблон.

Мастер вызывает API создания или обновления шаблона индекса для добавления шаблонов в кластер.

PUT _index_template/my_template
{
  "index_patterns": ["test-*"], 
  "template": {
    "settings": {
      "number_of_shards": 1,
      "number_of_replicas": 1,
      "index.lifecycle.name": "my_policy", 
      "index.lifecycle.rollover_alias": "test-alias" 
    }
  }
}

При настройке политик для собственных переролируемых индексов необходимо вручную создать первый индекс, управляемый политикой, и назначить его индексом записи.

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

Например, следующий запрос создает индекс test-00001. Поскольку он соответствует шаблону индекса, указанному в my_template, Elasticsearch автоматически применяет настройки из этого шаблона.

PUT test-000001
{
  "aliases": {
    "test-alias":{
      "is_write_index": true 
    }
  }
}

Теперь вы можете начать индексирование данных в псевдоним переролирования, указанный в политике жизненного цикла. С помощью политики my_policy, действие переролирования запускается, когда начальный индекс превышает 25 ГБ. ILM затем создает новый индекс, который становится индексом записи для test-alias.

Вы можете указать политику при создании индекса или применить политику к существующему индексу через Kibana или API обновления настроек. При применении политики ILM сразу же начинает управлять индексом.

Настройка index.lifecycle.name указывает политику индекса.

PUT test-index
{
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas": 1,
    "index.lifecycle.name": "my_policy" 
  }
}

Вы можете применить одну и ту же политику к нескольким индексам, используя подстановочные знаки в имени индекса при вызове API обновления настроек.

PUT mylogs-pre-ilm*/_settings 
{
  "index": {
    "lifecycle": {
      "name": "mylogs_policy_existing"
    }
  }
}

Чтобы переключить политику жизненного цикла индекса, выполните следующие шаги: