mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-05 20:48:22 +00:00
124a9fabe3
This adds new circuit breaking with the "request" breaker, which adds
circuit breaks based on the number of buckets created during
aggregations. It consists of incrementing during AggregatorBase creation
This also bumps the REQUEST breaker to 60% of the JVM heap now.
The output when circuit breaking an aggregation looks like:
```json
{
"shard" : 0,
"index" : "i",
"node" : "a5AvjUn_TKeTNYl0FyBW2g",
"reason" : {
"type" : "exception",
"reason" : "java.util.concurrent.ExecutionException: QueryPhaseExecutionException[Query Failed [Failed to execute main query]]; nested: CircuitBreakingException[[request] Data too large, data for [<agg [otherthings]>] would be larger than limit of [104857600/100mb]];",
"caused_by" : {
"type" : "execution_exception",
"reason" : "QueryPhaseExecutionException[Query Failed [Failed to execute main query]]; nested: CircuitBreakingException[[request] Data too large, data for [<agg [myagg]>] would be larger than limit of [104857600/100mb]];",
"caused_by" : {
"type" : "circuit_breaking_exception",
"reason" : "[request] Data too large, data for [<agg [otherthings]>] would be larger than limit of [104857600/100mb]",
"bytes_wanted" : 104860781,
"bytes_limit" : 104857600
}
}
}
}
```
Relates to #14046
77 lines
2.6 KiB
Plaintext
77 lines
2.6 KiB
Plaintext
[[circuit-breaker]]
|
|
=== Circuit Breaker
|
|
|
|
Elasticsearch contains multiple circuit breakers used to prevent operations from
|
|
causing an OutOfMemoryError. Each breaker specifies a limit for how much memory
|
|
it can use. Additionally, there is a parent-level breaker that specifies the
|
|
total amount of memory that can be used across all breakers.
|
|
|
|
These settings can be dynamically updated on a live cluster with the
|
|
<<cluster-update-settings,cluster-update-settings>> API.
|
|
|
|
[[parent-circuit-breaker]]
|
|
[float]
|
|
==== Parent circuit breaker
|
|
|
|
The parent-level breaker can be configured with the following setting:
|
|
|
|
`indices.breaker.total.limit`::
|
|
|
|
Starting limit for overall parent breaker, defaults to 70% of JVM heap.
|
|
|
|
[[fielddata-circuit-breaker]]
|
|
[float]
|
|
==== Field data circuit breaker
|
|
The field data circuit breaker allows Elasticsearch to estimate the amount of
|
|
memory a field will require to be loaded into memory. It can then prevent the
|
|
field data loading by raising an exception. By default the limit is configured
|
|
to 60% of the maximum JVM heap. It can be configured with the following
|
|
parameters:
|
|
|
|
`indices.breaker.fielddata.limit`::
|
|
|
|
Limit for fielddata breaker, defaults to 60% of JVM heap
|
|
|
|
`indices.breaker.fielddata.overhead`::
|
|
|
|
A constant that all field data estimations are multiplied with to determine a
|
|
final estimation. Defaults to 1.03
|
|
|
|
[[request-circuit-breaker]]
|
|
[float]
|
|
==== Request circuit breaker
|
|
|
|
The request circuit breaker allows Elasticsearch to prevent per-request data
|
|
structures (for example, memory used for calculating aggregations during a
|
|
request) from exceeding a certain amount of memory.
|
|
|
|
`indices.breaker.request.limit`::
|
|
|
|
Limit for request breaker, defaults to 60% of JVM heap
|
|
|
|
`indices.breaker.request.overhead`::
|
|
|
|
A constant that all request estimations are multiplied with to determine a
|
|
final estimation. Defaults to 1
|
|
|
|
[[in-flight-circuit-breaker]]
|
|
[float]
|
|
==== In flight requests circuit breaker
|
|
|
|
The in flight requests circuit breaker allows Elasticsearch to limit the memory usage of all
|
|
currently active incoming requests on transport or HTTP level from exceeding a certain amount of
|
|
memory on a node. The memory usage is based on the content length of the request itself.
|
|
|
|
`network.breaker.inflight_requests.limit`::
|
|
|
|
Limit for in flight requests breaker, defaults to 100% of JVM heap. This means that it is bound
|
|
by the limit configured for the parent circuit breaker.
|
|
|
|
`network.breaker.inflight_requests.overhead`::
|
|
|
|
A constant that all in flight requests estimations are multiplied with to determine a
|
|
final estimation. Defaults to 1
|
|
|
|
[[http-circuit-breaker]]
|
|
[float]
|