diff --git a/ydb/docs/ru/core/contributor/hive-booting.md b/ydb/docs/ru/core/contributor/hive-booting.md index ea50c0575409..8d8f3f67d81b 100644 --- a/ydb/docs/ru/core/contributor/hive-booting.md +++ b/ydb/docs/ru/core/contributor/hive-booting.md @@ -21,7 +21,7 @@ 1. [Метрики потребления ресурсов](hive.md#resources) — таблетки с бóльшим потреблением имеют бóльший приоритет. 1. Таблетки, которые часто перезапускаются, имеют пониженный приоритет. -При обработке очереди за раз обрабатывается ограниченное количество таблеток (`max_boot_batch_size` в [конфигурации](../reference/configuration/hive.md#boot)). Это нужно для того, чтобы при запуске большого числа таблеток Hive не переставал на долгое время отвечать на другие запросы. +При обработке очереди за раз обрабатывается ограниченное количество таблеток (`max_boot_batch_size` в [конфигурации](../reference/configuration/hive_config.md#boot)). Это нужно для того, чтобы при запуске большого числа таблеток Hive не переставал на долгое время отвечать на другие запросы. Если при обработке очередной таблетки оказывается, что её нельзя запустить ни на одном из узлов, то эта таблетка откладывается в отдельную очередь *Wait queue*. Когда доступность узла меняется (подключается новый узел, или с узла снимается ограничение в [Hive UI](../reference/embedded-ui/hive.md)), Hive возвращается к этим таблеткам и при обработке очереди на запуск чередует таблетки из Boot Queue и таблетки из Wait Queue. @@ -40,7 +40,7 @@ stateDiagram-v2 {% note warning %} -Одновременный запуск множества таблеток может создавать повышенную нагрузку на узел. Поэтому максимальное число одновременно запускаемых таблеток на одном узле ограничено значением `max_tablets_scheduled` из [конфигурации](../reference/configuration/hive.md#boot). При этом, если один из узлов упирается в это ограничение, Hive останавливает запуск новых таблеток и на других узлах тоже, чтобы это не повлияло на равномерность распределения. Это поведение можно регулировать с помощью параметра [`boot_strategy`](../reference/configuration/hive.md#boot). +Одновременный запуск множества таблеток может создавать повышенную нагрузку на узел. Поэтому максимальное число одновременно запускаемых таблеток на одном узле ограничено значением `max_tablets_scheduled` из [конфигурации](../reference/configuration/hive_config.md#boot). При этом, если один из узлов упирается в это ограничение, Hive останавливает запуск новых таблеток и на других узлах тоже, чтобы это не повлияло на равномерность распределения. Это поведение можно регулировать с помощью параметра [`boot_strategy`](../reference/configuration/hive_config.md#boot). {% endnote %} @@ -48,7 +48,7 @@ stateDiagram-v2 Существуют строгие ограничения на то, на каких узлах разрешено запускать таблетку: не каждый узел может запускать каждый тип таблеток; таблетки некоторой базы данных могут быть запущены только на узлах этой базы данных. Дополнительно при **перевозе** таблеток не рассматриваются перегруженные узлы. -1. Из всех подходящих узлов отбираются узлы с максимальным приоритетом. Приоритет определяется исходя из датацентра, в котором находится узел. Явно указать приоритеты датацентров можно в подсекции [`default_tablet_preference`](../reference/configuration/hive.md#boot) в конфигурации. Для [координаторов](../concepts/glossary.md#coordinator) и [медиаторов](../concepts/glossary.md#mediator) приоритеты определяются динамически так, чтобы по возможности поддерживать их в одном датацентре. Дополнительно, если таблетка завершает работу с ошибкой на некотором узле, на следующий запуск этой таблетки приоритет этого узла понижается. +1. Из всех подходящих узлов отбираются узлы с максимальным приоритетом. Приоритет определяется исходя из датацентра, в котором находится узел. Явно указать приоритеты датацентров можно в подсекции [`default_tablet_preference`](../reference/configuration/hive_config.md#boot) в конфигурации. Для [координаторов](../concepts/glossary.md#coordinator) и [медиаторов](../concepts/glossary.md#mediator) приоритеты определяются динамически так, чтобы по возможности поддерживать их в одном датацентре. Дополнительно, если таблетка завершает работу с ошибкой на некотором узле, на следующий запуск этой таблетки приоритет этого узла понижается. 1. Для узлов с максимальным приоритетом считается целевая метрика, которая почти совпадает с метрикой [Node usage](hive.md#node-usage). Она отличается тем, что учитываются только те ресурсы, которые потребляет данная таблетка, а также наличием штрафа за количество таблеток того же [объекта схемы](../concepts/glossary.md#schema-object). diff --git a/ydb/docs/ru/core/contributor/hive.md b/ydb/docs/ru/core/contributor/hive.md index 723d10f2927b..948c2fc71620 100644 --- a/ydb/docs/ru/core/contributor/hive.md +++ b/ydb/docs/ru/core/contributor/hive.md @@ -25,7 +25,7 @@ Hive — таблетка, отвечающая за управление дру В определённые моменты Hive может запустить процесс автобалансировки, перемещающий таблетки между узлами для улучшения распределения нагрузки. Ситуации, в которых это происходит, перечислены ниже. Автобалансировщик работает итеративо, принимая решения о перевозе таблеток последовательно и по одной. Он выбирает самый загруженный узел, взвешенно-случайным образом выбирает на нём таблетку и находит для неё более подходящий узел. Этот процесс повторяется, пока сбалансированность не будет восстановлена. То, как именно определяется загруженность узла, зависит от типа балансировки: например, при дисбалансе потребления CPU учитывается потребление CPU, а при неравномерном распределении колоночной таблицы — количество таблеток. -Порогами, при которых запускается балансировка, можно управлять с помошью [конфигурации Hive](../reference/configuration/hive.md#autobalancing). +Порогами, при которых запускается балансировка, можно управлять с помошью [конфигурации Hive](../reference/configuration/hive_config.md#autobalancing). ### Дисбаланс потребления ресурсов {#scatter} @@ -53,7 +53,7 @@ $\mathrm{MaxUsage}$ и $\mathrm{MinUsage}$ — максимум и миниму ## Смотрите также -- [Настройка Hive](../reference/configuration/hive.md) +- [Настройка Hive](../reference/configuration/hive_config.md) - [Hive web-viewer](../reference/embedded-ui/hive.md) - [Запуск таблеток](hive-booting.md) diff --git a/ydb/docs/ru/core/reference/configuration/bridge_config.md b/ydb/docs/ru/core/reference/configuration/bridge_config.md index fd5e38a03045..8c90fc9b008c 100644 --- a/ydb/docs/ru/core/reference/configuration/bridge_config.md +++ b/ydb/docs/ru/core/reference/configuration/bridge_config.md @@ -1,4 +1,4 @@ -## bridge_config — конфигурация режима bridge {#bridge-config} +## bridge_config {#bridge-config} Секция описывает pile кластера для [режима bridge](../../concepts/bridge.md). Укажите список имён pile, которые используются для привязки хостов и других сущностей. В режиме bridge для каждого хоста также необходимо указать имя соответствующего pile в секции `hosts` (поле `bridge_pile_name`), см. [hosts](./hosts.md#hosts-bridge). diff --git a/ydb/docs/ru/core/reference/configuration/hive.md b/ydb/docs/ru/core/reference/configuration/hive_config.md similarity index 97% rename from ydb/docs/ru/core/reference/configuration/hive.md rename to ydb/docs/ru/core/reference/configuration/hive_config.md index d1edf006da84..edf9d72cd64c 100644 --- a/ydb/docs/ru/core/reference/configuration/hive.md +++ b/ydb/docs/ru/core/reference/configuration/hive_config.md @@ -1,6 +1,6 @@ # hive_config -[Hive](../../concepts/glossary.md#hive) — компонент {{ ydb-short-name }}, отвечающий за запуск [таблеток](../../concepts/glossary.md#tablet). В различных ситуациях и под разными паттернами нагрузки может возникнуть потребность в настройке его поведения. Поведение Hive конфигурируется в секции `hive_config` [конфигурации](../../reference/configuration/hive.md) {{ ydb-short-name }}. Также часть опций из конфигурации доступна для редактирования через интерфейс [Hive web-viewer](../embedded-ui/hive.md#settings). Настройки, выставленные через интерфейс, имеют приоритет над указанными в конфигурации. Ниже перечислены все доступные опции, с указанием соответствующего названия опции в интерфейсе, если опцию возможно редактировать через интерфейс. +[Hive](../../concepts/glossary.md#hive) — компонент {{ ydb-short-name }}, отвечающий за запуск [таблеток](../../concepts/glossary.md#tablet). В различных ситуациях и под разными паттернами нагрузки может возникнуть потребность в настройке его поведения. Поведение Hive конфигурируется в секции `hive_config` [конфигурации](../../reference/configuration/hive_config.md) {{ ydb-short-name }}. Также часть опций из конфигурации доступна для редактирования через интерфейс [Hive web-viewer](../embedded-ui/hive.md#settings). Настройки, выставленные через интерфейс, имеют приоритет над указанными в конфигурации. Ниже перечислены все доступные опции, с указанием соответствующего названия опции в интерфейсе, если опцию возможно редактировать через интерфейс. ## Опции запуска таблеток {#boot} diff --git a/ydb/docs/ru/core/reference/configuration/index.md b/ydb/docs/ru/core/reference/configuration/index.md index d82bf5662002..24160064a790 100644 --- a/ydb/docs/ru/core/reference/configuration/index.md +++ b/ydb/docs/ru/core/reference/configuration/index.md @@ -13,13 +13,15 @@ || [{#T}](actor_system_config.md) | Да | Распределение CPU-ресурсов по пулам акторной системы || || [{#T}](auth_config.md) | Нет | Настройки аутентификации и авторизации || || [{#T}](blob_storage_config.md) | Нет | Конфигурация статической группы кластера для системных таблеток || +|| [{#T}](bridge_config.md) | Нет | Конфигурация [режима bridge](../../concepts/bridge.md) || || [{#T}](client_certificate_authorization.md) | Нет | Аутентификация с помощью клиентских сертификатов || || [{#T}](domains_config.md) | Нет | Конфигурация домена кластера, включая Blob Storage и State Storage || || [{#T}](feature_flags.md) | Нет | Функциональные флаги для включения или отключения определённых возможностей {{ ydb-short-name }} || || [{#T}](healthcheck_config.md) | Нет | Пороговые значения и таймауты сервиса Health Check || +|| [{#T}](hive_config.md) | Нет | Конфигурация запуска таблеток || || [{#T}](host_configs.md) | Нет | Типовые конфигурации хостов для узлов кластера || || [{#T}](hosts.md) | Да | Конфигурация статических узлов кластера || -|| [{#T}](kafka.md) | Нет | Конфигурация [Kafka Proxy](../../reference/kafka-api/index.md) || +|| [{#T}](kafka_proxy_config.md) | Нет | Конфигурация [Kafka Proxy](../../reference/kafka-api/index.md) || || [{#T}](log_config.md) | Нет | Конфигурация и параметры логирования || || [{#T}](memory_controller_config.md) | Нет | Распределение памяти и лимиты для компонентов базы данных || || [{#T}](node_broker_config.md) | Нет | Конфигурация стабильных имен узлов || diff --git a/ydb/docs/ru/core/reference/configuration/kafka.md b/ydb/docs/ru/core/reference/configuration/kafka_proxy_config.md similarity index 100% rename from ydb/docs/ru/core/reference/configuration/kafka.md rename to ydb/docs/ru/core/reference/configuration/kafka_proxy_config.md diff --git a/ydb/docs/ru/core/reference/configuration/table_service_config.md b/ydb/docs/ru/core/reference/configuration/table_service_config.md index 9a359501b742..bc71023f71f2 100644 --- a/ydb/docs/ru/core/reference/configuration/table_service_config.md +++ b/ydb/docs/ru/core/reference/configuration/table_service_config.md @@ -1,4 +1,4 @@ -# Секция конфигурации `table_service_config` +# table_service_config Секция `table_service_config` содержит параметры конфигурации для сервиса таблиц, включая настройки спиллинга. diff --git a/ydb/docs/ru/core/reference/configuration/toc_p.yaml b/ydb/docs/ru/core/reference/configuration/toc_p.yaml index 605a6bd49ea4..175b72c5d641 100644 --- a/ydb/docs/ru/core/reference/configuration/toc_p.yaml +++ b/ydb/docs/ru/core/reference/configuration/toc_p.yaml @@ -18,13 +18,13 @@ items: - name: healthcheck_config href: healthcheck_config.md - name: hive_config - href: hive.md + href: hive_config.md - name: host_configs href: host_configs.md - name: hosts href: hosts.md - name: kafka_proxy_config - href: kafka.md + href: kafka_proxy_config.md - name: log_config href: log_config.md - name: memory_controller_config diff --git a/ydb/docs/ru/core/reference/embedded-ui/hive.md b/ydb/docs/ru/core/reference/embedded-ui/hive.md index 9b808d699fe1..1da7b9597bf2 100644 --- a/ydb/docs/ru/core/reference/embedded-ui/hive.md +++ b/ydb/docs/ru/core/reference/embedded-ui/hive.md @@ -90,6 +90,6 @@ Web-viewer Hive предоставляет визуальный интерфей ## Settings {#settings} -На странице **Settings** представлен список параметров конфигурации Hive, которыми можно управлять через интерфейс. Для каждого параметра указано три значения: текущее значение, значение из [конфигурации {{ ydb-short-name }}](../../reference/configuration/hive.md) и значение по умолчанию. Параметры, значения которых выставлены через интерфейс, выделены полужирным шрифтом. Выставленные через интерфейс значения имеют приоритет над значениями из конфигурации {{ ydb-short-name }}. Внесение изменений в настройки через интерфейс не изменяет значения в конфигурации. С описанием параметров можно ознакомиться в [описании конфигурации](../configuration/hive.md). +На странице **Settings** представлен список параметров конфигурации Hive, которыми можно управлять через интерфейс. Для каждого параметра указано три значения: текущее значение, значение из [конфигурации {{ ydb-short-name }}](../../reference/configuration/hive_config.md) и значение по умолчанию. Параметры, значения которых выставлены через интерфейс, выделены полужирным шрифтом. Выставленные через интерфейс значения имеют приоритет над значениями из конфигурации {{ ydb-short-name }}. Внесение изменений в настройки через интерфейс не изменяет значения в конфигурации. С описанием параметров можно ознакомиться в [описании конфигурации](../configuration/hive_config.md). Также на этой странице представлена таблица типов таблеток и видов метрик, с помощью которой можно управлять тем, какие метрики учитываются для каких типов таблеток.