Skip to content

ActivationRebalancerOptions

class

Namespace: Orleans.Configuration

Options for configuring activation rebalancing.
public sealed class ActivationRebalancerOptions

Constructors

Properties

  • ActivationMigrationCountLimit The maximum allowed number of activations that can be migrated at any given cycle.
  • AllowedEntropyDeviation Represents the allowed entropy deviation between the cluster's current entropy, against the theoretical maximum. Values lower than this are practically considered as "maximum", and the current rebalancing session will stop. This acts as a base rate if ActivationRebalancerOptions is set to true.
  • CycleNumberWeight

    Represents the weight that is given to the number of rebalancing cycles that have passed during a rebalancing session.

    Changing this value has a far greater impact on the migration rate than ActivationRebalancerOptions, and is suitable for controlling the session duration.

    Pick higher values if you want a faster migration rate.

  • EntropyQuantum The minimum change in the entropy of the cluster that is considered an improvement. When a total of n-consecutive stagnant cycles pass, during which the change in entropy is less than the quantum, then the current rebalancing session will stop. The change is a normalized value being relative to the maximum possible entropy.
  • MaxStagnantCycles The maximum, consecutive number of cycles, yielding no significant improvement to the cluster's entropy.
  • RebalancerDueTime The due time for the rebalancer to start the very first session.
  • ScaleAllowedEntropyDeviation Determines whether ActivationRebalancerOptions should be scaled dynamically based on the total number of activations. When set to true, the allowed entropy deviation will increase logarithmically after reaching ActivationRebalancerOptions, and will cap at ActivationRebalancerOptions.
  • ScaledEntropyDeviationActivationThreshold Determines the number of activations that must be active during any rebalancing cycle, in order for ActivationRebalancerOptions (if, and only if, its true) to begin scaling the ActivationRebalancerOptions.
  • SessionCyclePeriod The time between two consecutive rebalancing cycles within a session.
  • SiloNumberWeight

    Represents the weight that is given to the number of silos in the cluster during a rebalancing session.

    Changing this value has a far lesser impact on the migration rate than ActivationRebalancerOptions, and is suitable for fine-tuning.

    Pick lower values if you want a faster migration rate.

Fields