This is a Technical Preview and should not yet be used in production.

How Automated Index Management Works

Automated Index Management can be used to create policies that perform management operations on indices automatically based on index stats.

A policy acts as a template that describes the lifecycle of one, or multiple, indices. Once an index with a policy assigned is created, AIM internally creates a policy instance with a corresponding state for this index. The state can now be retrieved using the state API.

If not otherwise configured (see execution.period in the settings section), AIM automatically checks every 5 minutes for each managed index if one condition of the current step is met. If one condition is met all actions of the current step get executed in their defined order and the next step is entered.

Technical Preview Version Download

The Technical Preview version is available here

Building Blocks of a Policy

• steps define a set of actions and conditions that should be executed. Every step must contain at least one condition or action
  • name which represents the step. Every step must have a policy wide unique name
  • conditions analyzing the status of the index that should be checked once the step is triggered
  • actions that should be executed sequentially once at least one condition is met

Assigning a Policy

A Policy is assigned to an index on index creation in the index settings. It is recommended to use index or component templates in combination with AIM.

PUT /_index_template/my-index-template
{
  "index_patterns": [
    "my-index*"
  ],
  "template": {
    "settings": {
      "index.aim.policy_name": "my-policy"
    }
  }
}

Assigning a Policy with rollover action

If the policy also uses the rollover action, a write alias has to be configured.

PUT /_index_template/my-rolling-index-template
{
  "index_patterns": [
    "my-rolling-index*"
  ],
  "template": {
    "settings": {
      "index.aim.policy_name": "my-rollover-policy",
      "index.aim.rollover_alias": "my-write-alias"
    }
  }
}

Once the template is set up an index with a write alias using this template can be created.

PUT /my-rolling-index-000001
{
  "aliases": {
    "my-write-alias": {
      "is_write_index": true
    }
  }
}

---

---

Not what you were looking for? Try the search.