# jetstream

Перезагрузка без перезапуска

Включение и отключение JetStream поддерживает перезагрузку. Изменение `store_dir`, `domain`, `unique_tag` или параметров шифрования при включённом JetStream приводит к ошибке перезагрузки.

## Типы

| Тип       | Описание                                  | Варианты                                   |
| --------- | ----------------------------------------- | ------------------------------------------ |
| `boolean` | -                                         | `true`, `false`                            |
| `string`  | Указывает, включена ли возможность.       | `enabled`, `enable`, `disabled`, `disable` |
| `object`  | Объект с набором явно задаваемых свойств. | -                                          |

## Свойства

| Имя                                                                                 | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Тип          | По умолчанию          | Перезагрузка |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | --------------------- | ------------ |
| [`enabled`](/reference/config/jetstream/enabled.md)                                 | Если true, включает подсистему JetStream.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `boolean`    | `true`                | Да\*         |
| [`store_dir`](/reference/config/jetstream/store_dir.md)                             | Каталог файлового хранилища.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `string`     | `/tmp/nats/jetstream` | Да\*         |
| [`max_memory_store`](/reference/config/jetstream/max_memory_store.md)               | Максимальный размер хранилища *в памяти*. По умолчанию 75% доступной памяти.                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `storage`    | -                     | Да\*         |
| [`max_file_store`](/reference/config/jetstream/max_file_store.md)                   | Максимальный размер *файлового* хранилища. По умолчанию до 1 ТБ при наличии места.                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `storage`    | -                     | Да\*         |
| [`domain`](/reference/config/jetstream/domain.md)                                   | Домен JetStream, к которому принадлежит сервер.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `string`     | -                     | Нет          |
| [`encryption_key`](/reference/config/jetstream/encryption_key.md)                   | Если задано, включает шифрование файлового хранилища JetStream, используя значение как ключ. Рекомендуется ключ длиной не менее 32 байт. При запуске ключ хешируется HMAC-256, что приводит длину к 64 байтам.                                                                                                                                                                                                                                                                                                                        | `string`     | -                     | Нет          |
| [`cipher`](/reference/config/jetstream/cipher.md)                                   | Задаёт алгоритм шифрования, если указан ключ шифрования.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `string`     | -                     | Нет          |
| [`extension_hint`](/reference/config/jetstream/extension_hint.md)                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `string`     | -                     | Нет          |
| [`prev_encryption_key`](/reference/config/jetstream/prev_encryption_key.md)         | Предыдущий ключ шифрования, сохраняемый для чтения и повторного шифрования существующих данных файлового хранилища после изменения `encryption_key`.                                                                                                                                                                                                                                                                                                                                                                                  | `string`     | -                     | Нет          |
| [`strict`](/reference/config/jetstream/strict.md)                                   | Отклонять запросы API с неизвестными полями вместо их игнорирования.                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `boolean`    | `true`                | Нет          |
| [`max_buffered_msgs`](/reference/config/jetstream/max_buffered_msgs.md)             | Число сообщений, буферизуемых сервером для потока с временно недоступным хранилищем до начала отбрасывания.                                                                                                                                                                                                                                                                                                                                                                                                                           | `integer`    | `10000`               | Нет          |
| [`max_buffered_size`](/reference/config/jetstream/max_buffered_size.md)             | Предельный размер того же буфера в байтах.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `storage`    | `128MB`               | Нет          |
| [`request_queue_limit`](/reference/config/jetstream/request_queue_limit.md)         | Допустимое число запросов JetStream API в очереди до начала отклонения новых.                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `integer`    | `10000`               | Нет          |
| [`info_queue_limit`](/reference/config/jetstream/info_queue_limit.md)               | Допустимое число запросов информации о потоке в очереди до начала отклонения новых.                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `integer`    | `100000`              | Нет          |
| [`meta_compact`](/reference/config/jetstream/meta_compact.md)                       | Число записей Raft метаслоя, накапливаемых до уплотнения журнала.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `integer`    | -                     | Да           |
| [`meta_compact_size`](/reference/config/jetstream/meta_compact_size.md)             | Размер журнала Raft метаслоя, при котором запускается уплотнение.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `storage`    | -                     | Да           |
| [`meta_compact_sync`](/reference/config/jetstream/meta_compact_sync.md)             | Выполнять уплотнение журнала Raft метаслоя синхронно, а не в фоне.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `boolean`    | `false`               | Да           |
| [`tpm`](/reference/config/jetstream/tpm/.md)                                        | Запечатать ключ шифрования файлового хранилища в TPM машины, чтобы его нельзя было прочитать с диска.                                                                                                                                                                                                                                                                                                                                                                                                                                 | `object`     | -                     | Нет          |
| [`limits`](/reference/config/jetstream/limits/.md)                                  | Лимиты JetStream по умолчанию для аккаунтов.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `object`     | -                     | Да\*         |
| [`max_concurrent_io`](/reference/config/jetstream/max_concurrent_io.md)             | Максимальное число одновременно выполняемых дисковых операций ввода-вывода на сервере суммарно для всех потоков и потребителей. Допустимы значения от 4 до 8192. Уменьшите значение, чтобы снизить конкуренцию за диск на сервере с множеством ресурсов; увеличьте для быстрого хранилища, допускающего больше параллельных операций.                                                                                                                                                                                                 | `integer`    | `4096`                | Да\*         |
| [`unique_tag`](/reference/config/jetstream/unique_tag.md)                           | Задаёт префикс тега как ограничение размещения ресурсов в домене JetStream. Например, при значении `az:` реплики ресурса должны размещаться на серверах с разными тегами `az:`.                                                                                                                                                                                                                                                                                                                                                       | `string`     | -                     | Нет          |
| [`max_outstanding_catchup`](/reference/config/jetstream/max_outstanding_catchup.md) | Максимальное число байтов в передаче при синхронизации отставшего потока. Позволяет ограничить выделяемую на синхронизацию полосу пропускания, чтобы избежать перегрузки и снижения производительности сети.                                                                                                                                                                                                                                                                                                                          | `storage`    | `32M`                 | Нет          |
| [`sync_interval`](/reference/config/jetstream/sync_interval.md)                     | Задаёт интервал принудительной синхронизации файловых данных потоков и потребителей с диском. Файловое хранилище полагается на периодическую запись буферов файловой системы операционной системой. Однако сервер также принудительно синхронизирует файлы с этим интервалом. Это позволяет точнее управлять частотой сохранения данных при частых аварийных завершениях работы. При значении `always` синхронизация выполняется при каждой записи. Дополнительные операции ввода-вывода снижают максимальную пропускную способность. | `(multiple)` | `2m`                  | Нет          |

\* Ограничения перезагрузки описаны на странице параметра.
