aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorkruall <kruall@yandex-team.ru>2022-02-21 16:44:16 +0300
committerkruall <kruall@yandex-team.ru>2022-02-21 16:44:16 +0300
commitf1000cac94ae8ff3520ddec122262903c04c54e4 (patch)
treeca70d63a8f2932da83530070df0aabc3e1bc91f7
parenta45057c5b1e44d73fff44863639a3eaf1d5ec1f7 (diff)
downloadydb-f1000cac94ae8ff3520ddec122262903c04c54e4.tar.gz
Add hive viewer docs, KIKIMR-13082
ref:1d3b59283d6991c0b966234b003598a0023c2c6f
-rw-r--r--build/mapping.conf.json12
-rw-r--r--ydb/docs/ru/core/maintenance/embedded_monitoring/hive.md69
-rw-r--r--ydb/docs/ru/core/maintenance/manual/balancing_load.md13
-rw-r--r--ydb/docs/ru/core/maintenance/manual/node_restarting.md10
-rw-r--r--ydb/docs/ru/core/maintenance/toc_i.yaml2
5 files changed, 83 insertions, 23 deletions
diff --git a/build/mapping.conf.json b/build/mapping.conf.json
index ec5b0f17c5..7d59ce8591 100644
--- a/build/mapping.conf.json
+++ b/build/mapping.conf.json
@@ -2934,6 +2934,11 @@
"2795173262": "https://storage.mds.yandex.net/get-devtools-opensource/471749/2795173262",
"2795174765": "https://storage.mds.yandex.net/get-devtools-opensource/479623/2795174765",
"2795175884": "https://storage.mds.yandex.net/get-devtools-opensource/250854/2795175884",
+ "2807634225": "https://storage.mds.yandex.net/get-devtools-opensource/471749/2807634225",
+ "2807634419": "https://storage.mds.yandex.net/get-devtools-opensource/250854/2807634419",
+ "2807634670": "https://storage.mds.yandex.net/get-devtools-opensource/471749/2807634670",
+ "2807634842": "https://storage.mds.yandex.net/get-devtools-opensource/250854/2807634842",
+ "2807635068": "https://storage.mds.yandex.net/get-devtools-opensource/479623/2807635068",
"309054781": "https://storage.mds.yandex.net/get-devtools-opensource/250854/309054781",
"360916612": "https://storage.mds.yandex.net/get-devtools-opensource/233854/360916612",
"412716868": "https://storage.mds.yandex.net/get-devtools-opensource/233854/412716868",
@@ -3754,6 +3759,13 @@
"linux_musl": "2786406721",
"win32": "2786405918"
},
+ "1220934101": {
+ "darwin": "2807634670",
+ "darwin-arm64": "2807635068",
+ "linux-ppc64le": "2807634419",
+ "linux_musl": "2807634842",
+ "win32": "2807634225"
+ },
"220049371": {
"Darwin-14.5.0-x86_64-i386-64bit": "499943029"
},
diff --git a/ydb/docs/ru/core/maintenance/embedded_monitoring/hive.md b/ydb/docs/ru/core/maintenance/embedded_monitoring/hive.md
index e931563254..e5b25d713a 100644
--- a/ydb/docs/ru/core/maintenance/embedded_monitoring/hive.md
+++ b/ydb/docs/ru/core/maintenance/embedded_monitoring/hive.md
@@ -1,2 +1,69 @@
-# Web-viewer Hive
+# Hive web-viewer
+Web-viewer Hive предоставляет инерфейс работы с Hive.
+Hive бывает общим на кластер и тенантный.
+Попасть на страницу Web-viewer Hive можно из {{ ydb-short-name }} Monitoring.
+
+## Главная страница
+
+Главная страница представляет информацию о распределении и потреблении ресурсов таблетками на каждой из нод представленной в виде таблицы.
+
+Перед таблицей представлена краткая информация:
+
+* **Tenant** - тенант за который отвечает Hive
+* **Tablets** - процентное соотношение поднятых таблеток, после количественное сколько поднято из скольки
+* **Boot Queue** - количество таблеток находятся в очереди на запуск
+* **Wait Queue** - количество таблеток не имеющие возможность подняться
+* **Resource Total** - потребление ресурсов таблетками (cpu, net)
+* **Resource StDev** - cреднеквадратическое отклонение потребления ресурсов (cnt, cpu, mem, net)
+
+После идет таблица, где каждая строка представляет из себя один из узлов под управлением Hive, и имеющая следующие столбцы:
+
+* **Node** - номер узла
+* **Name** - fqdn узла и ic-port
+* **DC** - датацентр в котором расположен узел
+* **Domain** - тенант узла
+* **Uptime** - время прошедшее с начала работы узла
+* **Unknown** - количество таблеток в неопределенном состоянии
+* **Starting** - количество таблеток в процессе подъема
+* **Running** - количество работающих таблеток
+* **Types** - распределение таблеток по их типу
+* **Usage** - отнормированный доминантный ресурс
+* **Resources** :
+ * **cnt** - количество таблеток без потребления ресурсов
+ * **cpu** - потребление ядра таблетками
+ * **mem** - потребление ОЗУ таблетками
+ * **net** - потребление полосы таблетками
+* **Active** - включение/отключение узла для перевоза таблеток на данный узел
+* **Freeze** - запрет для таблеткок подниматься на других узлах
+* **Kick** - перевоз всех таблеток разом с узла
+* **Drain** - плавный перевоз всех таблеток с узла
+
+Ниже таблицы представлены дополнительные страницы:
+
+* **Bad tablets** - список таблеток имеющие проблемы или ошибки
+* **Heavy tablets** - список таблеток поребляющие значетиельное количество ресурсов
+* **Waiting tablets** - список таблеток без возможности подняться
+* **Resources** - потребление ресурсов каждой таблеткой
+* **Tenants** -
+* **Nodes** -
+* **Storage** - список пуллов групп хранения
+* **Groups** - список групп хранения для каждой таблетки
+* **Settings** - страница конфигураций Hive
+* **Reassign Groups** - страница перераспределения групп хранения между таблетками
+
+Так же можно посмотреть какие таблетки используют конкретную группу и наоборот, какие группы используюся в конкретной таблетке.
+
+## Reassign Groups {#reassign_groups}
+
+При нажатии на кнопку **Reassign Groups** появится окно с параметрамми для балансировки:
+
+* **Storage pool** - пулл групп хранения для балансировки
+* **Storage group** - в случае если не указан предыдущий пункт, можно указать отдельно только одну группу
+* **Type** - тип таблеток для которых будет производиться балансировка
+* **Channels** - диапазон каналов, для которых будет производиться балансировка
+* **Percent** - процент от общего количества каналов таблеток которые переедут в результате балансировки
+* **Inflight** - количество одновременно переезжающих на другие группы таблеток
+
+После указания всех параметров, следует нажать сначала "Query", который покажет количество каналов попавшие под переезде и разблокирует кнопку "Reassign".
+При нажатии которой начнется перераспредление.
diff --git a/ydb/docs/ru/core/maintenance/manual/balancing_load.md b/ydb/docs/ru/core/maintenance/manual/balancing_load.md
index 20a0b260d1..00e42e4671 100644
--- a/ydb/docs/ru/core/maintenance/manual/balancing_load.md
+++ b/ydb/docs/ru/core/maintenance/manual/balancing_load.md
@@ -4,18 +4,7 @@
## Распределить нагрузку равномерно по группам
-На странице [web-мониторинга хайва](../embedded_monitoring/hive.md), в нижней части экрана есть кнокп "Reassign Groups".
-При нажатии на нее появится окно с параметрамми для балансировки:
-
-* **Storage pool** - пулл групп хранения для балансировки
-* **Storage group** - в случае если не указан предыдущий пункт, можно указать отдельно только одну группу
-* **Type** - тип таблеток для которых будет производиться балансировка
-* **Channels** - диапазон каналов, для которых будет производиться балансировка
-* **Percent** - процент от общего количества каналов таблеток которые переедут в результате балансировки
-* **Inflight** - количество одновременно переезжающих на другие группы таблеток
-
-После указания всех параметров, следует нажать сначала "Query", который покажет количество каналов попавшие под переезде и разблокирует кнопку "Reassign".
-При нажатии которой начнется балансировка.
+На странице [web-мониторинга хайва](../embedded_monitoring/hive.md#reassign_groups), в нижней части экрана есть кнокпа "Reassign Groups".
## Разложить вдиски равномерно по устройствам
diff --git a/ydb/docs/ru/core/maintenance/manual/node_restarting.md b/ydb/docs/ru/core/maintenance/manual/node_restarting.md
index 21502dc2aa..77295d71ed 100644
--- a/ydb/docs/ru/core/maintenance/manual/node_restarting.md
+++ b/ydb/docs/ru/core/maintenance/manual/node_restarting.md
@@ -34,15 +34,7 @@
Для отключения динамической узлы так же може потребоваться провести дрейн таблеток, дабы избежать эффекта на работающие запросы.
-Стоит перейти на страницу web-мониторинга хайва или тенантного хайва.
+Стоит перейти на страницу [web-мониторинга хайва](../embedded_monitoring/hive.md) или тенантного хайва.
После нажатия на кнопку "View Nodes" отобразится список всех узлов под руководством данного хайва.
-В нем представлена различиная информация о запущенных таблетках и используемых ресурсов.
-В правой части списка находятся кнопки со следующими действиями для каждой узла:
-
-* **Active** - включение/отключение узла для перевоза таблеток на данный узел
-* **Freeze** - запрет для таблеткок подниматься на других узлах
-* **Kick** - перевоз всех таблеток разом с узла
-* **Drain** - плавный перевоз всех таблеток с узла
-
Перед отключением узла, сначала требуется отключить перевоз таблеток через кнопку Active, после чего нажать Drain и дождаться увоза всех таблеток.
diff --git a/ydb/docs/ru/core/maintenance/toc_i.yaml b/ydb/docs/ru/core/maintenance/toc_i.yaml
index f9897b2815..8b3653e679 100644
--- a/ydb/docs/ru/core/maintenance/toc_i.yaml
+++ b/ydb/docs/ru/core/maintenance/toc_i.yaml
@@ -10,7 +10,7 @@ items:
when: false
- name: YDB Monitoring
href: embedded_monitoring/ydb_monitoring.md
- - name: Hive web-viewera
+ - name: Hive web-viewer
when: audience == "tech"
href: embedded_monitoring/hive.md
- name: Обзор соединений