Перейти к основному содержимому

Куда двигаться дальше

В начале у клиентов был один URL без имени и плана отказа. Теперь order-svc использует пул, backoff/jitter, drain, ограничение памяти, безопасные запросы и проверенный TLS с creds.

Нового материала нет: соберём модель и дальнейшие ссылки.

Основная модель​

Все страницы безопасно переводили один объект — соединение — между состояниями.

Это автомат DISCONNECTED, CONNECTING, CONNECTED, RECONNECTING, DRAINING, CLOSED. Отказ сервера ведёт к восстановлению, SIGTERM — drain/close, зависший dial ждёт тайм-аут CONNECTING.

Подключение научило CONNECTING → CONNECTED, восстановление — CONNECTED → RECONNECTING → CONNECTED. События сделали переходы наблюдаемыми. Drain — безопасный выход. Медленные потребители ограничили память, request/reply — неудачные ответы, TLS/Auth — защищённый вход.

Шесть механизмов действуют на одном автомате, события делают его видимым. Имена опций и стандарты уточняют эти переходы.

Где искать подробности​

Версионируемый справочник описывает протокол, -ERR и сервер. Типы, имена и значения клиентских опций — в API библиотеки.

Здесь лишь поведение при сбоях; полные ошибки сервера и клиентские параметры смотрите соответственно там.

Связанные главы​

За границей клиента материал разделён:

Топологии объясняют n1/n2/n3, в исходной главе n1-east/n2-east/n3-east, причины отказов и серверный взгляд.

JetStream и Подтверждения сохраняют позицию и определяют повторы после восстановленной подписки.

Безопасность выпускает загружаемые creds и CA.

Сервисы формализуют responder через имена, обнаружение, метрики endpoints и очереди.

Мониторинг наблюдает серверные slow_consumers, уведомления и здоровье.

Что уже готово​

Прежние order-svc, warehouse, notifications, analytics и потребители продолжают работу с настроенными соединениями. Новых изменений здесь нет.

Соединение — автомат, сбой — переход, настройка управляет им. Это основа эксплуатации клиентов NATS.

Контрольный список перед эксплуатацией​

Последняя проверка перед реальными заказами:

Подключение — см. Типичные ошибки​

  • Несколько URL или IP вместо единственной точки.
  • Обязательные адреса заданы явно; discovery — дополнение при достижимом объявлении.
  • Осознанный connect timeout.
  • Сообщения меньше max_payload, большие данные отдельно; это не ошибка связи.

Переподключение — см. Типичные ошибки​

  • MaxReconnect=-1 для длительных Go/Java/Python/JS; Rust/C# уже бесконечны.
  • Журнал reconnect error.
  • При повторе первого входа тревога на длительный RECONNECTING после развёртывания.
  • Ненулевая задержка и jitter.
  • Обрабатывайте заполнение: стандарт Go/Java 8 МБ, Python 2 МБ; Go ErrReconnectBufExceeded, Rust обратное давление.
  • При необходимости уменьшите PING: стандарт обнаруживает до шести минут, Rust до трёх.

События — см. Типичные ошибки​

  • Опрос для панелей, метрик, readiness; события для реакции.
  • Closed-наблюдатель даже с бесконечными повторами.
  • Отдельные метрики разрывов и async-ошибок.

Плавное завершение — см. Типичные ошибки​

  • Drain после остановки производства, иначе гонка и ErrConnectionDraining.
  • Срок длиннее медленного обработчика.
  • Явные ack JetStream до закрытия: drain не управляет позицией.

Медленные потребители — см. Типичные ошибки​

  • Свои пределы настоящим подпискам; Go 500 000/64 МБ — лишь запасная защита.
  • Расчёт по задержке и пику.
  • Async callback и заметный журнал потерь.
  • Различайте локальный drop и серверный disconnect.

Request/reply — см. Типичные ошибки​

  • Тайм-аут в два-три p99 отвечающего.
  • Отдельные реакции на no responders и тайм-аут.
  • Идемпотентность order_id с устранением дублей.
  • Предел попыток и jitter.

TLS и аутентификация — см. Типичные ошибки​

  • Creds из файла/окружения, вне git.
  • Всегда проверяйте CA.
  • Продлевайте JWT до срока и наблюдайте auth-ошибки: сервер закрывает живое соединение, повторный отказ может завершить клиент.
  • Ротация новым соединением с drain старого.

См. также​