CloudCastle Grafana Loki API

RetryOptions
in package

FinalYes

Политика повторов неудачных запросов.

Экспоненциальная выдержка с джиттером и уважением к Retry-After: задержка растёт по множителю до потолка, а случайная добавка размывает ретраи многих процессов во времени, предотвращая «стадный» повтор.

Table of Contents

Properties

$baseDelayMs  : int
$jitterRatio  : float
$maxAttempts  : int
$maxDelayMs  : int
$multiplier  : float
$retryStatuses  : array<string|int, mixed>
Статусы, при которых запрос повторяется.

Methods

__construct()  : mixed
delayForAttempt()  : int
Задержка перед указанной повторной попыткой.
shouldRetryStatus()  : bool
Нужно ли повторять запрос после ответа с данным статусом.

Properties

$retryStatuses read-only

Статусы, при которых запрос повторяется.

public array<string|int, mixed> $retryStatuses = self::DEFAULT_RETRY_STATUSES

Methods

__construct()

public __construct([int $maxAttempts = 3 ][, int $baseDelayMs = 200 ][, int $maxDelayMs = 5000 ][, float $multiplier = 2.0 ][, float $jitterRatio = 0.2 ][, array<int, int> $retryStatuses = self::DEFAULT_RETRY_STATUSES ]) : mixed
Parameters
$maxAttempts : int = 3

максимум попыток, включая первую (≥ 1)

$baseDelayMs : int = 200

базовая задержка перед вторым запросом, мс

$maxDelayMs : int = 5000

потолок задержки, мс

$multiplier : float = 2.0

множитель экспоненциального роста (≥ 1)

$jitterRatio : float = 0.2

доля случайной добавки к задержке, 0..1

$retryStatuses : array<int, int> = self::DEFAULT_RETRY_STATUSES

HTTP-статусы для повтора

Tags
throws
ConfigException

при недопустимых значениях

delayForAttempt()

Задержка перед указанной повторной попыткой.

public delayForAttempt(int $attempt, float $random) : int
Parameters
$attempt : int

номер завершившейся неудачей попытки (с 1)

$random : float

случайное число 0..1 для джиттера

Return values
int —

задержка в миллисекундах

shouldRetryStatus()

Нужно ли повторять запрос после ответа с данным статусом.

public shouldRetryStatus(int $statusCode) : bool
Parameters
$statusCode : int

HTTP-статус ответа

Return values
bool
On this page

Search results