Куда двигаться дальше
В начале издатель не имел гарантированного слушателя. Теперь есть ORDERS, независимые потребители и постоянное зеркало.
Соберём модель и ссылки для продолжения.
Основная модель
Три идеи всей главы:
Поток — серверный журнал. Публикация в тему сохраняется захватывающим её потоком и доступна до удаления ограничением.
Потребитель — независимый указатель чтения. Несколько читают одни сообщения с разных позиций без взаимного влияния.
Ack подтверждает обработку; без него сервер повторяет после срока. Сохранение ещё не означает обработку.
Фильтры, пулы, хранение и зеркала основаны на этих трёх понятиях.
Где искать подробности
Глава не привязана к версии. Точные флаги, типы, диапазоны и стандартные значения находятся в версионируемом справочнике.
Начало — корень справочника.
Связанные главы
Все используют ту же основу.
Key-Value: бакет — поток, ключи — темы, история — номера, watch — потребитель. Применимы те же пределы и хранение.
Object Store: файл делится на сообщения и собирается при чтении. Данные всё ещё в потоке.
Кластеризация и репликация: выборы R=3, размещение и отказы подробнее одной страницы.
Мониторинг: уведомления, проверки здоровья и показатели отставания.
Резервное копирование: снимки, восстановление, применение зеркал при аварии.
Что уже готово
Новых изменений нет. ORDERS, потребители и зеркало работают. Продолжайте эксперименты или удалите через nats stream rm ORDERS после завершения.
Поток хранит, потребитель читает своим темпом, ack подтверждает обработку. Это основа возможностей JetStream.
Контрольный список перед эксплуатацией
Действия из разделов типичных ошибок со ссылками на причины.
Ваш первый поток — см. Типичные ошибки
- Используйте простой pub/sub, если новое заменяет старое; поток — когда пропуск имеет последствия.
- Задайте MaxAge, MaxBytes или MaxMsgs против заполнения диска.
- Выберите постоянное имя.
- Заранее решите retention: WorkQueue нельзя включить или выключить на живом потоке.
Публикация — см. Типичные ошибки
- Проверяйте PubAck, а не строку обычного nats pub.
- Задавайте стабильный Nats-Msg-Id повторяемым отправкам.
- Подтверждайте бизнес-результат обработкой, не фактом сохранения.
Чтение — см. Типичные ошибки
-
--allнужен всей истории; хвост выбирается--last,--since,--start-sequence. - Для возобновления нужен именованный долговременный потребитель.
- Меняйте через edit, не повторное создание.
- Различайте накопленное
--allи новое--new. - Для разового прохода добавляйте
--terminate-at-end, иначе после очереди команда ждёт дальше.
Доставка и подтверждение — см. Типичные ошибки
- Ack Wait должен покрывать медленный обработчик с запасом.
- Подтверждайте успех, прекращайте неисправимое через term.
- Один ack одной доставки в одном месте.
Фильтрация — см. Типичные ошибки
- Проверяйте совпадения до вывода о пустом потоке.
- Хранение регулируют пределы, не фильтры.
- Избегайте перекрывающихся фильтров одного потребителя.
Виды подтверждений — см. Типичные ошибки
- Временный сбой — nak с задержкой; backoff регулирует тайм-ауты.
- Неисправимому сообщению сразу term.
- Слушайте уведомления MaxDeliver: встроенной dead-letter-очереди нет.
- Для долгой работы увеличьте AckWait или отправляйте in-progress.
Pull-потребители — см. Типичные ошибки
- Пустой fetch означает отсутствие данных сейчас.
- Задавайте expires для ограниченного ожидания.
- MaxAckPending не ниже пакета.
- Ограничивайте batch также через max_bytes.
Масштабирование — см. Типичные ошибки
- Побочные действия идемпотентны по order_id.
- Общий MaxAckPending не меньше числа обработчиков с запасом.
- AckWait соответствует реальной работе.
Упорядоченные потребители — см. Типичные ошибки
- Только для повторяемого прохода; обязательная обработка — именованный с ack.
- Работу делит пул одного потребителя; два упорядоченных читают всё каждый.
- Курсор временный, после падения проход начинается заново.
Группы приоритетов — см. Типичные ошибки
- Одна группа на потребителя.
- Переключение по min_pending или min_ack_pending: таймер failover ADR-42 ещё не реализован.
- Закрепление не блокировка: нужны ack и идемпотентность.
- expires существенно меньше pinned-ttl.
Приостановка — см. Типичные ошибки
- Длительность вроде 1h исключает прошедший срок.
- Рассчитывайте хранение на максимальную паузу: публикации продолжаются.
Настройка потока — см. Типичные ошибки
- Для обратного давления Discard New; Old молча удаляет старое.
- MaxBytes по пику, не среднему.
- MaxMsgsPerSubject разделяет квоты тем.
Политики хранения — см. Типичные ошибки
- Для перехода к/из WorkQueue создайте новый поток.
- Непересекающиеся потребители либо общий пул.
- Следите за Interest с остановленным читателем.
- Limits → Interest может удалить подтверждённую историю.
TTL сообщений — см. Типичные ошибки
- Проверьте Allows Per-Message TTL: иначе публикация отклоняется.
- Срок покрывает отставание исправного читателя.
- SubjectDeleteMarkerTTL нужен уведомлению об истечении; держите не больше самого короткого TTL.
Изменение состояния — см. Типичные ошибки
- Purge очищает, rm удаляет объект.
- Номера — стабильные адреса с возможными пробелами.
- Важному потоку DenyPurge и зеркало: очистку нельзя отменить.
Отказ узла — см. Типичные ошибки
- Проверяйте реплики перед реальными заказами.
- R=3 или R=5.
- Доказывайте переключение на настоящем кластере.
Расширенная публикация — см. Типичные ошибки
- Собирайте каждый PubAck; для порядка Nats-Expected-Last-Subject-Sequence.
- Атомарность доказывает финальный PubAck; разрыв, превышение и десять секунд тишины отменяют пакет.
- Atomic несовместим с PersistMode: async, fast-ingest совместим.
- gap: ok лишь для допустимых потерь; иначе fail или атомарность.
Зеркала и источники — см. Типичные ошибки
- Публикуйте источнику; принуждение к зеркалу даёт expected stream does not match.
- Проверяйте Lag.
- filter_subject либо subject_transforms, не оба.
- Проверяйте типы междоменных экспортов.
Прямое чтение — см. Типичные ошибки
- Включите Direct Get: true или allow-direct.
- Для чтения после записи используйте лидера через nats stream get.
- Для новых сообщений нужен потребитель, не прямой пакет.
Сопоставление тем — см. Типичные ошибки
- Сохраняйте нужные фильтрам токены
{{wildcard}}. - Для наверстывания нужен потребитель, не republish.
- Цель republish вне собственных тем, иначе цикл 10052.
- Историю переписывайте копированием в новый поток.
- Число разделов планируйте заранее.
Политики — см. Типичные ошибки
- Storage, Persist, Deliver, Ack, Replay выбирайте до создания.
- Пересоздание требует переноса данных и сбрасывает позицию читателя.
- deliver new — однократное начало, не пропуск очереди при рестарте.
- Различайте политику и Direct Get last per subject.
См. также
- Справочник — полный версионируемый набор полей и ошибок.
- Key-Value — следующая надстройка.
- Кластеризация и репликация — отказоустойчивость подробно.