Запрос рекомендации настройки политики резервного копирования с помощью AI-Advisor

Требуемая роль

Администратор БД, администратор СРК.

Описание сценария

Сценарий предназначен для получения рекомендации по настройке политики резервного копирования для указанного агента PBR-Agent. Для ее формирования используется подсистема CLI-утилиты Recovery Manager – AI-Advisor, которая анализирует результаты последних 500 задач резервного копирования, агрегирует данные по уникальным конфигурациям политик и на основе целевых показателей RTO/RPO формирует рекомендацию с оценкой уверенности модели и уровня риска. Это позволяет подобрать оптимальные значения для параметров политики резервного копирования на основе фактических данных.

Внимание!

Запрос рекомендации будет работать и при количестве задач менее 500, но количество задач влияет на степень уверенности в правильности рекомендации (model_confidence) и на уровень риска (risk_level). Чем больше исторических данных о задачах резервного копирования доступно, тем более надежной и обоснованной будет сформированная рекомендация. При этом 500 является лимитом — AI-Advisor анализирует не более 500 последних задач.

к сведению

Функциональность не изменяет существующие механизмы создания, хранения и применения политик резервного копирования. Рекомендации носят консультативный характер и предоставляют дополнительный способ настройки политик резервного копирования на основании накопленной эксплуатационной статистики и целевых показателей восстановления. Изменение параметров политики резервного копирования выполняется только при явном вызове пользователем команды recovery-manager advisor apply.

Предусловия

Выполнен вход в Recovery Manager.
Настроена интеграция с AI-агентом.
Сервисы Task Manager и AI-агент (LLM-провайдер) доступны.

Последовательность выполнения

Запрос рекомендации

Инициируйте получение рекомендации через CLI компонента Recovery Manager командой recovery-manager advisor recommend (ознакомьтесь со справкой по команде ниже).

Справка по команде recovery-manager advisor recommend

Описание:

Запрос рекомендации по настройке политики резервного копирования для заданного агента PBR-Agent на основании целевых значений RPO (Recovery Point Objective) и RTO (Recovery Time Objective). Если значения RPO и RTO не переданы в команде флагами --rpo и --rto, используются значения по умолчанию: RPO = 15m (15 минут), RTO = 1h (1 час).

Команда анализирует последние 500 задач резервного копирования, агрегирует результаты по уникальным конфигурациям политик и с помощью AI-агента (внешнего LLM-провайдера) формирует рекомендацию с оценкой уверенности модели и уровня риска.

Синтаксис:

recovery-manager advisor recommend <agent-id> [flags]

Обязательные параметры:

<agent-id> – уникальный идентификатор агента PBR-Agent, для которого необходимо получить рекомендацию.

Опциональные параметры:

[flags] – доступны следующие флаги:

Флаг	Описание
`-h\|--help`	Показать справку по команде
`--rto <duration>`	Целевой Recovery Time Objective (по умолчанию: `1h`). Пример значений: `4h`, `30m`
`--rpo <duration>`	Целевой Recovery Point Objective (по умолчанию: `15m`). Пример значений: `15m`, `1h`

Recovery Manager автоматически выполнит следующие действия:

Соберет телеметрические данные о последних 500 задачах резервного копирования для переданного в команде агента <agent-id>.
Агрегирует результаты по уникальным конфигурациям политик резервного копирования с расчетом статистики успешности.
Сформирует запрос с целевыми RTO/RPO и данными телеметрии и отправит его в AI-агент через OpenAI-compatible API.
Получит и выведет рекомендацию в формате YAML.

Применение рекомендации

Для применения полученной рекомендации к указанному агенту выполните команду recovery-manager advisor apply (ознакомьтесь со справкой по команде ниже).

Справка по команде recovery-manager advisor apply

Описание:

Применение ранее полученной рекомендации политики резервного копирования для заданного агента PBR-Agent. Команда извлекает сохраненную политику, полученную при выполнении команды recovery-manager advisor recommend, и применяет ее к указанному агенту. В результате применения происходит обновление значений параметров конфигурационного файла copywala.yaml согласно полученной рекомендации.

примечание

