backoff

Documentation

Overview

Package backoff provides a back-off timer type.

Index

• type Backoff
  • func NewBackoff(name string, logf logger.Logf, maxBackoff time.Duration) *Backoff
  • func (b *Backoff) BackOff(ctx context.Context, err error)

Types

type Backoff

type Backoff struct {

	// tstime.Clock.NewTimer is used instead time.NewTimer.
	Clock tstime.Clock

	// LogLongerThan sets the minimum time of a single backoff interval
	// before we mention it in the log.
	LogLongerThan time.Duration
	// contains filtered or unexported fields
}

Backoff tracks state the history of consecutive failures and sleeps an increasing amount of time, up to a provided limit.

func NewBackoff

func NewBackoff(name string, logf logger.Logf, maxBackoff time.Duration) *Backoff

NewBackoff returns a new Backoff timer with the provided name (for logging), logger, and max backoff time. By default, all failures (calls to BackOff with a non-nil err) are logged unless the returned Backoff.LogLongerThan is adjusted.

func (*Backoff) BackOff

func (b *Backoff) BackOff(ctx context.Context, err error)

BackOff sleeps an increasing amount of time if err is non-nil while the context is active. It resets the backoff schedule once err is nil.