REPOSITORY / ScuroNeko/Laniakea

Wiki

KNOWLEDGE REPOSITORY
2
Rate Limiting RU
ScuroNeko edited this page 2026-03-30 00:11:30 +03:00

Rate Limiting RU

English version: Rate-Limiting

Это краткая русскоязычная версия страницы про ограничение частоты. Полная и наиболее актуальная страница: Rate-Limiting.

Где действует limiter

Ограничение частоты в Laniakea относится к слою Telegram API client.

Он влияет на исходящие запросы бота и помогает:

  • не превысить Telegram limits;
  • переживать всплески;
  • корректно обрабатывать retry_after.

Основные режимы

Есть два общих режима поведения:

  • режим ожидания;
  • режим сброса.

В режиме ожидания запросы ждут своей очереди.

В режиме сброса лишние запросы можно отклонять сразу, чтобы сохранить отзывчивость под нагрузкой.

Ключевые настройки

Через BotOpts особенно важны:

  • RateLimit
  • DropRLOverflow

Это задает общую политику для API client, который бот строит внутри NewBot(...).

retry_after

Если Telegram отвечает 429 retry_after, библиотека:

  • обновляет состояние limiter;
  • ждет нужное время;
  • повторяет запрос, если context не был отменен.

Это значит, что delayed delivery иногда нормальна и не обязательно означает поломку логики.

Global и per-chat поведение

На практике limiter связан не только с глобальным потоком запросов, но и с поведением, зависящим от чата, в API layer.

Из-за этого важно думать не только о “сколько запросов в секунду вообще”, но и о поведении всплесков внутри одного потока чата.

Когда дропать, а когда ждать

Обычно режим ожидания лучше, когда:

  • важнее надежная доставка;
  • бот обрабатывает пользовательские команды, которые нельзя терять.

Режим сброса может быть полезен, когда:

  • бот работает под очень высоким наплывом;
  • часть исходящих запросов допустимо потерять;
  • важнее быстрый ответ системы под перегрузкой.

Практические советы

  • Начинай с дефолтного ограничения частоты.
  • Повышай MaxWorkers и ограничение частоты только после реальных наблюдений.
  • Ожидай, что retry_after иногда будет нормальной частью жизни бота.

Что читать дальше