Class ShardLimitValidator

java.lang.Object
org.elasticsearch.indices.ShardLimitValidator

public class ShardLimitValidator extends Object
This class contains the logic used to check the cluster-wide shard limit before shards are created and ensuring that the limit is updated correctly on setting updates, etc. NOTE: This is the limit applied at *shard creation time*. If you are looking for the limit applied at *allocation* time, which is controlled by a different setting, see ShardsLimitAllocationDecider.
  • Field Details

    • SETTING_CLUSTER_MAX_SHARDS_PER_NODE

      public static final Setting<Integer> SETTING_CLUSTER_MAX_SHARDS_PER_NODE
    • SETTING_CLUSTER_MAX_SHARDS_PER_NODE_FROZEN

      public static final Setting<Integer> SETTING_CLUSTER_MAX_SHARDS_PER_NODE_FROZEN
    • FROZEN_GROUP

      public static final String FROZEN_GROUP
      See Also:
    • INDEX_SETTING_SHARD_LIMIT_GROUP

      public static final Setting<String> INDEX_SETTING_SHARD_LIMIT_GROUP
    • shardLimitPerNode

      protected final AtomicInteger shardLimitPerNode
    • shardLimitPerNodeFrozen

      protected final AtomicInteger shardLimitPerNodeFrozen
  • Constructor Details

  • Method Details

    • getShardLimitPerNode

      public int getShardLimitPerNode()
      Gets the currently configured value of the SETTING_CLUSTER_MAX_SHARDS_PER_NODE setting.
      Returns:
      the current value of the setting
    • validateShardLimit

      public void validateShardLimit(Settings settings, ClusterState state)
      Checks whether an index can be created without going over the cluster shard limit.
      Parameters:
      settings - the settings of the index to be created
      state - the current cluster state
      Throws:
      ValidationException - if creating this index would put the cluster over the cluster shard limit
    • validateShardLimit

      public void validateShardLimit(ClusterState currentState, Index[] indicesToOpen)
      Validates whether a list of indices can be opened without going over the cluster shard limit. Only counts indices which are currently closed and will be opened, ignores indices which are already open.
      Parameters:
      currentState - The current cluster state.
      indicesToOpen - The indices which are to be opened.
      Throws:
      ValidationException - If this operation would take the cluster over the limit and enforcement is enabled.
    • validateShardLimitOnReplicaUpdate

      public void validateShardLimitOnReplicaUpdate(ClusterState currentState, Index[] indices, int replicas)
    • canAddShardsToCluster

      public static boolean canAddShardsToCluster(int numberOfNewShards, int replicas, ClusterState state, boolean frozenNodes)
      This method decides whether there is enough room in the cluster to add the given number of shards with the given number of replicas without exceeding the "cluster.max_shards_per_node.frozen" setting if the shards are going on frozen nodes or the "cluster.max_shards_per_node" setting if the shards are going on normal nodes. This check does not guarantee that the number of shards can be added, just that there is theoretically room to add them without exceeding the shards per node configuration.
      Parameters:
      numberOfNewShards - The number of primary shards that we want to be able to add to the cluster
      replicas - The number of replcas of the primary shards that we want to be able to add to the cluster
      state - The cluster state, used to get cluster settings and to get the number of open shards already in the cluster
      frozenNodes - If true, check whether there is room to put these shards onto frozen nodes. If false, check whether there is room to put these shards onto normal nodes.
      Returns:
      True if there is room to add the requested number of shards to the cluster, and false if there is not