Skip to content

Commit b949049

Browse files
authored
Docs: resource broker config (#8694)
1 parent dd61f85 commit b949049

File tree

3 files changed

+44
-1
lines changed

3 files changed

+44
-1
lines changed

ydb/docs/ru/core/concepts/_includes/secondary_indexes.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,11 @@
4242
* Может наблюдаться увеличение задержек из-за того, что транзакции становятся распределенными (при создании синхронного индекса).
4343
* Возможен повышенный фон ошибок `OVERLOADED` из-за того, что во время записи данных активно работает автоматическое разделение шардов индексной таблицы.
4444

45-
Скорость записи данных выбрана таким образом, чтобы минимизировать влияние процесса записи на пользовательские транзакции. Для быстрого завершения операции рекомендуется запускать онлайн-создание вторичного индекса во время минимальной пользовательской нагрузки.
45+
{% note info %}
46+
47+
Скорость записи данных выбрана таким образом, чтобы минимизировать влияние процесса записи на пользовательские транзакции. Для управления скоростью настройте лимиты для соответствующей очереди [брокера ресурсов](../../deploy/configuration/config.md#resource-broker-config).
48+
49+
{% endnote %}
4650

4751
Создание индекса — асинхронная операция. Если после запуска операции произойдет разрыв клиент-серверной связности, то построение индекса будет продолжено. Управлять асинхронной операцией можно через {{ ydb-short-name }} CLI.
4852

ydb/docs/ru/core/deploy/configuration/config.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -666,6 +666,39 @@ node_broker_config:
666666
stable_node_name_prefix: <новый префикс>
667667
```
668668

669+
## resource_broker_config — брокер ресурсов {#resource-broker-config}
670+
671+
Брокер ресурсов — это [акторный сервис](../../concepts/glossary.md#actor-service), контролирующий потребление ресурсов [узла](../../concepts/glossary.md#node) {{ ydb-short-name }}, таких как:
672+
673+
- `CPU` — количество потоков;
674+
- `Memory` — оперативная память.
675+
676+
Разные виды активностей (фоновые операции, удаление данных по [TTL](../../concepts/ttl.md) и т.д.) запускаются в разных *очередях* брокера ресурсов. Каждая такая очередь имеет лимитированное число ресурсов:
677+
678+
Название очереди | CPU | Memory | Описание
679+
--- | --- | --- | ---
680+
`queue_ttl` | 2 | — | Операции удаления данных по [TTL](../../concepts/ttl.md).
681+
`queue_backup` | 2 | — | Операции [резервного копирования](../../devops/manual/backup-and-recovery.md#s3).
682+
`queue_restore` | 2 | — | Операции [восстановления из резервной копии](../../devops/manual/backup-and-recovery.md#s3).
683+
`queue_build_index` | 10 | — | Операции [онлайн-создания вторичного индекса](../../concepts/secondary_indexes.md#index-add).
684+
`queue_cdc_initial_scan` | 4 | — | [Первоначальное сканирование таблицы](../../concepts/cdc.md#initial-scan).
685+
686+
{% note info %}
687+
688+
Рекомендуется **дополнять** конфигурацию брокера ресурсов, используя [теги](../../maintenance/manual/dynamic-config-selectors.md#dopolnitelnye-tegi-v-yaml) `!inherit` и `!append`.
689+
690+
{% endnote %}
691+
692+
Пример дополнения конфигурации брокера ресурсов пользовательским лимитом для очереди `queue_ttl`:
693+
694+
```yaml
695+
resource_broker_config: !inherit
696+
queues: !append
697+
- name: queue_ttl
698+
limit:
699+
cpu: 4
700+
```
701+
669702
## Примеры конфигураций кластеров {#examples}
670703

671704
В [репозитории](https://github.com/ydb-platform/ydb/tree/main/ydb/deploy/yaml_config_examples/) можно найти модельные примеры конфигураций кластеров для самостоятельного развертывания. Ознакомьтесь с ними перед развертыванием кластера.

ydb/docs/ru/core/devops/manual/backup-and-recovery.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,12 @@
2020

2121
Для выполнения восстановления из резервной копии, созданной в S3-совместимом хранилище, применяется команда `{{ ydb-cli }} import s3`. Перейдите [по ссылке](../../reference/ydb-cli/export-import/import-s3.md) в справочник по {{ ydb-short-name }} CLI для получения информации о данной команде.
2222

23+
{% note info %}
24+
25+
Скорость операций резервного копирования и восстановления в/из S3-совместимого хранилища подобрана таким образом, чтобы минимизировать влияние на пользовательскую нагрузку. Для управления скоростью операций настройте лимиты для соответствующей очереди [брокера ресурсов](../../deploy/configuration/config.md#resource-broker-config).
26+
27+
{% endnote %}
28+
2329
{% include [_includes/backup_and_recovery/cli_overlay.md](_includes/backup_and_recovery/cli_overlay.md) %}
2430

2531
{% include [_includes/backup_and_recovery/others_overlay.md](_includes/backup_and_recovery/others_overlay.md) %}

0 commit comments

Comments
 (0)