RetryEvent
extends TelemetryEvent
in package
FinalYes
Emitted before each §16 retry wait (CONTRACT.md §19).
§16.5 requires this: a retried-then-succeeded operation is otherwise invisible — the caller sees a slow success and no signal that the server is failing. That silence is the standing objection to automatic retry.
Table of Contents
Constants
- OUTCOME_FAILURE : mixed = 'failure'
- Outcome: the call failed, at any layer.
- OUTCOME_SUCCESS : mixed = 'success'
- Outcome: the call returned a usable response.
- REFRESH_FOLLOWER : mixed = 'follower'
- Refresh role: this caller waited on another's refresh.
- REFRESH_LEADER : mixed = 'leader'
- Refresh role: this caller performed the refresh.
Properties
- $attempt : int
- $delayMs : float
- $operation : string
- $reason : string
Methods
- __construct() : mixed
Constants
OUTCOME_FAILURE
Outcome: the call failed, at any layer.
public
mixed
OUTCOME_FAILURE
= 'failure'
OUTCOME_SUCCESS
Outcome: the call returned a usable response.
public
mixed
OUTCOME_SUCCESS
= 'success'
REFRESH_FOLLOWER
Refresh role: this caller waited on another's refresh.
public
mixed
REFRESH_FOLLOWER
= 'follower'
REFRESH_LEADER
Refresh role: this caller performed the refresh.
public
mixed
REFRESH_LEADER
= 'leader'
Properties
$attempt read-only
public
int
$attempt
$delayMs read-only
public
float
$delayMs
$operation read-only
public
string
$operation
$reason read-only
public
string
$reason
Methods
__construct()
public
__construct(string $operation, int $attempt, float $delayMs, string $reason) : mixed
Parameters
- $operation : string
-
Canonical operation name.
- $attempt : int
-
The attempt that just failed.
- $delayMs : float
-
The wait about to be taken, after jitter and any
Retry-After. - $reason : string
-
A redacted failure description; never carries a token.