io.helidon.faulttolerance.Retry

Description

Retry configuration bean

Configuration options

KeyTypeDefaultDescription
overall-timeoutDurationPT1SPositive overall timeout used to bound the complete retry sequence
max-delayDurationOptional non-negative maximum delay applied after jitter; when absent, the delay is not capped
delayDurationPT0.2SNon-negative base delay between the initial call and retries, which defaults to 200 ms
jitterDurationPT-1SAbsolute random jitter that must be PT-1S (disabled) or non-negative; it cannot be combined with jitter-factor, is applied independently after delay-factor, does not affect later base-delay calculations, and is capped by max-delay when present
callsInteger3Number of calls, including the initial call and retries, which must be at least 1
jitter-factorDouble-1.0Relative random jitter that must be -1 (disabled) or from 0 (inclusive) to 1 (exclusive); it cannot be combined with jitter, is applied independently after delay-factor, does not affect later base-delay calculations, and is capped by max-delay when present
delay-factorDouble-1.0Delay multiplier that must be -1 or finite and non-negative; -1 selects 2 unless either jitter option is configured, and an explicit multiplier is applied before jitter
enable-metricsBooleanfalseFlag to enable metrics for this instance

Usages


See the manifest for all available types.

Copyright © 2018, 2026 Oracle and/or its affiliates.