The Open Distro project is archived. Open Distro development has moved to OpenSearch. The Open Distro plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.

Settings

The asynchronous search plugin adds several settings to the standard Elasticsearch cluster settings. They are dynamic, so you can change the default behavior of the plugin without restarting your cluster. You can mark the settings as persistent or transient.

For example, to update the retention period of the result index:

PUT _cluster/settings
{
  "transient": {
    "opendistro.asynchronous_search.max_wait_for_completion_timeout": "5m"
  }
}

Setting	Default	Description
`opendistro.asynchronous_search.max_search_running_time`	12 hours	The maximum running time for the search beyond which the search is terminated.
`opendistro.asynchronous_search.node_concurrent_running_searches`	20	The concurrent searches running per coordinator node.
`opendistro.asynchronous_search.max_keep_alive`	5 days	The maximum amount of time that search results can be stored in the cluster.
`opendistro.asynchronous_search.max_wait_for_completion_timeout`	1 minute	The maximum value for the `wait_for_completion_timeout` parameter.
`opendistro.asynchronous_search.persist_search_failures`	false	Persist asynchronous search results that end with a search failure in the system index.