Advanced parameters for Aiven for OpenSearch®¶
Below you can find a summary of every configuration option available for Aiven for OpenSearch® service:
opensearch_version
=> [‘string’, ‘null’]OpenSearch major version
disable_replication_factor_adjustment
=> [‘boolean’, ‘null’]Disable replication factor adjustment DEPRECATED: Disable automatic replication factor adjustment for multi-node services. By default, Aiven ensures all indexes are replicated at least to two nodes. Note: Due to potential data loss in case of losing a service node, this setting can no longer be activated.
custom_domain
=> [‘string’, ‘null’]Custom domain Serve the web frontend using a custom CNAME pointing to the Aiven DNS name
ip_filter
=> arrayIP filter Allow incoming connections from CIDR address block, e.g. ‘10.20.0.0/16’
static_ips
=> booleanStatic IP addresses Use static public IP addresses
index_patterns
=> arrayIndex patterns
max_index_count
=> integerMaximum index count Maximum number of indexes to keep before deleting the oldest one
keep_index_refresh_interval
=> booleanDon’t reset index.refresh_interval to the default value Aiven automation resets index.refresh_interval to default value for every index to be sure that indices are always visible to search. If it doesn’t fit your case, you can disable this by setting up this flag to true.
opensearch_dashboards
=> objectOpenSearch Dashboards settings
enabled
=> booleanEnable or disable OpenSearch Dashboards None
max_old_space_size
=> integermax_old_space_size Limits the maximum amount of memory (in MiB) the OpenSearch Dashboards process can use. This sets the max_old_space_size option of the nodejs running the OpenSearch Dashboards. Note: the memory reserved by OpenSearch Dashboards is not available for OpenSearch.
opensearch_request_timeout
=> integerTimeout in milliseconds for requests made by OpenSearch Dashboards towards OpenSearch None
opensearch
=> objectOpenSearch settings
reindex_remote_whitelist
=> [‘array’, ‘null’]reindex_remote_whitelist Whitelisted addresses for reindexing. Changing this value will cause all OpenSearch instances to restart.
http_max_content_length
=> integerhttp.max_content_length Maximum content length for HTTP requests to the OpenSearch HTTP API, in bytes.
http_max_header_size
=> integerhttp.max_header_size The max size of allowed headers, in bytes
http_max_initial_line_length
=> integerhttp.max_initial_line_length The max length of an HTTP URL, in bytes
indices_query_bool_max_clause_count
=> integerindices.query.bool.max_clause_count Maximum number of clauses Lucene BooleanQuery can have. The default value (1024) is relatively high, and increasing it may cause performance issues. Investigate other approaches first before increasing this value.
search_max_buckets
=> [‘integer’, ‘null’]search.max_buckets Maximum number of aggregation buckets allowed in a single response. OpenSearch default value is used when this is not defined.
indices_fielddata_cache_size
=> [‘integer’, ‘null’]indices.fielddata.cache.size Relative amount. Maximum amount of heap memory used for field data cache. This is an expert setting; decreasing the value too much will increase overhead of loading field data; too much memory used for field data cache will decrease amount of heap available for other operations.
indices_memory_index_buffer_size
=> integerindices.memory.index_buffer_size Percentage value. Default is 10%. Total amount of heap used for indexing buffer, before writing segments to disk. This is an expert setting. Too low value will slow down indexing; too high value will increase indexing performance but causes performance issues for query performance.
indices_queries_cache_size
=> integerindices.queries.cache.size Percentage value. Default is 10%. Maximum amount of heap used for query cache. This is an expert setting. Too low value will decrease query performance and increase performance for other operations; too high value will cause issues with other OpenSearch functionality.
action_auto_create_index_enabled
=> booleanaction.auto_create_index Explicitly allow or block automatic creation of indices. Defaults to true
thread_pool_index_size
=> integerindex thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_search_size
=> integersearch thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_search_throttled_size
=> integersearch_throttled thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_get_size
=> integerget thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_analyze_size
=> integeranalyze thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_write_size
=> integerwrite thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_force_merge_size
=> integerforce_merge thread pool size Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.
thread_pool_search_queue_size
=> integersearch thread pool queue size Size for the thread pool queue. See documentation for exact details.
thread_pool_search_throttled_queue_size
=> integersearch_throttled thread pool queue size Size for the thread pool queue. See documentation for exact details.
thread_pool_get_queue_size
=> integerget thread pool queue size Size for the thread pool queue. See documentation for exact details.
thread_pool_analyze_queue_size
=> integeranalyze thread pool queue size Size for the thread pool queue. See documentation for exact details.
thread_pool_write_queue_size
=> integerwrite thread pool queue size Size for the thread pool queue. See documentation for exact details.
action_destructive_requires_name
=> [‘boolean’, ‘null’]Require explicit index names when deleting None
cluster_max_shards_per_node
=> integercluster.max_shards_per_node Controls the number of shards allowed in the cluster per data node
override_main_response_version
=> booleancompatibility.override_main_response_version Compatibility mode sets OpenSearch to report its version as 7.10 so clients continue to work. Default is false
index_template
=> objectTemplate settings for all new indexes
mapping_nested_objects_limit
=> [‘integer’, ‘null’]index.mapping.nested_objects.limit The maximum number of nested JSON objects that a single document can contain across all nested types. This limit helps to prevent out of memory errors when a document contains too many nested objects. Default is 10000.
number_of_shards
=> [‘integer’, ‘null’]index.number_of_shards The number of primary shards that an index should have.
number_of_replicas
=> [‘integer’, ‘null’]index.number_of_replicas The number of replicas each primary shard has.
private_access
=> objectAllow access to selected service ports from private networks
opensearch
=> booleanAllow clients to connect to opensearch with a DNS name that always resolves to the service’s private IP addresses. Only available in certain network locations None
opensearch_dashboards
=> booleanAllow clients to connect to opensearch_dashboards with a DNS name that always resolves to the service’s private IP addresses. Only available in certain network locations None
prometheus
=> booleanAllow clients to connect to prometheus with a DNS name that always resolves to the service’s private IP addresses. Only available in certain network locations None
privatelink_access
=> objectAllow access to selected service components through Privatelink
opensearch
=> booleanEnable opensearch None
opensearch_dashboards
=> booleanEnable opensearch_dashboards None
prometheus
=> booleanEnable prometheus None
public_access
=> objectAllow access to selected service ports from the public Internet
opensearch
=> booleanAllow clients to connect to opensearch from the public internet for service nodes that are in a project VPC or another type of private network None
opensearch_dashboards
=> booleanAllow clients to connect to opensearch_dashboards from the public internet for service nodes that are in a project VPC or another type of private network None
prometheus
=> booleanAllow clients to connect to prometheus from the public internet for service nodes that are in a project VPC or another type of private network None
recovery_basebackup_name
=> stringName of the basebackup to restore in forked service
service_to_fork_from
=> [‘string’, ‘null’]Name of another service to fork from. This has effect only when a new service is being created.
project_to_fork_from
=> [‘string’, ‘null’]Name of another project to fork a service from. This has effect only when a new service is being created.