Create Indexedit

action: create_index
description: "Create index as named"
options:
  name: ...
Note

Empty values and commented lines will result in the default value, if any, being selected. If a setting is set, but not used by a given action, it will be ignored.

This action creates the named index. There are multiple different ways to configure how the name is represented.

Manual namingedit

action: create_index
description: "Create index as named"
options:
  name: myindex
  # ...

In this case, what you see is what you get. An index named myindex will be created

Python strftimeedit

action: create_index
description: "Create index as named"
options:
  name: 'myindex-%Y.%m'
  # ...

For the create_index action, the name option can contain Python strftime strings. The method for doing so is described in detail, including which strftime strings are acceptable, in the documentation for the name option.

Date Mathedit

action: create_index
description: "Create index as named"
options:
  name: '<logstash-{now/d+1d}>'
  # ...

For the create_index action, the name option can be in Elasticsearch date math format. This allows index names containing dates to use deterministic math to set a date name in the past or the future.

For example, if today’s date were 2017-03-27, the name <logstash-{now/d}> will create an index named logstash-2017.03.27. If you wanted to create tomorrow’s index, you would use the name <logstash-{now/d+1d}>, which adds 1 day. This pattern creates an index named logstash-2017.03.28. For many more configuration options, read the Elasticsearch date math documentation.

Extra Settingsedit

The extra_settings option allows the addition of extra settings, such as index settings and mappings. An example of how these settings can be used to create an index might be:

action: create_index
description: "Create index as named"
options:
  name: myindex
  # ...
  extra_settings:
    settings:
      number_of_shards: 1
      number_of_replicas: 0
    mappings:
      type1:
        properties:
          field1:
            type: string
            index: not_analyzed

Required settingsedit

Optional settingsedit

Tip

See an example of this action in an actionfile here.