Команда advisor apply работает только в prompt-режиме (интерактивном сеансе) после предварительного выполнения advisor recommend в той же сессии. При вызове advisor apply как отдельной команды из командной строки (например, сразу после recovery-manager advisor recommend) рекомендация не будет найдена, так как она хранится в оперативной памяти запущенного экземпляра утилиты и обнуляется после его завершения.

Синтаксис:

recovery-manager advisor apply <agent-id> [flags]

Обязательные параметры:

<agent-id> – уникальный идентификатор агента PBR-Agent, к которому необходимо применить рекомендацию.

Опциональные параметры:

[flags] – доступны следующие флаги:

Флаг	Описание
`-h\|--help`	Показать справку по команде

:caption: Пример вывода при применении рекомендации

$ advisor apply 019f0349-47b7-737a-8d33-fddbba8649a9

Backup policy applied successfully on agent 019f0349-47b7-737a-8d33-fddbba8649a9

Результат

В стандартный вывод будет выведена рекомендация в формате YAML:

:caption: Пример

$ advisor recommend 019f0349-47b7-737a-8d33-fddbba8649a9

recommendation_reason: Данная конфигурация демонстрирует 100% успешность выполнения (100 задач) без единого сбоя. Дифференциальные и инкрементальные резервные копии завершаются за 4–18 минут, что укладывается в целевые окна RPO и RTO. Политику рекомендуется из-за максимальной наблюдаемой надежности и наибольшего объема подтвержденных данных в телеметрии.

backup_policy:
  fast_checkpoint: true
  workers_no: 8
  read_direct_io: true
  write_direct_io: true
  write_parts_workers_no: 16
  write_wals_workers_no: 4
  verify_page_checksums: true

model_confidence: 0.95

risk_level: LOW

Описание параметров ответа

Параметр

Тип

Описание

recommendation_reason

string

Краткое объяснение наблюдения, которое привело к рекомендации

backup_policy

object

Рекомендуемая конфигурация политики резервного копирования. Может содержать от 1 до 8 параметров (все 8 запрашиваются через промпт, но модель может вернуть подмножество):

Параметр	Описание
`fast_checkpoint`	Флаг для переключения типа контрольной точки, по умолчанию `spread` (протяженная), при включении запускает принудительное создание контрольной точки сразу при начале создания базовой РК
`workers_no`	Количество параллельных потоков, осуществляющих чтение из каталога PGDATA с диска (не включая WAL-файлы)
`read_direct_io`	Режим чтения данных из файлов, исключая использование кеша ОС
`write_direct_io`	Режим записи данных в файл без использования кеша ОС (актуально для локальных РК)
`read_cache_size`	Размер кеша чтения. Значение параметра должно быть кратно 4 КБ на Linux. Используйте совместно с `read_direct_io` для РК произвольной папки
`write_parts_workers_no`	Количество параллельных рабочих процессов (workers), выполняющих операцию записи отдельных партов
`write_wals_workers_no`	Количество параллельных рабочих процессов (workers), выполняющих обработку WAL-файлов
`verify_page_checksums`	Активация проверки контрольных сумм страниц во время исполнения РК

model_confidence

float

Значение от 0.0 до 1.0 отражает степень уверенности модели в правильности рекомендации на основе доступных данных:

≥ 0.7 — высокая уверенность. Рекомендация надежна и может быть применена.
0.4–0.7 — средняя уверенность. Рекомендация обоснована, но рекомендуется дополнительная проверка.
< 0.4 — низкая уверенность. Рекомендация ненадежна. Рекомендуется накопить больше данных и повторить запрос.

risk_level

enum

Уровень риска:

LOW – рекомендация поддерживается сильными данными, большой выборкой;
MEDIUM – рекомендация обоснована, но выборка ограничена;
HIGH – данные противоречивы или выборка мала. Рекомендуется накопить больше данных и повторить запрос;
CRITICAL – недостаточно данных для надежной рекомендации. Рекомендуется накопить больше данных и повторить запрос;

Исключительные сценарии

