case class DefaultResizer(lowerBound: Int = 1, upperBound: Int = 10, pressureThreshold: Int = 1, rampupRate: Double = 0.2, backoffThreshold: Double = 0.3, backoffRate: Double = 0.1, messagesPerResize: Int = 10) extends Resizer with Product with Serializable

Implementation of Resizer that adjust the Pool based on specified thresholds.

lowerBound

The fewest number of routees the router should ever have.

upperBound

The most number of routees the router should ever have. Must be greater than or equal to lowerBound.

pressureThreshold

Threshold to evaluate if routee is considered to be busy (under pressure). Implementation depends on this value (default is 1).

  • 0: number of routees currently processing a message.
  • 1: number of routees currently processing a message has some messages in mailbox.
  • > 1: number of routees with at least the configured pressureThreshold messages in their mailbox. Note that estimating mailbox size of default UnboundedMailbox is O(N) operation.
rampupRate

Percentage to increase capacity whenever all routees are busy. For example, 0.2 would increase 20% (rounded up), i.e. if current capacity is 6 it will request an increase of 2 more routees.

backoffThreshold

Minimum fraction of busy routees before backing off. For example, if this is 0.3, then we'll remove some routees only when less than 30% of routees are busy, i.e. if current capacity is 10 and 3 are busy then the capacity is unchanged, but if 2 or less are busy the capacity is decreased. Use 0.0 or negative to avoid removal of routees.

backoffRate

Fraction of routees to be removed when the resizer reaches the backoffThreshold. For example, 0.1 would decrease 10% (rounded up), i.e. if current capacity is 9 it will request an decrease of 1 routee.

messagesPerResize

Number of messages between resize operation. Use 1 to resize before each message.

