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

Настройка потока

Созданный на странице Ваш первый поток ORDERS не ограничен и сохраняет всё. Для обучения это допустимо, для эксплуатации — нет.

Без ограничений он заполнит диск и может остановить сервер.

Предел определяет заполнение, политика Discard — что выбросить: новую запись или старейшую.

Ограничения​

Стандартная политика Limits сохраняет до достижения одного из пределов:

  • MaxAge — максимальный возраст. Семь дней удаляют сообщение примерно через неделю; удобно для недавних событий.
  • MaxBytes — объём хранения. Один гигабайт ограничивает размер независимо от возраста и защищает сервер.
  • MaxMsgs — число сообщений. При миллионе следующая запись требует вытеснения; удобно, если важен счётчик.

Все действуют независимо и одновременно: срабатывает первый достигнутый. Задайте нужные, остальные оставьте неограниченными.

MaxAge удаляет по часам, MaxMsgs — по количеству:

Ограничьте ORDERS​

Задайте семь дней и гигабайт через nats stream edit. Поток меняется на месте с сохранением данных, укладывающихся в пределы.

#!/bin/bash
# Cap the ORDERS stream so it cannot grow without bound.
#
# `nats stream edit` changes an existing stream in place. The three
# messages already stored stay where they are; only the configuration
# changes. The command prints a diff of what will change and asks for
# confirmation before applying it.
#
# --max-age sets MaxAge: the oldest a message may get. 7d means a
# message is removed roughly seven days after it was stored.
# --max-bytes sets MaxBytes: the most disk the stream may occupy on
# disk. 1GiB caps it at one gibibyte (about a gigabyte); the stream
# never grows past it. nats reports the cap back as "1.0 GiB".
#
# MaxMsgs is left unset, so message count stays unlimited. Discard
# policy is left at its default (Old), so when a limit is hit the
# server drops the oldest messages to make room.

nats stream edit ORDERS \
--max-age=7d \
--max-bytes=1GiB

Команда показывает изменения и запрашивает подтверждение. Затем проверьте:

nats stream info ORDERS

Вместо unlimited появятся пределы:

Options:

Retention: Limits
Acknowledgments: true
Discard Policy: Old
Duplicate Window: 2m0s

Limits:

Maximum Messages: unlimited
Maximum Per Subject: unlimited
Maximum Bytes: 1.0 GiB
Maximum Age: 7d0h0m0s
Maximum Message Size: unlimited
Maximum Consumers: unlimited

Maximum Messages остаётся unlimited. Maximum Message Size ограничивает отдельное сообщение, не весь поток, и тоже не задан. Теперь поток не превышает гигабайт и не хранит старше недели.

Политика Discard​

При новой записи за пределами выбирается одно из двух поведений.

Discard Old, стандартное, удаляет старейшие сообщения ради новых. Публикация успешна, самая новая запись сохраняется.

Discard New отклоняет новую публикацию при MaxMsgs, MaxBytes или соответствующем ограничении темы, сохраняя прежние данные. MaxAge независимо удаляет по времени при любой политике. Первый достигнутый предел действует.

Для живого ORDERS нужна недавняя неделя, поэтому оставим Discard Old: при нехватке места важнее сегодняшний заказ.

Discard New подходит, если старые данные нельзя терять и лучше замедлить издателя. Он обязан обрабатывать отказы.

Ограничения относятся к потоку​

Удалённое пределом сообщение исчезает для всех потребителей.

Позиция shipping и фильтр analytics не защищают от удаления. Если читатель отстал до истечения возраста, данные потеряны. Далее рассмотрим влияние политики хранения.

Ограничения отдельных тем​

MaxMsgsPerSubject может хранить, например, последние сто сообщений каждой темы под orders.>, независимо от общего количества.

Все ограничения — в Конфигурации потока. Здесь используются MaxAge, MaxBytes и Discard.

Типичные ошибки​

Две основные ловушки:

Discard Old удаляет без предупреждения издателя. Успешная запись может вытеснить старый заказ. Для сохранения истории выбирайте Discard New с ошибками maximum bytes exceeded или maximum messages exceeded. Но MaxAge продолжает действовать: поднимите или уберите и его.

#!/bin/bash
# Switch ORDERS from Discard Old to Discard New so a full stream pushes
# backpressure to the publisher instead of silently dropping old orders.
#
# Under Discard Old (the default) a publish that exceeds a limit always
# succeeds, because the server drops the oldest message to make room and
# tells the publisher nothing. If you need to keep history, that silent
# drop is data loss you never see.
#
# --discard new flips the trade: when a limit is hit, the server rejects
# the new message and the publish fails with "maximum bytes exceeded" (or
# "maximum messages exceeded"). The publisher now feels the limit.

# Force the full condition so you can see the rejection. Discard New never
# drops messages that are already stored, so switching ORDERS to it and
# capping it at one message leaves the orders from earlier pages in place and
# puts the stream instantly over its limit -- both in one edit.
nats stream edit ORDERS --discard new --max-msgs 1

# ORDERS is now full. Under Discard New this publish fails instead of
# succeeding silently, so the publisher can retry, alert, or shed load:
nats pub orders.created \
'{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}'
# -> nats: maximum messages exceeded

# Put ORDERS back the way it was: Discard Old and no message-count cap. The
# 7-day age and 1 GiB byte limits set earlier stay in place.
nats stream edit ORDERS --discard old --max-msgs -1

Семидневный MaxAge не гарантирует неделю истории: при всплеске MaxBytes может удалить данные нескольких часов. Рассчитывайте объём по пиковой, не средней нагрузке.

Общие пределы не балансируют темы. Поток orders.created может вытеснить orders.shipped. Для отдельной квоты задайте MaxMsgsPerSubject:

#!/bin/bash
# Add a per-subject ceiling to ORDERS so one noisy subject cannot evict
# another subject's messages.
#
# MaxMsgs, MaxBytes, and MaxAge all measure the stream as a whole,
# across every subject under orders.>. If orders.created floods in, its
# messages count toward the same ceiling as orders.shipped, and Discard
# Old can drop a shipped order to make room for a created one.
#
# --max-msgs-per-subject sets MaxMsgsPerSubject: a separate ceiling
# applied to each individual subject. Set it to 100000 and every subject
# keeps its own most-recent 100000 messages, independent of how loud its
# neighbors are.

nats stream edit ORDERS --max-msgs-per-subject=100000

# Read the stream back; the per-subject limit now appears alongside the
# whole-stream limits.
nats stream info ORDERS

При Discard Old удаляется старейшее своей темы. Сам Discard New это не меняет: для отказа по заполненной теме дополнительно нужен DiscardNewPerSubject, поле discard_new_per_subject. Тогда возвращается maximum messages per subject exceeded наряду с общими ошибками. См. Конфигурацию потока.

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

Теперь есть:

  • ORDERS с MaxAge семь дней и MaxBytes 1 ГиБ.
  • Прежние сообщения, укладывающиеся в пределы.
  • Discard Old для вытеснения старейших, а не новых.

Что дальше​

Пределы настроены для Limits. Теперь выберем саму политику хранения: Limits, Interest или WorkQueue.

См. также​