Экспоненциальная задержка — это стратегия увеличения паузы после каждой неудачной попытки — 1, 2, 4, 8 секунд и далее, — применяемая к ответам 429 и 5xx, чтобы повторы не усиливали перегрузку.
Если запрос не прошёл по временной причине — из-за тайм-аута, ответа 503 или 429, — немедленные многократные повторы только усиливают перегрузку и для вас, и для всех, кто пользуется тем же сервисом. Экспоненциальная задержка разносит попытки во времени: выждать базовую задержку, после каждой неудачи удваивать её вплоть до заданного потолка и остановиться после фиксированного числа попыток или по истечении крайнего срока.
На практике важны два уточнения. Джиттер — случайная составляющая каждой задержки — не даёт множеству клиентов, получивших ошибку в один и тот же момент, повторять запросы синхронно и снова обрушивать сервис. А указания самого сервера главнее: если ответ 429 содержит Retry-After, это значение имеет приоритет над рассчитанной задержкой. Кроме того, задержка имеет смысл только вместе с идемпотентностью, поскольку повторная отправка ни в коем случае не должна превращаться в дубликат.
| Ответ | Повторять? |
|---|---|
| 429 | Да, по истечении Retry-After |
| 5xx, тайм-аут, сетевая ошибка | Да, с задержкой и тем же ключом идемпотентности |
| Большинство других 4xx | Нет; исправьте запрос |
Пример
Условный клиент начинает с одной секунды, каждый раз удваивает задержку и добавляет полный джиттер, делая всего пять попыток: между ними он ждёт случайное время — до 1, 2, 4 и затем 8 секунд. Короткий сбой обходится в несколько секунд и без дубликатов; длительный завершается не бесконечным циклом, а отложенным в очередь сообщением и оповещением.
Типичные ошибки
- Использовать задержку без джиттера, из-за чего все клиенты повторяют запросы в одни и те же моменты.
- Повторять запросы, не прошедшие валидацию: они каждый раз будут завершаться одинаково.
- Генерировать новый ключ идемпотентности для каждой попытки.
- Накладывать повторы на нескольких уровнях — в библиотеке, приложении и очереди, — из-за чего число попыток перемножается.
В SMSMeteor: политика повторов, рекомендованная на странице SDK, такова: 429 повторять через указанное в Retry-After число секунд, а 5xx — с экспоненциальной задержкой, начиная с одной секунды, всего пять попыток. При повторе всегда используйте тот же ключ идемпотентности и никогда не создавайте новый для того же логического сообщения; ошибки 4xx, кроме 429, не повторяйте — вместо этого исправьте запрос. Доставка вебхуков на ваш эндпоинт следует тому же принципу в обратном направлении: шесть попыток в течение 24 часов (сразу, затем +1 мин, +5 мин, +30 мин, +2 ч и +12 ч), после чего событие помечается как недоставленное, и его можно повторно отправить из панели в течение 30 дней. См. документацию по вебхукам.
