# Размер системы и ресурсы

В топологиях выбран кластер `east` из трёх узлов (`n1-east`, `n2-east`, `n3-east`) с потоком R3 `ORDERS`. Реальная эксплуатация начинается с вопроса, сколько ресурсов ему нужно.

Узел расходует небольшой фиксированный набор ресурсов, значения JetStream по умолчанию известны, а применяемые ограничения можно прочитать одной командой. Здесь мы превратим их в исходный расчёт для ORDERS.

Вы узнаете о четырёх ресурсах узла, значениях JetStream по умолчанию и учёте R3 в ограничениях хранения учётной записи.

## Четыре ресурса узла

Каждый узел NATS использует четыре вида ресурсов. Рассчитайте каждый — и узел рассчитан.

**CPU** обеспечивает передачу сообщений. Маршрутизация Core NATS сравнительно дешева; основные затраты дают установление TLS и репликация JetStream. Жёсткого параметра ограничения CPU нет, поэтому оставляйте запас 20–30% над установившейся нагрузкой для перераспределения при выходе соседа.

**Память** хранит соединения, подписки и сообщения потоков с хранением в памяти. ORDERS использует файловое хранение, поэтому сообщения находятся на диске. Издатель `order-svc` и подписчики `warehouse`, `notifications`, `analytics` — лёгкие клиенты: несколько сотен соединений укладываются в несколько сотен мегабайт. Для `order-svc` закладывайте около 128 МиБ.

**Диск** хранит файловые потоки. Именно его расходует ORDERS, и именно он вероятнее всего закончится. Ниже рассчитаем объём.

**Файловые дескрипторы (FD)** ограничивают число открытых файлов и сокетов процесса. Они нужны соединениям, маршрутам и потокам; JetStream использует примерно два на поток. На небольшом кластере стандартного лимита достаточно, на большом — нет. Поэтому защищённый модуль из страницы [Защита системы](/learn/deployment/hardening.md) повышает предел до `LimitNOFILE=800000`.

### Значения JetStream по умолчанию

Без явной настройки JetStream вычисляет ограничения по системе. **Хранение в памяти** получает 75% системной RAM с учётом `GOMEMLIMIT`, если он задан; резервное значение **256 МБ** используется лишь при невозможности определить память. **Файловое хранение** получает 75% реально доступного места под `store_dir`; **1 ТБ** применяется только при невозможности узнать размер диска — например, на Windows или при ошибке `statfs`. Поэтому контейнер Linux с томом 10 ГиБ по умолчанию получает около 7,5 ГиБ, а не 1 ТБ.

Поскольку значение по умолчанию учитывает реальный диск, опасно другое: вручную поставить `max_file_store` *выше* размера тома либо использовать общий или тонко выделяемый том, где доступное место превышает безопасную долю потока. Тогда узел принимает записи, которые в итоге не сможет сохранить; публикация за реальным пределом завершится ошибкой. Явно ограничьте `max_file_store` вместимостью тома:

```
# n1-east.conf — pin JetStream storage to the real volume size

jetstream {

  store_dir:      "/var/lib/nats/jetstream"

  max_memory_store: 256MB

  max_file_store:   10GB

}
```

ORDERS — файловый поток R3: три копии, по одной на узел. Каждый узел хранит весь поток один раз. Значение `max_file_store` 10 ГиБ на узел позволяет разместить ORDERS в стандартном томе 10 ГиБ из главы Kubernetes. Чарт Helm по умолчанию уже устанавливает `max_file_store` равным размеру PVC, поэтому обычно делает это за вас.

Полный список ограничений JetStream находится в [Справочнике → Конфигурация](/reference/config/jetstream/.md). Здесь рассмотрены `max_memory_store` и `max_file_store`.

## Ограничения учётной записи и стоимость репликации

Конфигурация сервера задаёт ресурсы *узла*, а **ограничения учётной записи** — *арендатора*. У ORDERS свои пределы `MaxMemory`, `MaxStore`, `MaxStreams`, `MaxConsumers`, применяемые независимо от свободного диска узла. Прочитайте их перед расчётом:

#### CLI

```
#!/bin/bash

# Read the LIVE account limits for the ORDERS account before you size anything.

# This is the source of truth: it shows the tier and the ceilings the server

# will actually enforce, not what you hope the config says.

#

# Connect as order-svc in the ORDERS account, then ask the server.

nats account info \

  --server tls://nats.acme.internal:4222 \

  --creds /etc/nats/creds/order-svc.creds



# Look for these rows in the output:

#   Memory:    the MaxMemory ceiling for the account

#   Storage:   the MaxStore ceiling (file storage) for the account

#   Streams:   MaxStreams — how many streams the account may create

#   Consumers: MaxConsumers — how many consumers per stream

#

# Sizing rule: on an UN-tiered account an R3 stream counts as

# replicas x bytes against MaxStore, so a 10 GiB ORDERS stream at R3

# spends 30 GiB of the account's storage limit. A tiered account bakes

# replication into the tier, so the number you see is the usable bytes.
```

#### C

