Перейти к основному содержимому

Непрерывная архивация логов OceanBase Database

Внимание!

:title: Экспериментальная возможность

Команда copywala-ob archive-logs <tenant name> утилиты Copywala OB является экспериментальной возможностью.

Работоспособность экспериментальной возможности не гарантируется. Применять ее можно только в предварительно подготовленном тестовом окружении.

примечание

Исполнять сценарий необходимо от имени пользователя pbr.

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

Команда copywala-ob archive-logs <tenant name> запускает непрерывную архивацию логов указанного тенанта OceanBase Database на хранилище. Команда подключается к базе данных по данным секции target_db из конфигурационного файла copywala-ob.yaml, к хранилищу по logs_destination_uri, и непрерывно архивирует логи вплоть до остановки процесса.

Запущенный процесс непрерывной архивации логов может быть использован командой create-backup: если архивация уже запущена, команда create-backup использует существующий поток и не останавливает его после создания РК.

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

Перед запуском непрерывной архивации логов убедитесь, что:

  • агент copywala-ob инициализирован (сценарий );

  • в конфигурационном файле copywala-ob.yaml настроены параметры:

    • target_db – учетные данные для подключения к OceanBase Database;
    • logs_destination_uri – путь до хранилища архива логов, параметр обязателен для команды;
    • s3_logs_server – параметры доступа к хранилищу логов.

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

Шаги сценария:

  1. Убедитесь, что настройки подключения к целевой базе данных OceanBase Database (секция target_db) и путь в хранилище для архива логов (logs_destination_uri), указанные в конфигурационном файле copywala-ob.yaml, являются корректными.

  2. Запустите непрерывную архивацию логов через CLI компонента Copywala OB командой copywala-ob archive-logs <tenant name>. В процессе выполнения команда:

    • подключается к базе данных OceanBase Database по данным секции target_db;
    • подключается к хранилищу по параметру logs_destination_uri и запускает непрерывную архивацию логов указанного тенанта;
    • непрерывно архивирует логи до остановки процесса.
  3. Для остановки архивации завершите процесс. При завершении процесса архивация корректно останавливается (в лог выводится сообщение archive logs stopped).

Результат​

Процесс выполнения команды выводится в лог.

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

  • Не удалось установить подключение к целевой базе данных или хранилищу.
  • Не задан logs_destination_uri в конфигурационном файле (сообщение empty logs_destination_uri).
  • Агент не инициализирован (сообщение failed to load agent-id).