Safe Haskell	None
Language	GHC2024

Arbiter.Worker.BackoffStrategy

Description

Backoff strategies for job retry delays.

Synopsis

Documentation

Strategy for calculating retry delays based on attempt count.

Constructors

Exponential ExponentialConfig	`delay = base ^ attempts`, for example 2s, 4s, 8s.
Linear LinearConfig	`delay = increment * attempts`, for example 30s, 60s, 90s.
Constant NominalDiffTime	Same delay for all attempts.
Custom (Int32 -> NominalDiffTime)	User-provided function from attempts to delay.

Jitter randomizes retry delays to spread out simultaneous retries.

Constructors

NoJitter	Use the exact calculated delay.
FullJitter	`delay = random(0, calculated_delay)`.
EqualJitter	`delay = calculated_delay / 2 + random(0, calculated_delay / 2)`. The default.

Instances details

Eq Jitter Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods (==) :: Jitter -> Jitter -> Bool# (/=) :: Jitter -> Jitter -> Bool#
Show Jitter Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods showsPrec :: Int -> Jitter -> ShowS# show :: Jitter -> String# showList :: [Jitter] -> ShowS#

Multiplier and ceiling for exponential backoff.

Constructors

ExponentialConfig
Fields exponentialBase :: Double Multiplier per attempt. Use `2.0` to double. exponentialCap :: NominalDiffTime Maximum delay in seconds.

Instances details

Eq ExponentialConfig Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods (==) :: ExponentialConfig -> ExponentialConfig -> Bool# (/=) :: ExponentialConfig -> ExponentialConfig -> Bool#
Show ExponentialConfig Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods showsPrec :: Int -> ExponentialConfig -> ShowS# show :: ExponentialConfig -> String# showList :: [ExponentialConfig] -> ShowS#

Step and ceiling for linear backoff.

Constructors

LinearConfig
Fields linearIncrement :: NominalDiffTime Seconds added per attempt. linearCap :: NominalDiffTime Maximum delay in seconds.

Instances details

Eq LinearConfig Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods (==) :: LinearConfig -> LinearConfig -> Bool# (/=) :: LinearConfig -> LinearConfig -> Bool#
Show LinearConfig Source #
Instance details Defined in Arbiter.Worker.BackoffStrategy Methods showsPrec :: Int -> LinearConfig -> ShowS# show :: LinearConfig -> String# showList :: [LinearConfig] -> ShowS#

The delay for a 1-indexed attempt count.

Apply jitter to a calculated delay.

exponentialBackoff 2 300 doubles each attempt, capped at 5 minutes.

linearBackoff 30 300 adds 30s per attempt, capped at 5 minutes.

Same delay for every retry.