---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/devops/enterprise-manager.md
  - https://ydb.tech/docs/ru/devops/enterprise-manager.md
  - href: ru/devops/enterprise-manager/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/devops/enterprise-manager/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# YDB Enterprise Manager

YDB Enterprise Manager (далее — YDB EM) — это инструмент для централизованного управления кластерами YDB через веб-интерфейс и API.

{% note info %}

Развёртывание кластеров YDB возможно без YDB EM — с помощью [Ansible](https://ydb.tech/docs/ru/devops/deployment-options/ansible/index.md), [Kubernetes](https://ydb.tech/docs/ru/devops/deployment-options/kubernetes/index.md) или [вручную](https://ydb.tech/docs/ru/devops/deployment-options/manual/index.md). YDB EM предоставляет удобный веб-интерфейс поверх уже существующих кластеров.

{% endnote %}

## Назначение {#purpose}

YDB EM подключается к существующим кластерам YDB и предоставляет графический интерфейс и API для решения следующих задач:

* централизованный доступ к базам данных и кластерам YDB из единого интерфейса;
* управление динамическими узлами кластера — запуск, остановка, масштабирование;
* управление базами данных — создание, удаление, изменение параметров;
* мониторинг состояния кластера и узлов;
* управление ресурсами (CPU, RAM), выделенными для динамических узлов;
* адвизор — диагностика и рекомендации по устранению наиболее распространённых проблем;
* расширенный SQL-редактор для выполнения запросов к базам данных;
* AI-ассистент для работы с YDB.

{% note warning %}

YDB EM не развёртывает кластер YDB. Перед использованием YDB EM кластер должен быть развёрнут одним из [способов развёртывания](https://ydb.tech/docs/ru/devops/deployment-options/index.md).

{% endnote %}

## Архитектура {#architecture}

YDB EM состоит из трёх компонентов:

* **Gateway** — веб-интерфейс и API-бэкенд. Принимает запросы от пользователей (через браузер или API) и взаимодействует с Control Plane и базой данных YDB EM.
* **Control Plane (CP)** — координирует управление кластером. Получает команды от Gateway, хранит конфигурацию в базе данных YDB EM и отправляет задания агентам.
* **Agent** — запускается на каждом хосте кластера YDB, на котором работают динамические узлы. Агент выполняет команды Control Plane: запускает и останавливает процессы узлов YDB, следит за их состоянием и передаёт информацию о доступных ресурсах хоста.

Для хранения собственных метаданных (конфигурация кластеров, состояние узлов) YDB EM использует базу данных YDB — она может располагаться в том же кластере, которым управляет EM.

### Схема взаимодействия {#interaction-diagram}

```mermaid
flowchart LR
    User[Пользователь] -- "HTTP/HTTPS" --> Gateway

    subgraph YDBEM [YDB EM]
        Gateway[Gateway]
        CP[Control Plane]
        EMDB[(YDB EM DB)]
        Gateway -- "gRPC" --> CP
        Gateway -- "gRPC" --> EMDB
        CP -- "gRPC" --> EMDB
    end

    subgraph Cluster [Кластер YDB]
        subgraph Host1 [Хост 1]
            Node1[Узел YDB]
            Agent1[Agent]
        end
        subgraph Host2 [Хост 2]
            Node2[Узел YDB]
            Agent2[Agent]
        end
        subgraph Host3 [Хост N]
            Node3[Узел YDB]
            Agent3[Agent]
        end
    end

    CP -- "gRPC" --> Agent1
    CP -- "gRPC" --> Agent2
    CP -- "gRPC" --> Agent3
    Agent1 -- "gRPC" --> CP
    Agent2 -- "gRPC" --> CP
    Agent3 -- "gRPC" --> CP
```

Пользователь взаимодействует с Gateway через браузер или API. Gateway передаёт запросы в Control Plane, который координирует работу агентов на хостах кластера. Агенты управляют процессами узлов YDB и сообщают о состоянии хостов.

## Основные материалы {#materials}

- [Первоначальное развёртывание YDB EM](https://ydb.tech/docs/ru/devops/enterprise-manager/initial-deployment.md)
