move out cluster/

Author: blinkov

ydb/docs/en/core/cluster/index.md

@@ -1,8 +1,4 @@
 items:
 - name: Overview
   href: index.md
-- name: Logging
-  href: ../cluster/logs.md
-- name: Topology
-  href: ../concepts/topology.md
 - include: { mode: link, path: toc_i.yaml }

ydb/docs/en/core/cluster/logs.md

@@ -4,6 +4,6 @@ This section of {{ ydb-short-name }} documentation covers everything you need to
 
 * **[Ansible](ansible/index.md)**: for deployments on bare metal and virtual machines.
 * **[Kubernetes](kubernetes/index.md)**: for containerized deployments.
-* **[Manual](../cluster/index.md)**: generic instructions.
+* **[Manual](manual/index.md)**: generic instructions.
 
 Regardless of the chosen infrastructure management method, it is recommended to familiarize yourself with [{{ ydb-short-name }} system requirements](system-requirements.md) first.

ydb/docs/en/core/cluster/toc_i.yaml

@@ -0,0 +1,11 @@
+# Manual {{ ydb-short-name }} cluster management overview
+
+This section provides information about deploying, configuring, maintaining, monitoring, and performing diagnostics of multi-node [{{ ydb-short-name }} clusters](../../concepts/cluster/index.md).
+
+Main resources:
+
+* [{#T}](../../deploy/index.md).
+* [{#T}](../../reference/embedded-ui/index.md).
+* [{#T}](../../maintenance/manual/index.md).
+* [{#T}](../../devops/manual/system-views.md).
+* [{#T}](../../administration/monitoring.md).

ydb/docs/en/core/cluster/toc_p.yaml

@@ -0,0 +1,18 @@
+# Logging in {{ ydb-short-name }}
+
+Each {{ ydb-short-name }} component writes messages to logs at different levels. They can be used to detect severe issues or identify the root causes.
+
+## Logging setup {#log_setup}
+
+You can configure logging for the various components of the YDB in the [Embedded UI](../../reference/embedded-ui/logs.md#change_log_level).
+
+There are currently two options for running YDB logging: manually or using systemd.
+
+### Manually {#log_setup_manually}
+
+YDB provides standard mechanisms for collecting logs and metrics.
+Logging is done to standard `stdout` and `stderr` streams and can be redirected using popular solutions.
+
+### Using systemd {#log_setup_systemd}
+
+Default logs are written to `journald` and can be retrieved via `journalctl -u ydbd`.

ydb/docs/en/core/deploy/toc_p.yaml

@@ -1,6 +1,23 @@
 items:
-- include:
-    mode: link
-    path: ../../cluster/toc_p.yaml
+- name: Overview
+  href: index.md
+- name: Deployment
+  include: { mode: link, path: ../../deploy/toc_p.yaml }
+- name: Managing a cluster's disk subsystem
+  include: { mode: link, path: ../../maintenance/manual/toc_p.yaml }
+- name: Monitoring
+  items:
+    - name: Setting up monitoring for a local YDB cluster
+      href: ../../administration/monitoring.md
+    - name: Grafana dashboards
+      href: ../../administration/grafana-dashboards.md
+- name: Updating YDB
+  href: ../../administration/upgrade.md
+- name: Changing an actor system's configuration
+  href: ../../maintenance/manual/change_actorsystem_configs.md
+- name: Updating configurations via CMS
+  href: ../../maintenance/manual/cms.md
 - name: System views
   href: system-views.md
+- name: Logging
+  href: logging.md

ydb/docs/en/core/devops/index.md

@@ -1,6 +1,6 @@
 # {{ ydb-short-name }} system requirements and recommendations
 
-This section provides recommendations for deploying {{ ydb-short-name }} clusters that are relevant regardless of the chosen deployment method ([Ansible](./ansible/index.md), [Kubernetes](./kubernetes/index.md), or [manual](../cluster/index.md)).
+This section provides recommendations for deploying {{ ydb-short-name }} clusters that are relevant regardless of the chosen deployment method ([Ansible](./ansible/index.md), [Kubernetes](./kubernetes/index.md), or [manual](./manual/index.md)).
 
 ## Hardware configuration {#hardware}
 

ydb/docs/en/core/devops/manual/index.md

@@ -2,7 +2,7 @@
 
 In this guide, you will install a single-node local [{{ ydb-short-name }} cluster](concepts/databases.md#cluster) and execute simple queries against your [database](concepts/databases.md#database).
 
-Normally, {{ ydb-short-name }} stores data on multiple SSD/NVMe or HDD raw disk devices without any filesystem. However, for simplicity, this guide emulates disks in RAM or using a file in a regular filesystem. Thus, this setup is unsuitable for any production usage or even benchmarks. See the [cluster management documentation](cluster/index.md) to learn how to run {{ ydb-short-name }} in a production environment.
+Normally, {{ ydb-short-name }} stores data on multiple SSD/NVMe or HDD raw disk devices without any filesystem. However, for simplicity, this guide emulates disks in RAM or using a file in a regular filesystem. Thus, this setup is unsuitable for any production usage or even benchmarks. See the [documentation for DevOps Engineers](devops/index.md) to learn how to run {{ ydb-short-name }} in a production environment.
 
 ## Install and start {{ ydb-short-name }} {#install}
 

ydb/docs/en/core/devops/manual/logging.md

@@ -4,7 +4,7 @@ _An audit log_ is a stream that includes data about all the operations that trie
 
 * Database: Creating, editing, and deleting databases.
 * Directory: Creating and deleting.
-* Table: Creating or editing table scheme, changing the number of partitions, backup and recovery, copying and renaming, and deleting tables.
+* Table: Creating or editing table schema, changing the number of partitions, backup and recovery, copying and renaming, and deleting tables.
 * Topic: Creating, editing, and deleting.
 * ACL: Editing.
 
@@ -18,7 +18,7 @@ You can use any of the listed destinations or their combinations.
 
 If you forward the stream to a file, access to the audit log is set by file-system rights. Saving the audit log to a file is recommended for production installations.
 
-Forwarding the audit log to the standard error stream (`stderr`) is recommended for test installations. Further stream processing is determined by the {{ ydb-short-name }} cluster [logging](../cluster/logs.md) settings.
+Forwarding the audit log to the standard error stream (`stderr`) is recommended for test installations. Further stream processing is determined by the {{ ydb-short-name }} cluster [logging](../devops/manual/logging.md) settings.
 
 ## Audit log events {#events}
 

ydb/docs/en/core/devops/manual/toc_p.yaml

@@ -49,6 +49,10 @@ common:
     to: /devops/kubernetes/initial-deployment.md
   - from: /cluster/system-requirements.md
     to: /devops/system-requirements.md
+  - from: /cluster/index.md
+    to: /devops/index.md
+  - from: /cluster/logs.md
+    to: /devops/manual/logging.md
 
 # DBA-related redirects
   - from: /db/index.md

ydb/docs/en/core/devops/system-requirements.md

@@ -1,10 +1,4 @@
 items:
 - name: Обзор
   href: index.md
-- name: Системные требования и рекомендации
-  href: ../devops/system-requirements.md
-- name: Логирование
-  href: ../cluster/logs.md
-- name: Топология
-  href: ../concepts/topology.md
 - include: { mode: link, path: toc_i.yaml }

ydb/docs/en/core/quickstart.md

@@ -4,6 +4,6 @@
 
 * **[Ansible](ansible/index.md)**: для развертываний на физическом оборудовании и виртуальных машинах.
 * **[Kubernetes](kubernetes/index.md)**: для развёртываний в контейнерах.
-* **[Вручную](../cluster/index.md)**: общие инструкции.
+* **[Вручную](manual/index.md)**: общие инструкции.
 
 Вне зависимости от выбранного способа управления инфраструктурой, перед началом работы рекомендуется ознакомиться с [системными требованиями {{ ydb-short-name }}](system-requirements.md).

ydb/docs/en/core/security/audit-log.md

@@ -0,0 +1,9 @@
+# Обзор управления кластером {{ ydb-short-name }} вручную
+
+В этом разделе описано развертывание, конфигурирование, обслуживание, мониторинг и диагностика многоузловых [кластеров {{ ydb-short-name }}](../../concepts/cluster/index.md).
+
+* [{#T}](../../deploy/index.md).
+* [{#T}](../../reference/embedded-ui/index.md).
+* [{#T}](../../maintenance/manual/index.md).
+* [{#T}](../../devops/manual/system-views.md).
+* [{#T}](../../administration/monitoring.md).

ydb/docs/redirects.yaml

@@ -0,0 +1,18 @@
+# Логирование в {{ ydb-short-name }}
+
+Каждый компонент {{ ydb-short-name }} пишет сообщения разного уровня в логи (журналы). По ним можно детектировать критические проблемы или разобраться в причинах неполадок.
+
+## Настройка логирования {#log_setup}
+
+Настройку логирования у отдельных компонентов можно произвести во [встроенном интерфейсе](../../reference/embedded-ui/logs.md#change_log_level) {{ ydb-short-name }}.
+
+На данный момент есть два варианта для запуска логирования {{ ydb-short-name }}: вручную и с использованием systemd.
+
+### Вручную {#log_setup_manually}
+
+Для удобства YDB предоставляет стандартные механизмы сбора логов и метрик.
+Логирование осуществляется в стандартные каналы `stdout` и `stderr` и может быть перенаправлено при помощи популярных решений.
+
+### С использованием systemd {#log_setup_systemd}
+
+По умолчению пишутся в `journald` и достать их можно через `journalctl -u ydbd`.

ydb/docs/ru/core/cluster/index.md

@@ -1,6 +1,39 @@
 items:
-- include:
-    mode: link
-    path: ../../cluster/toc_p.yaml
+- name: Обзор
+  href: index.md
+- name: Развертывание
+  include: { mode: link, path: ../../deploy/toc_p.yaml }
+- name: Управление дисковой подсистемой кластера
+  include: { mode: link, path: ../../maintenance/manual/toc_p.yaml }
+- name: Мониторинг
+  items:
+    - name: Настройка мониторинга локального кластера YDB
+      href: ../../administration/monitoring.md
+    - name: Дашборды Grafana
+      href: ../../administration/grafana-dashboards.md
+    - name: Справочник метрик
+      href: ../../reference/observability/metrics/index.md
+    - name: Трассировка
+      include: { mode: link, path: ../../reference/observability/tracing/toc_p.yaml }
+- name: Обновление
+  href: ../../administration/upgrade.md
+- name: Изменение конфигурации актор-системы
+  href: ../../maintenance/manual/change_actorsystem_configs.md
+- name: Управление конфигурацией кластера
+  items:
+  - name: Обзор конфигурации
+    href: ../../maintenance/manual/config-overview.md
+  - name: Статическая конфигурация кластера
+    href: ../../deploy/configuration/config.md
+  - name: Динамическая конфигурация кластера
+    href: ../../maintenance/manual/dynamic-config.md
+  - name: DSL конфигурации кластера
+    href: ../../maintenance/manual/dynamic-config-selectors.md
+  - name: Временная конфигурация
+    href: ../../maintenance/manual/dynamic-config-volatile-config.md
+  - name: Изменение конфигураций через CMS
+    href: ../../maintenance/manual/cms.md
 - name: Системные таблицы
   href: system-views.md
+- name: Логирование
+  href: logging.md

ydb/docs/ru/core/cluster/logs.md

@@ -1,6 +1,6 @@
 # Системные требования и рекомендации для {{ ydb-short-name }}
 
-В данном разделе приводятся рекомендации для развертывания кластеров {{ ydb-short-name }}, применимые вне зависимости от выбранного способа управления инфраструктурой ([Ansible](ansible/index.md), [Kubernetes](kubernetes/index.md), или [вручную](../cluster/index.md)).
+В данном разделе приводятся рекомендации для развертывания кластеров {{ ydb-short-name }}, применимые вне зависимости от выбранного способа управления инфраструктурой ([Ansible](ansible/index.md), [Kubernetes](kubernetes/index.md), или [вручную](manual/index.md)).
 
 ## Аппаратная конфигурация {#hardware}