retry

Documentation

Overview

Package retry provides exponential backoff with jitter. It is a policy calculator, not a loop runner: callers own their loops and contexts and ask Backoff what to wait. The same curve serves transport reconnection in core and the supervisor's crash-loop damping.

Index

• type Backoff
  • func New() Backoff
  • func (b Backoff) Delay(attempt int) time.Duration

Types

type Backoff

type Backoff struct {
	// Initial is the base delay for attempt 0.
	Initial time.Duration
	// Max caps the computed delay.
	Max time.Duration
	// Factor multiplies the delay each attempt. Typically 2.
	Factor float64
}

Backoff computes exponentially growing delays with full jitter. The zero value is not usable; use New or fill every field.

func New

func New() Backoff

New returns a Backoff with the conventional platform curve: 1s initial, doubling, capped at 2 minutes.

func (Backoff) Delay

func (b Backoff) Delay(attempt int) time.Duration

Delay returns the wait before the given attempt (0-based), with full jitter: a uniform draw from (0, computed]. Full jitter avoids thundering herds when many modules restart together.