diff --git a/ydb/docs/en/core/reference/configuration/actor_system_config.md b/ydb/docs/en/core/reference/configuration/actor_system_config.md
index b627ccb84d2d..fee3de0308b9 100644
--- a/ydb/docs/en/core/reference/configuration/actor_system_config.md
+++ b/ydb/docs/en/core/reference/configuration/actor_system_config.md
@@ -22,11 +22,13 @@ actor_system_config:
cpu_count: 10
```
-| Parameter | Description |
-|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `use_auto_config` | Enabling automatic configuration of the actor system. |
-| `node_type` | Node type. Determines the expected workload and vCPU ratio between the pools. Possible values:
- `STORAGE`: The node interacts with network block store volumes and is responsible for managing the Distributed Storage.
- `COMPUTE`: The node processes the workload generated by users.
- `HYBRID`: The node is used for hybrid load or the usage of `System`, `User`, and `IC` for the node under load is about the same. |
-| `cpu_count` | Number of vCPUs allocated to the node. |
+| Parameter | Description |
+|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `use_auto_config` | Enabling automatic configuration of the actor system. |
+| `node_type` | Node type. Determines the expected workload and vCPU ratio between the pools. Possible values:
- `STORAGE`: The node interacts with network block store volumes and is responsible for managing the Distributed Storage.
- `COMPUTE`: The node processes the workload generated by users.
- `HYBRID`: The node is used for hybrid load or the usage of `System`, `User`, and `IC` for the node under load is about the same. |
+| `cpu_count` | Number of vCPUs allocated to the node. |
+| `use_shared_threads` | Enable shared threads to improve utilization and actor system performance. |
+| `actor_system_profile` | Actor system operating profile. Determines which metric the actor system optimizes:
- `LOW_CPU_CONSUMPTION` — optimizes CPU usage.
- `LOW_LATENCY` — optimizes message delivery latency.
|
## Manual Configuring {#tuneconfig}
@@ -71,6 +73,9 @@ actor_system_config:
| `max_threads` | Maximum vCPU that can be allocated to the pool from idle cores of other pools. When you set this parameter, the system enables the mechanism of expanding the pool at full utilization, provided that idle vCPUs are available.
The system checks the current utilization and reallocates vCPUs once per second. |
| `max_avg_ping_deviation` | Additional condition to expand the pool's vCPU. When more than 90% of vCPUs allocated to the pool are utilized, you need to worsen SelfPing by more than `max_avg_ping_deviation` microseconds from 10 milliseconds expected. |
| `time_per_mailbox_micro_secs` | The number of messages per actor to be handled before switching to a different actor. |
+| `has_shared_thread` | Whether the pool has a shared worker that searches for work in adjacent pools when the current pool is idle. |
+| `adjacent_pools` | Ordinal indices of pools that will equally share the shared worker. (Required for installations with fewer than 4 cores.) |
+| `forced_foreign_slots` | A hard limit on the number of shared workers that can help this pool. (Used on installations with fewer than 4 cores to limit shared workers helping the `Batch` pool.) |
| `type` | Pool type. Possible values:- `IO` should be set for IO pools.
- `BASIC` should be set for any other pool.
|
| `scheduler` | Scheduler configuration. The actor system scheduler is responsible for the delivery of deferred messages exchanged by actors.
We do not recommend changing the default scheduler parameters. |
| `progress_threshold` | The actor system supports requesting message sending scheduled for a later point in time. The system might fail to send all scheduled messages at some point. In this case, it starts sending them in "virtual time" by handling message sending in each loop over a period that doesn't exceed the `progress_threshold` value in microseconds and shifting the virtual time by the `progress_threshold` value until it reaches real time. |
diff --git a/ydb/docs/ru/core/reference/configuration/actor_system_config.md b/ydb/docs/ru/core/reference/configuration/actor_system_config.md
index 7e3d86e21ee6..0be4ef0a2f69 100644
--- a/ydb/docs/ru/core/reference/configuration/actor_system_config.md
+++ b/ydb/docs/ru/core/reference/configuration/actor_system_config.md
@@ -22,11 +22,13 @@ actor_system_config:
cpu_count: 10
```
-| Параметр | Описание |
-|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `use_auto_config` | Включение автоматического конфигурирования акторной системы. |
-| `node_type` | Тип узла. Определяет ожидаемую нагрузку и соотношение ядер CPU между пулами. Одно из значений:- `STORAGE` — узел работает с блочными устройствами и отвечает за Distributed Storage;
- `COMPUTE` — узел обслуживает пользовательскую нагрузку;
- `HYBRID` — узел работает со смешанной нагрузкой или потребление `System`, `User` и `IC` узла под нагрузкой приблизительно одинаково. |
-| `cpu_count` | Количество ядер CPU, выделенных узлу. |
+| Параметр | Описание |
+|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `use_auto_config` | Включение автоматического конфигурирования акторной системы. |
+| `node_type` | Тип узла. Определяет ожидаемую нагрузку и соотношение ядер CPU между пулами. Одно из значений:
- `STORAGE` — узел работает с блочными устройствами и отвечает за Distributed Storage;
- `COMPUTE` — узел обслуживает пользовательскую нагрузку;
- `HYBRID` — узел работает со смешанной нагрузкой или потребление `System`, `User` и `IC` узла под нагрузкой приблизительно одинаково. |
+| `cpu_count` | Количество ядер CPU, выделенных узлу. |
+| `use_shared_threads` | Включение общих потоков, для улучшения утилизации и производительности актор системы. |
+| `actor_system_profile` | Режим работы акторсистем. Определяет метрику, которую будет оптимизировать акторсисема:
- `LOW_CPU_CONSUMPTION` - оптимизирует потребелние ядер CPU;
- `LOW_LATENCY` - оптимизирует время доставки сообщеинй в акторсистеме. |
## Ручное конфигурирование {#tuneconfig}
@@ -71,6 +73,9 @@ actor_system_config:
| `max_threads` | Максимальное количество ядер процессора, которые могут быть выданы пулу в случае использования простаивающих ядер из других пулов. При выставлении параметра включается механизм увеличения размера пула при полном потреблении пула и наличия свободных ядер.
Проверка текущей нагрузки и перераспределение ядер происходит 1 раз в секунду. |
| `max_avg_ping_deviation` | Дополнительное условие для расширения пула по количеству ядер. При потреблении более чем 90% ядер процессора, выделенных пулу, требуется ухудшение показателя SelfPing более чем на `max_avg_ping_deviation` микросекунд от ожидаемых 10 миллисекунд. |
| `time_per_mailbox_micro_secs` | Количество сообщений в каждом акторе, которое будет обработано перед переключением на другой актор. |
+| `has_shared_thread` | Задает наличие общего потока, который искать работу в соседних пулах в случае отствтия работы в текущем. |
+| `adjacent_pools` | Порядковые номера пулов, с которыми текущий пул будет делить общий поток на равных правах. (Требуется только для инсталяций с количеством ядер меньше 4) |
+| `forced_foreign_slots` | Форсированное количество общих потоков, которые могут помогать выполнять задачи текущего пула. (Требуется для инсталяций с количеством ядер меньше 4, для ограничения общих потоков работающих с Batch пулом) |
| `type` | Тип пула. Одно из значений:- `IO` — укажите для пула IO;
- `BASIC` — укажите для всех остальных пулов.
|
| `scheduler` | Конфигурация шедулера. Шедулер акторной системы отвечает за доставку отложенных сообщений между акторами.
Не рекомендуется изменять параметры шедулера по умолчанию. |
| `progress_threshold` | В акторной системе есть возможность запросить отправку сообщения в будущем по расписанию. Возможна ситуация, когда в определенный момент времени системе не удастся отправить все запланированные сообщения. В этом случае система начинает рассылать сообщения в «виртуальном времени», обрабатывая в каждом цикле отправку сообщений за период, не превышающий `progress_threshold` в микросекундах, и продвигая виртуальное время на `progress_threshold`, пока оно не догонит реальное. |