Adaptive Backoff
Adaptive backoff provides a mechanism to intelligently back off use of rate
limited or failure operations through sources simples structs, Backoffs
. Backoffs
take input on success and failure, then return a duration to wait.
For an adaptive backoff, as the failure and success calls increase the returned duration eventually converges on a value to avoid rate limiting of requests.
Usage
Include within your Cargo.toml
:
adaptive_backoff = "0.2"
And follow an example below:
Adaptive ExponentialBackoff
Below is an example of an adapative ExponentialBackoff
which works from a queue
and converges on a minimal delay duration between calls. It grows by a factor of
2.0
to a maximum of 300
seconds.
use Duration;
use *;
let mut backoff = default
.factor
.max
.adaptive
.build
.unwrap;
while let Some = queue.pop
Simple ExponentialBackoff
If adaptive is omitted from the example above, a simple backoff is returned.
Its API lacks success()
and fail()
, instead it can only return increasing
delays with wait()
until reset()
is called to return it.
use Duration;
use *;
let mut backoff = default
.factor
.max
.build
.unwrap;
while let Some = queue.pop
Additional Examples
There are tests for backoff implementations which contain example use of the external API with expected output. See both the simple exponential example and the adaptive exponential backoff example.