org.apache.druid.server.coordinator

Class CoordinatorDynamicConfig

java.lang.Object

org.apache.druid.server.coordinator.CoordinatorDynamicConfig

public class CoordinatorDynamicConfig
extends Object

This class is for users to change their configurations while their Druid cluster is running. These configurations are designed to allow only simple values rather than complicated JSON objects.

See Also:

JacksonConfigManager, ConfigManager

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CoordinatorDynamicConfig.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIG_KEY

Constructor Summary

Constructors

Constructor and Description

CoordinatorDynamicConfig(long leadingTimeMillisBeforeCanMarkAsUnusedOvershadowedSegments, long mergeBytesLimit, int mergeSegmentsLimit, int maxSegmentsToMove, int replicantLifetime, int replicationThrottleLimit, int balancerComputeThreads, boolean emitBalancingStats, Object specificDataSourcesToKillUnusedSegmentsIn, boolean killUnusedSegmentsInAllDataSources, Object dataSourcesToNotKillStalePendingSegmentsIn, int maxSegmentsInNodeLoadingQueue, Object decommissioningNodes, int decommissioningMaxPercentOfMaxSegmentsToMove, boolean pauseCoordination)

Method Summary

Modifier and Type	Method and Description
static CoordinatorDynamicConfig.Builder	builder()
static CoordinatorDynamicConfig	current(JacksonConfigManager configManager)
boolean	emitBalancingStats()
boolean	equals(Object o)
int	getBalancerComputeThreads()
Set<String>	getDataSourcesToNotKillStalePendingSegmentsIn()
int	getDecommissioningMaxPercentOfMaxSegmentsToMove() The percent of getMaxSegmentsToMove() that determines the maximum number of segments that may be moved away from 'decommissioning' servers (specified by getDecommissioningNodes()) to non-decommissioning servers during one Coordinator balancer run.
Set<String>	getDecommissioningNodes() List of historical servers to 'decommission'.
long	getLeadingTimeMillisBeforeCanMarkAsUnusedOvershadowedSegments()
int	getMaxSegmentsInNodeLoadingQueue()
int	getMaxSegmentsToMove()
long	getMergeBytesLimit()
int	getMergeSegmentsLimit()
boolean	getPauseCoordination()
int	getReplicantLifetime()
int	getReplicationThrottleLimit()
Set<String>	getSpecificDataSourcesToKillUnusedSegmentsIn()
int	hashCode()
boolean	isKillUnusedSegmentsInAllDataSources()
String	toString()
static AtomicReference<CoordinatorDynamicConfig>	watch(JacksonConfigManager configManager)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

CONFIG_KEY

public static final String CONFIG_KEY

See Also:

Constant Field Values

Constructor Detail

CoordinatorDynamicConfig

public CoordinatorDynamicConfig(long leadingTimeMillisBeforeCanMarkAsUnusedOvershadowedSegments,
                                long mergeBytesLimit,
                                int mergeSegmentsLimit,
                                int maxSegmentsToMove,
                                int replicantLifetime,
                                int replicationThrottleLimit,
                                int balancerComputeThreads,
                                boolean emitBalancingStats,
                                Object specificDataSourcesToKillUnusedSegmentsIn,
                                boolean killUnusedSegmentsInAllDataSources,
                                Object dataSourcesToNotKillStalePendingSegmentsIn,
                                int maxSegmentsInNodeLoadingQueue,
                                Object decommissioningNodes,
                                int decommissioningMaxPercentOfMaxSegmentsToMove,
                                boolean pauseCoordination)

Method Detail

watch

public static AtomicReference<CoordinatorDynamicConfig> watch(JacksonConfigManager configManager)

current

@Nonnull
public static CoordinatorDynamicConfig current(JacksonConfigManager configManager)

getLeadingTimeMillisBeforeCanMarkAsUnusedOvershadowedSegments

public long getLeadingTimeMillisBeforeCanMarkAsUnusedOvershadowedSegments()

getMergeBytesLimit

public long getMergeBytesLimit()

emitBalancingStats

public boolean emitBalancingStats()

getMergeSegmentsLimit

public int getMergeSegmentsLimit()

getMaxSegmentsToMove

public int getMaxSegmentsToMove()

getReplicantLifetime

public int getReplicantLifetime()

getReplicationThrottleLimit

public int getReplicationThrottleLimit()

getBalancerComputeThreads

public int getBalancerComputeThreads()

getSpecificDataSourcesToKillUnusedSegmentsIn

public Set<String> getSpecificDataSourcesToKillUnusedSegmentsIn()

isKillUnusedSegmentsInAllDataSources

public boolean isKillUnusedSegmentsInAllDataSources()

getDataSourcesToNotKillStalePendingSegmentsIn

public Set<String> getDataSourcesToNotKillStalePendingSegmentsIn()

getMaxSegmentsInNodeLoadingQueue

public int getMaxSegmentsInNodeLoadingQueue()

getDecommissioningNodes

public Set<String> getDecommissioningNodes()

List of historical servers to 'decommission'. Coordinator will not assign new segments to 'decommissioning' servers, and segments will be moved away from them to be placed on non-decommissioning servers at the maximum rate specified by getDecommissioningMaxPercentOfMaxSegmentsToMove().

Returns:

list of host:port entries

getDecommissioningMaxPercentOfMaxSegmentsToMove

@Min(value=0L)
 @Max(value=100L)
public int getDecommissioningMaxPercentOfMaxSegmentsToMove()

The percent of getMaxSegmentsToMove() that determines the maximum number of segments that may be moved away from 'decommissioning' servers (specified by getDecommissioningNodes()) to non-decommissioning servers during one Coordinator balancer run. If this value is 0, segments will neither be moved from or to 'decommissioning' servers, effectively putting them in a sort of "maintenance" mode that will not participate in balancing or assignment by load rules. Decommissioning can also become stalled if there are no available active servers to place the segments. By adjusting this value, an operator can prevent active servers from overload by prioritizing balancing, or decrease decommissioning time instead.

Returns:

number in range [0, 100]

getPauseCoordination

public boolean getPauseCoordination()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

builder

public static CoordinatorDynamicConfig.Builder builder()