Сценарий	Сообщение в выводе	Возможная причина	Решение
Указан некорректный уникальный идентификатор агента PBR-Agent, для которого необходимо получить рекомендацию	`invalid agent uuid`	Переданный в команде `recovery-manager advisor recommend` аргумент `<agent-id>` некорректного формата (например, опечатка, неполный идентификатор или использование имени агента вместо идентификатора)	Проверьте корректность идентификатора агента. Получить актуальный список агентов и их идентификаторов можно командой `recovery-manager agent list`
Ошибка при создании клиента для взаимодействия с Task Manager	`failed to initialized task manager client`	Не настроен адрес API-gateway (`api_gateway.address`), истек срок действия токена авторизации или нарушена сетевая доступность API-gateway	Проверьте значение параметра `api_gateway.address` в конфигурационном файле `recovery-manager.yaml`
Ошибка при получении информации о задачах резервного копирования	`failed to get latest tasks`	Task Manager недоступен или не отвечает, нарушена сетевая доступность между Recovery Manager и Task Manager (через API-gateway), истек токен авторизации, или для указанного агента нет задач резервного копирования	Проверьте, что Task Manager запущен и доступен. Убедитесь в корректности параметра `api_gateway.address` в `recovery-manager.yaml`
Ошибка формирования запроса к AI-агенту	`build prompt`	Ошибка сериализации телеметрических данных в JSON, полученных от Task Manager	Повторите выполнение команды
Ошибка при отправке запроса к AI-агенту или при получении от него ответа	`send request to AI hub`	AI-агент недоступен (сервер остановлен), URL недостижим из сети, недействительный API-ключ (`401 Unauthorized`), превышен лимит запросов (`429 Too Many Requests`) или модель не вернула ответ (`chat completion returned no choices`)	Проверьте параметры `ai.api_key`, `ai.base_url`, `ai.model` в `copywala.yaml`. Убедитесь, что AI-агент доступен из вашей сети. При необходимости запросите новый API-ключ для доступа к AI-агенту
Невозможно десериализовать JSON-поле `task.Policy` задачи резервного копирования. Задача пропускается при агрегации, обработка продолжается для остальных задач	`failed to parse policy config`	Поле `policy` в задаче резервного копирования содержит некорректный JSON или структуру, не соответствующую ожидаемой схеме (например, данные были повреждены)	Если ошибка возникает для большинства задач, убедитесь, что агент PBR-Agent обновлен до актуальной версии. В остальном ошибка не блокирует работу команды – проблемные задачи пропускаются, а анализ продолжается на основе оставшихся данных
Указан некорректный уникальный идентификатор агента PBR-Agent при применении рекомендации	`invalid agent uuid`	Переданный в команде `recovery-manager advisor apply` аргумент `<agent-id>` некорректного формата (например, опечатка, неполный идентификатор или использование имени агента вместо идентификатора)	Проверьте корректность идентификатора агента. Получить актуальный список агентов и их идентификаторов можно командой `recovery-manager agent list`
Для указанного агента отсутствует сохраненная рекомендация политики резервного копирования	`no backup policy found for agent <agent-id>`	Команда `recovery-manager advisor recommend` ранее не выполнялась для указанного агента в текущей сессии, сессия была завершена, или утилита была перезапущена	Выполните команду `recovery-manager advisor recommend <agent-id>` в текущей сессии перед применением рекомендации
Ошибка при создании клиента для взаимодействия с Agent Manager	`failed to initialized agent manager client`	Не настроен адрес API-gateway (`api_gateway.address`), истек срок действия токена авторизации или нарушена сетевая доступность API-gateway	Проверьте значение параметра `api_gateway.address` в конфигурационном файле `recovery-manager.yaml`
Ошибка применения политики резервного копирования	`failed to apply backup policy`	Agent Manager недоступен или не отвечает, нарушена сетевая доступность между Recovery Manager и Agent Manager (через API-gateway), или переданная политика не прошла валидацию на стороне сервера	Проверьте, что Agent Manager запущен и доступен. Убедитесь в корректности параметра `api_gateway.address` в `recovery-manager.yaml`. При повторении ошибки обратитесь к документации Agent Manager для проверки правил валидации политики резервного копирования

Описание сценария​

Предусловия​

Последовательность выполнения​

Запрос рекомендации​

Применение рекомендации​

Результат​

Описание параметров ответа​

Исключительные сценарии​