Link Search Menu Expand Document

Open Distro for Elasticsearch development has moved to OpenSearch. The ODFE 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.


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.