- Curator Index Management:
- Curator and Index Lifecycle Management
- About
- Versions
- Installation
- Running Curator
- Configuration
- Actions
- Options
- allocation_type
- allow_ilm_indices
- include_hidden
- continue_if_exception
- copy_aliases
- count
- delay
- delete_after
- delete_aliases
- skip_flush
- disable_action
- extra_settings
- ignore_empty_list
- ignore_unavailable
- include_aliases
- include_global_state
- indices
- key
- max_age
- max_docs
- max_size
- max_num_segments
- max_wait
- migration_prefix
- migration_suffix
- name
- new_index
- node_filters
- number_of_replicas
- number_of_shards
- partial
- post_allocation
- preserve_existing
- refresh
- remote_certificate
- remote_client_cert
- remote_client_key
- remote_filters
- remote_url_prefix
- rename_pattern
- rename_replacement
- repository
- requests_per_second
- request_body
- retry_count
- retry_interval
- routing_type
- search_pattern
- setting
- shrink_node
- shrink_prefix
- shrink_suffix
- slices
- skip_repo_fs_check
- timeout
- timeout_override
- value
- wait_for_active_shards
- wait_for_completion
- wait_for_rebalance
- wait_interval
- warn_if_no_indices
- Filters
- Filter Elements
- aliases
- allocation_type
- count
- date_from
- date_from_format
- date_to
- date_to_format
- direction
- disk_space
- epoch
- exclude
- field
- intersect
- key
- kind
- max_num_segments
- pattern
- period_type
- range_from
- range_to
- reverse
- source
- state
- stats_result
- timestring
- threshold_behavior
- unit
- unit_count
- unit_count_pattern
- use_age
- value
- week_starts_on
- Examples
- Frequently Asked Questions
name
editname
editThis setting is used by the alias, create_index and snapshot, actions.
The value of this setting is the name of the alias, snapshot, or index,
depending on which action makes use of name.
date math
editThis setting may be a valid Elasticsearch date math string.
A date math name takes the following form:
<static_name{date_math_expr{date_format|time_zone}}>
|
is the static text part of the name |
|
is a dynamic date math expression that computes the date dynamically |
|
is the optional format in which the computed date should be rendered. Defaults to |
|
is the optional time zone . Defaults to |
The following example shows different forms of date math names and the final form they resolve to given the current time is 22rd March 2024 noon utc.
| Expression | Resolves to |
|---|---|
|
|
|
|
|
|
|
|
|
|
strftime
editThis setting may alternately contain a valid Python strftime string. Curator will extract the strftime identifiers and replace them with the corresponding values.
The identifiers that Curator currently recognizes include:
| Unit | Value |
|---|---|
|
4 digit year |
|
2 digit year |
|
2 digit month |
|
2 digit week of the year |
|
2 digit day of the month |
|
2 digit hour of the day, in 24 hour notation |
|
2 digit minute of the hour |
|
2 digit second of the minute |
|
3 digit day of the year |
action: alias description: "Add/Remove selected indices to or from the specified alias" options: name: alias_name add: filters: - filtertype: ... remove: filters: - filtertype: ...
This option is required by the alias action, and has no default setting in that context.
For the create_index action, there is no default setting, but you can use strftime:
action: create_index description: "Create index as named" options: name: 'myindex-%Y.%m' # ...
or use Elasticsearch date math
action: create_index description: "Create index as named" options: name: '<logstash-{now/d+1d}>' # ...
to name your indices. See more in the create_index documenation.
action: snapshot description: >- Snapshot selected indices to 'repository' with the snapshot name or name pattern in 'name'. Use all other options as assigned options: repository: my_repository name: include_global_state: True wait_for_completion: True max_wait: 3600 wait_interval: 10 filters: - filtertype: ...
For the snapshot action, the default value of this setting is
curator-%Y%m%d%H%M%S