org.elasticsearch.common.breaker

Interface CircuitBreaker

All Known Implementing Classes:

ChildMemoryCircuitBreaker, MemoryCircuitBreaker, NoopCircuitBreaker

public interface CircuitBreaker

Interface for an object that can be incremented, breaking after some configured limit has been reached.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CircuitBreaker.Type

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FIELDDATA
static java.lang.String	IN_FLIGHT_REQUESTS
static java.lang.String	PARENT
static java.lang.String	REQUEST

Method Summary

Modifier and Type	Method and Description
double	addEstimateBytesAndMaybeBreak(long bytes, java.lang.String label) add bytes to the breaker and maybe trip
long	addWithoutBreaking(long bytes) Adjust the circuit breaker without tripping
void	circuitBreak(java.lang.String fieldName, long bytesNeeded) Trip the circuit breaker
long	getLimit()
java.lang.String	getName()
double	getOverhead()
long	getTrippedCount()
long	getUsed()

Field Detail

PARENT

static final java.lang.String PARENT

See Also:

Constant Field Values

FIELDDATA

static final java.lang.String FIELDDATA

See Also:

Constant Field Values

REQUEST

static final java.lang.String REQUEST

See Also:

Constant Field Values

IN_FLIGHT_REQUESTS

static final java.lang.String IN_FLIGHT_REQUESTS

See Also:

Constant Field Values

Method Detail

circuitBreak

void circuitBreak(java.lang.String fieldName,
                  long bytesNeeded)

Trip the circuit breaker

Parameters:

fieldName - name of the field responsible for tripping the breaker

bytesNeeded - bytes asked for but unable to be allocated

addEstimateBytesAndMaybeBreak

double addEstimateBytesAndMaybeBreak(long bytes,
                                     java.lang.String label)
                              throws CircuitBreakingException

add bytes to the breaker and maybe trip

Parameters:

bytes - number of bytes to add

label - string label describing the bytes being added

Returns:

the number of "used" bytes for the circuit breaker

Throws:

CircuitBreakingException

addWithoutBreaking

long addWithoutBreaking(long bytes)

Adjust the circuit breaker without tripping

getUsed

long getUsed()

Returns:

the currently used bytes the breaker is tracking

getLimit

long getLimit()

Returns:

maximum number of bytes the circuit breaker can track before tripping

getOverhead

double getOverhead()

Returns:

overhead of circuit breaker

getTrippedCount

long getTrippedCount()

Returns:

the number of times the circuit breaker has been tripped

getName

java.lang.String getName()

Returns:

the name of the breaker