```
// Read the LIVE account limits for the ORDERS account before you

// size anything. This is the source of truth: the ceilings the

// server will actually enforce, not what you hope the config says.

if (s == NATS_OK)

    s = js_GetAccountInfo(&ai, js, NULL, &jerr);

if (s == NATS_OK)

{

    // Current usage, then the ceilings. A value of -1 means

    // unlimited.

    printf("memory used:    %" PRIu64 " bytes\n", ai->Memory);

    printf("storage used:   %" PRIu64 " bytes\n", ai->Store);

    printf("streams:        %" PRId64 "\n", ai->Streams);

    printf("consumers:      %" PRId64 "\n", ai->Consumers);

    printf("max memory:     %" PRId64 "\n", ai->Limits.MaxMemory);

    printf("max storage:    %" PRId64 "\n", ai->Limits.MaxStore);

    printf("max streams:    %" PRId64 "\n", ai->Limits.MaxStreams);

    printf("max consumers:  %" PRId64 "\n", ai->Limits.MaxConsumers);



    // Sizing rule: on an UN-tiered account an R3 stream counts as

    // replicas x bytes against max storage, so a 10 GiB ORDERS

    // stream at R3 spends 30 GiB of the account's limit. A tiered

    // account bakes replication in, so its number is usable bytes.

    if (ai->TiersLen > 0)

        printf("tiered account: %d tier(s), limits are per tier\n",

               ai->TiersLen);

}
```

Важная тонкость — учёт репликации в `MaxStore`. Есть два случая.

В учётной записи **без уровней** поток R3 учитывается как `replicas × bytes`. Поток ORDERS размером 10 ГиБ расходует 30 ГиБ `MaxStore`: ограничение измеряет суммарные байты всех реплик. Если забыть множитель, размещение третьей реплики не удастся при достижении предела.

В учётной записи **с уровнями** репликация включена в уровень. Указанные байты — полезная вместимость: множитель R3 уже учтён, и уровень 10 ГиБ вмещает поток R3 размером 10 ГиБ.

Устойчивость R3 к потере узла разобрана в [JetStream → Отказ узла](/learn/jetstream/surviving-node-loss.md). Здесь важна стоимость: без уровней три копии требуют втрое больше байтов лимита.

## Ограничения соединений, подписок и сообщений

Ещё три ограничения дополняют параметры узла. Одна команда показывает их все:

#### CLI

```
#!/bin/bash

# Read the LIVE server limits for one node of the east cluster.

# These are per-server ceilings: payload size, connection cap, and the

# JetStream memory/store limits the node was started with.

#

# `nats server info` is a system-account request, so authenticate with the

# system account's creds, not the ORDERS-account user creds.

nats server info n1-east \

  --server tls://nats.acme.internal:4222 \

  --creds /etc/nats/creds/sys.creds



# Look for these in the output:

#   Maximum Payload:     max_payload (default 1.0 MiB) — the largest single message

#   Maximum Connections: max_connections (default 64K, i.e. 65,536)

#   JetStream:           Max Memory and Max Storage configured on this node

#

# Sizing rule: max_payload must be <= max_pending. Keep max_pending at

# >= 10x your peak message size so a burst of large orders does not stall

# the connection. The ORDERS payload is well under 1 KiB, so the 1 MiB

# default has ample headroom here.
```

#### C

```
// Read the LIVE server limits for one node of the east cluster.

// There is no dedicated client API for this: it is a plain

// request on the system account's $SYS.REQ.SERVER.PING.VARZ

// subject, filtered to the n1-east node by name. The VARZ reply

// carries the per-server ceilings: max_payload (default 1 MiB),

// max_connections (default 64K), and the JetStream memory/store

// limits the node was started with.

if (s == NATS_OK)

    s = natsConnection_RequestString(&reply, conn,

            "$SYS.REQ.SERVER.PING.VARZ",

            "{\"server_name\":\"n1-east\"}", 2000);

if (s == NATS_OK)

    printf("%.*s\n",

           natsMsg_GetDataLength(reply), natsMsg_GetData(reply));
```

`max_connections` ограничивает клиентов узла: по умолчанию 64K, то есть 65 536; параметр перечитывается, превышение приводит к немедленному отключению. `max_subscriptions` ограничивает подписки одного соединения и по умолчанию не ограничен. `max_payload` по умолчанию ограничивает сообщение 1 МБ и должен быть `≤ max_pending`. Сообщения ORDERS существенно меньше килобайта, поэтому стандартных значений достаточно:

```
{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}
```

Полный набор параметров соединений и размера сообщений описан в [Справочнике → Конфигурация](/reference/config/max_payload.md). Здесь названы необходимые для исходного расчёта.

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

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

**`max_file_store` больше реального диска.** Слишком большой предел или переоценённое доступное место общего тома позволяют принять записи, которые невозможно сохранить. Ошибка возникнет во время публикации, без предварительного предупреждения при запуске. Задайте вместимость тома, начните проверку со значения `10GB` и следите за диском через `df -h`. Реальное устройство важнее числа в конфигурации.

