Exponential Backoff Retry Options

In the real world, the network request may fail due to various reasons, such as network issues, server issues, etc. To handle these issues, we support the exponential backoff retry mechanism. You can customize the it via passing options to WithClientOptions.

rem, _ := remilia.New(
    remilia.WithClientOptions(
        // put your options at here
        remilia.WithRequestMinimumDelay(5*time.Second),
    ),
)

The following is the fomular to calculate the dalay. The delay will increase exponentially with each retry.

The following is the table of the delay for each attempt. The minimum delay is 1 second, the multiplier is 2.0, and the random delay is discarded to make it clear.

WithMinDelay

You can set the minimum delay for the client. The minimum delay is the minimum amount of time to wait before retrying a request. The delay will increase exponentially with each retry.

The default value is 1 * time.Second.

remilia.WithMinDelay(5*time.Second),

WithMaxDelay

You can set the maximum delay for the client. The maximum delay is the maximum amount of time to wait before retrying a request. The delay will increase exponentially with each retry.

The default value is 50 * time.Second.

remilia.WithMaxDelay(100*time.Second)

WithMultiplier

You can set the multiplier for the client. The multiplier is the factor by which the delay will increase with each retry.

The default value is 2.0.

remilia.WithMultiplier(3.0)

WithMaxAttempt

You can set the maximum attempt for the client. The maximum attempt is the maximum number of times to retry a request.

The default value is 10.

remilia.WithMaxAttempt(20)

WithLinearAttempt 🚧

You can set the linear attempt for the client. Linear attempts indicate how many attempts the client has made to change exponential growth to linear growth

The default value is 5

remilia.WithLinearAttempt(10)