Annotations
@SerialVersionUID()
Source
Resizer.scala
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. DefaultResizer
  2. Serializable
  3. Product
  4. Equals
  5. Resizer
  6. AnyRef
  7. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new DefaultResizer(lower: Int, upper: Int)

    Java API constructor for default values except bounds.

  2. new DefaultResizer(lowerBound: Int = 1, upperBound: Int = 10, pressureThreshold: Int = 1, rampupRate: Double = 0.2, backoffThreshold: Double = 0.3, backoffRate: Double = 0.1, messagesPerResize: Int = 10)

    lowerBound

    The fewest number of routees the router should ever have.

    upperBound

    The most number of routees the router should ever have. Must be greater than or equal to lowerBound.

    pressureThreshold

    Threshold to evaluate if routee is considered to be busy (under pressure). Implementation depends on this value (default is 1).

    • 0: number of routees currently processing a message.
    • 1: number of routees currently processing a message has some messages in mailbox.
    • > 1: number of routees with at least the configured pressureThreshold messages in their mailbox. Note that estimating mailbox size of default UnboundedMailbox is O(N) operation.
    rampupRate

    Percentage to increase capacity whenever all routees are busy. For example, 0.2 would increase 20% (rounded up), i.e. if current capacity is 6 it will request an increase of 2 more routees.

    backoffThreshold

    Minimum fraction of busy routees before backing off. For example, if this is 0.3, then we'll remove some routees only when less than 30% of routees are busy, i.e. if current capacity is 10 and 3 are busy then the capacity is unchanged, but if 2 or less are busy the capacity is decreased. Use 0.0 or negative to avoid removal of routees.

    backoffRate

    Fraction of routees to be removed when the resizer reaches the backoffThreshold. For example, 0.1 would decrease 10% (rounded up), i.e. if current capacity is 9 it will request an decrease of 1 routee.

    messagesPerResize

    Number of messages between resize operation. Use 1 to resize before each message.

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from DefaultResizer toany2stringadd[DefaultResizer] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (DefaultResizer, B)
    Implicit
    This member is added by an implicit conversion from DefaultResizer toArrowAssoc[DefaultResizer] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def backoff(pressure: Int, capacity: Int): Int

    Computes a proposed negative (or zero) capacity delta using the configured backoffThreshold and backoffRate

    Computes a proposed negative (or zero) capacity delta using the configured backoffThreshold and backoffRate

    pressure

    the current number of busy routees

    capacity

    the current number of total routees

    returns

    proposed decrease in capacity (as a negative number)

  8. val backoffRate: Double
  9. val backoffThreshold: Double
  10. def capacity(routees: IndexedSeq[Routee]): Int

    Returns the overall desired change in resizer capacity.

    Returns the overall desired change in resizer capacity. Positive value will add routees to the resizer. Negative value will remove routees from the resizer.

    routees

    The current actor in the resizer

    returns

    the number of routees by which the resizer should be adjusted (positive, negative or zero)

  11. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  12. def ensuring(cond: (DefaultResizer) => Boolean, msg: => Any): DefaultResizer
    Implicit
    This member is added by an implicit conversion from DefaultResizer toEnsuring[DefaultResizer] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. def ensuring(cond: (DefaultResizer) => Boolean): DefaultResizer
    Implicit
    This member is added by an implicit conversion from DefaultResizer toEnsuring[DefaultResizer] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def ensuring(cond: Boolean, msg: => Any): DefaultResizer
    Implicit
    This member is added by an implicit conversion from DefaultResizer toEnsuring[DefaultResizer] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: Boolean): DefaultResizer
    Implicit
    This member is added by an implicit conversion from DefaultResizer toEnsuring[DefaultResizer] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  17. def filter(pressure: Int, capacity: Int): Int

    This method can be used to smooth the capacity delta by considering the current pressure and current capacity.

    This method can be used to smooth the capacity delta by considering the current pressure and current capacity.

    pressure

    current number of busy routees

    capacity

    current number of routees

    returns

    proposed change in the capacity

  18. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  19. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  20. def isTimeForResize(messageCounter: Long): Boolean

    Is it time for resizing.

    Is it time for resizing. Typically implemented with modulo of nth message, but could be based on elapsed time or something else. The messageCounter starts with 0 for the initial resize and continues with 1 for the first message. Make sure to perform initial resize before first message (messageCounter == 0), because there is no guarantee that resize will be done when concurrent messages are in play.

    CAUTION: this method is invoked from the thread which tries to send a message to the pool, i.e. the ActorRef.!() method, hence it may be called concurrently.

    Definition Classes
    DefaultResizerResizer
  21. val lowerBound: Int
  22. val messagesPerResize: Int
  23. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  24. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  25. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  26. def pressure(routees: IndexedSeq[Routee]): Int

    Number of routees considered busy, or above 'pressure level'.

    Number of routees considered busy, or above 'pressure level'.

    Implementation depends on the value of pressureThreshold (default is 1).

    • 0: number of routees currently processing a message.
    • 1: number of routees currently processing a message has some messages in mailbox.
    • > 1: number of routees with at least the configured pressureThreshold messages in their mailbox. Note that estimating mailbox size of default UnboundedMailbox is O(N) operation.
    routees

    the current resizer of routees

    returns

    number of busy routees, between 0 and routees.size

  27. val pressureThreshold: Int
  28. def productElementNames: Iterator[String]
    Definition Classes
    Product
  29. def rampup(pressure: Int, capacity: Int): Int

    Computes a proposed positive (or zero) capacity delta using the configured rampupRate.

    Computes a proposed positive (or zero) capacity delta using the configured rampupRate.

    pressure

    the current number of busy routees

    capacity

    the current number of total routees

    returns

    proposed increase in capacity

  30. val rampupRate: Double
  31. def resize(currentRoutees: IndexedSeq[Routee]): Int

    Decide if the capacity of the router need to be changed.

    Decide if the capacity of the router need to be changed. Will be invoked when isTimeForResize returns true and no other resize is in progress.

    Return the number of routees to add or remove. Negative value will remove that number of routees. Positive value will add that number of routees. 0 will not change the routees.

    This method is invoked only in the context of the Router actor.

    Definition Classes
    DefaultResizerResizer
  32. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  33. val upperBound: Int
  34. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  35. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  36. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

  2. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from DefaultResizer toStringFormat[DefaultResizer] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  3. def [B](y: B): (DefaultResizer, B)
    Implicit
    This member is added by an implicit conversion from DefaultResizer toArrowAssoc[DefaultResizer] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from Resizer

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd fromDefaultResizer to any2stringadd[DefaultResizer]

Inherited by implicit conversion StringFormat fromDefaultResizer to StringFormat[DefaultResizer]

Inherited by implicit conversion Ensuring fromDefaultResizer to Ensuring[DefaultResizer]

Inherited by implicit conversion ArrowAssoc fromDefaultResizer to ArrowAssoc[DefaultResizer]

Ungrouped