org.elasticsearch.cluster.routing.allocation.decider

Class ThrottlingAllocationDecider

java.lang.Object

org.elasticsearch.common.component.AbstractComponent

org.elasticsearch.cluster.routing.allocation.decider.AllocationDecider

org.elasticsearch.cluster.routing.allocation.decider.ThrottlingAllocationDecider

public class ThrottlingAllocationDecider
extends AllocationDecider

ThrottlingAllocationDecider controls the recovery process per node in the cluster. It exposes two settings via the cluster update API that allow changes in real-time:

• cluster.routing.allocation.node_initial_primaries_recoveries - restricts the number of initial primary shard recovery operations on a single node. The default is 4
• cluster.routing.allocation.node_concurrent_recoveries - restricts the number of total concurrent shards initializing on a single node. The default is 2

If one of the above thresholds is exceeded per node this allocation decider will return Decision.THROTTLE as a hit to upstream logic to throttle the allocation process to prevent overloading nodes due to too many concurrent recovery processes.

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLUSTER_ROUTING_ALLOCATION_CONCURRENT_RECOVERIES
static String	CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES
static String	CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES
static int	DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES
static int	DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES
static String	NAME

Fields inherited from class org.elasticsearch.common.component.AbstractComponent

deprecationLogger, logger, settings

Constructor Summary

Constructors

Constructor and Description
ThrottlingAllocationDecider(Settings settings, NodeSettingsService nodeSettingsService)

Method Summary

Methods

Modifier and Type	Method and Description
Decision	canAllocate(RoutingNode node, RoutingAllocation allocation) Returns a Decision whether the given node can allow any allocation at all at this state of the RoutingAllocation.
Decision	canAllocate(ShardRouting shardRouting, RoutingNode node, RoutingAllocation allocation) Returns a Decision whether the given shard routing can be allocated on the given node.

Methods inherited from class org.elasticsearch.cluster.routing.allocation.decider.AllocationDecider

canAllocate, canAllocate, canRebalance, canRebalance, canRemain

Methods inherited from class org.elasticsearch.common.component.AbstractComponent

logDeprecatedSetting, logRemovedSetting, nodeName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES

public static final String CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES

See Also:

Constant Field Values

CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES

public static final String CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES

See Also:

Constant Field Values

CLUSTER_ROUTING_ALLOCATION_CONCURRENT_RECOVERIES

public static final String CLUSTER_ROUTING_ALLOCATION_CONCURRENT_RECOVERIES

See Also:

Constant Field Values

DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES

public static final int DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_CONCURRENT_RECOVERIES

See Also:

Constant Field Values

DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES

public static final int DEFAULT_CLUSTER_ROUTING_ALLOCATION_NODE_INITIAL_PRIMARIES_RECOVERIES

See Also:

Constant Field Values

Constructor Detail

ThrottlingAllocationDecider

@Inject
public ThrottlingAllocationDecider(Settings settings,
                                  NodeSettingsService nodeSettingsService)

Method Detail

canAllocate

public Decision canAllocate(ShardRouting shardRouting,
                   RoutingNode node,
                   RoutingAllocation allocation)

Description copied from class: AllocationDecider

Returns a Decision whether the given shard routing can be allocated on the given node. The default is Decision.ALWAYS.

Overrides:

canAllocate in class AllocationDecider

canAllocate

public Decision canAllocate(RoutingNode node,
                   RoutingAllocation allocation)

Description copied from class: AllocationDecider

Returns a Decision whether the given node can allow any allocation at all at this state of the RoutingAllocation. The default is Decision.ALWAYS.

Overrides:

canAllocate in class AllocationDecider