**`max_payload` больше `max_pending`.** Сервер не запустится. Держите `max_pending` на уровне `≥ 10× peak message size`, чтобы всплеск больших сообщений не остановил соединение. Не увеличивайте `max_payload` отдельно.

**Исчерпание файловых дескрипторов.** Каждый поток требует около двух FD, плюс маршруты и служебный обмен. На большом кластере стандартный предел процесса заканчивается, а отказы соединений похожи на сетевой сбой. Увеличьте предел до запуска (`ulimit -n 800000`); модуль на странице [Защита системы](/learn/deployment/hardening.md) делает именно это.

**Ограничения учётной записи JWT меняются только вместе с JWT.** В режиме оператора сервер применяет значения из JWT resolver, а не из своей конфигурации. Для повышения `MaxStore` или `MaxStreams` нужно изменить и передать JWT: перечитывание или перезапуск сервера не помогут. При обновлении согласуйте версии узлов, чтобы они одинаково понимали поля ограничений; например, уровни R1/R3 требуют достаточно новой версии. Перед расчётом читайте активный уровень через `nats account info`.

Первый шаг для всех четырёх ошибок один: прочитать действующие ограничения и планировать по реально применяемым значениям.

#### CLI

```
#!/bin/bash

# Read the LIVE account limits for the ORDERS account before you size anything.

# This is the source of truth: it shows the tier and the ceilings the server

# will actually enforce, not what you hope the config says.

#

# Connect as order-svc in the ORDERS account, then ask the server.

nats account info \

  --server tls://nats.acme.internal:4222 \

  --creds /etc/nats/creds/order-svc.creds



# Look for these rows in the output:

#   Memory:    the MaxMemory ceiling for the account

#   Storage:   the MaxStore ceiling (file storage) for the account

#   Streams:   MaxStreams — how many streams the account may create

#   Consumers: MaxConsumers — how many consumers per stream

#

# Sizing rule: on an UN-tiered account an R3 stream counts as

# replicas x bytes against MaxStore, so a 10 GiB ORDERS stream at R3

# spends 30 GiB of the account's storage limit. A tiered account bakes

# replication into the tier, so the number you see is the usable bytes.
```

#### C

```
// Read the LIVE account limits for the ORDERS account before you

// size anything. This is the source of truth: the ceilings the

// server will actually enforce, not what you hope the config says.

if (s == NATS_OK)

    s = js_GetAccountInfo(&ai, js, NULL, &jerr);

if (s == NATS_OK)

{

    // Current usage, then the ceilings. A value of -1 means

    // unlimited.

    printf("memory used:    %" PRIu64 " bytes\n", ai->Memory);

    printf("storage used:   %" PRIu64 " bytes\n", ai->Store);

    printf("streams:        %" PRId64 "\n", ai->Streams);

    printf("consumers:      %" PRId64 "\n", ai->Consumers);

    printf("max memory:     %" PRId64 "\n", ai->Limits.MaxMemory);

    printf("max storage:    %" PRId64 "\n", ai->Limits.MaxStore);

    printf("max streams:    %" PRId64 "\n", ai->Limits.MaxStreams);

    printf("max consumers:  %" PRId64 "\n", ai->Limits.MaxConsumers);



    // Sizing rule: on an UN-tiered account an R3 stream counts as

    // replicas x bytes against max storage, so a 10 GiB ORDERS

    // stream at R3 spends 30 GiB of the account's limit. A tiered

    // account bakes replication in, so its number is usable bytes.

    if (ai->TiersLen > 0)

        printf("tiered account: %d tier(s), limits are per tier\n",

               ai->TiersLen);

}
```

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

Вы получили исходный расчёт для ORDERS:

* Четыре ресурса: CPU с запасом 20–30%, память (`order-svc` около 128 МиБ), диск с привязкой `max_file_store` к тому, FD — примерно два на поток.
* Значения JetStream: по 75% RAM и диска; 256 МБ и 1 ТБ — лишь резервные варианты при невозможности определить ресурсы. `max_file_store` привязан к реальному тому 10 ГиБ.
* Действующие ограничения из `nats account info` и правило стоимости R3 без уровней: `replicas × bytes`.

Файловый поток ORDERS R3 помещается в стандартный том 10 ГиБ, а `order-svc` — примерно в 128 МиБ. Следующая страница развёртывает эту конфигурацию.

## Что дальше

После расчёта ресурсов создадим кластер: чарт NATS Helm, StatefulSet с соответствием `nats-0..2` узлам `n1-east..n3-east` и контроллер NACK, объявляющий `ORDERS` через CRD.

Перейдите к [Kubernetes](/learn/deployment/kubernetes.md).

## См. также

* [Справочник → Конфигурация](/reference/config/jetstream/.md) — все ограничения JetStream и значения по умолчанию.
* [Справочник → max\_payload](/reference/config/max_payload.md) — ограничения полезной нагрузки и ожидающих данных.
* [Отказ узла](/learn/jetstream/surviving-node-loss.md) — устойчивость R3, за которую платят объёмом хранения.
