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 (e.g., 2s, 4s, 8s...)
Linear LinearConfig	delay = increment * attempts (e.g., 30s, 60s, 90s...)
Constant NominalDiffTime	Same delay for all attempts
Custom (Int32 -> NominalDiffTime)	User-provided function (attempts -> delay)

Jitter randomizes retry delays to spread out simultaneous retries.

Constructors

NoJitter	Use exact calculated delay
FullJitter	delay = random(0, calculated_delay)
EqualJitter	delay = calculated_delay2 + random(0, calculated_delay2). Recommended.

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, 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.