Установка компонента Kintsugi agent (DBDA) (опциональный)#

Цель выполнения#

Установка компонента Kintsugi agent (DBDA) необходима, чтобы:

• Получать метрики хоста (CPU, память, и другие).

• Просматривать логи.

• Находить установленные СУБД (PostgreSQL или Platform V Pangolin DB) на том же хосте, где установлен агент.

Последовательность действий#

Установка компонента Kintsugi agent (DBDA) делится на этапы:

1. Ручная установка

2. Настройка интеграций

3. Проверка результата

Ручная установка#

Перед началом установки убедитесь, что выполнена подготовка окружения.

Для установки Kintsugi agent (DBDA) выполните следующие шаги от имени привилегированного пользователя:

1. Распакуйте содержимое архива kgagent.tar.gz.

2. Выполните установку пакета kgagent-X.X.X-XX.x86_64.rpm.

   Пример установки с помощью менеджера пакетов RPM:

   rpm -i kgagent-X.X.X-XX.x86_64.rpm
   

   Пример установки с помощью менеджера пакетов YUM:

   yum install kgagent-X.X.X-XX.x86_64.rpm
   

3. Выполните конфигурацию сервиса KgAgent в файле /etc/kgagent/config.yaml.

   Описание конфигурационного файла представлено в разделе Настройка интеграций.

   Примечание

   Проверьте, что определены корректные:

   • Пути в блоке database_path.

   • Параметры сбора логов БД logger.

   • Параметры конфигурации Lua-приложений luavm.

4. Настройка прав пользователя:

   • Убедитесь, что имеется доступ к исполнению pg_auth_config и pangolin-manager-ctl/patronictl. Путь к этим утилитам должен быть добавлен в переменную окружения PATH.

   • Убедитесь, что имеются права на чтение содержимого директории /pgdata, где хранятся данные PostgreSQL.

5. Настройка KgAgent для работы с системой управления секретами:

   • Если требуется интеграция Kintsugi agent (DBDA) с хранилищем секретов Secret Management System (далее – SecMan):

     1. Сконфигурируйте параметры блока certificate.secman в файле /etc/kgagent/config.yaml.

        Описание параметров представлено в пункте Конфигурация Kintsugi agent (DBDA) для интеграции с SecMan.

     2. Запустите инициализацию локального хранилища секретов, выполнив команду:

          kgagent init -config /etc/kgagent/config.yaml -role_id <role_id> -secret_id <secret_id>
        

        , где замените значения:

        • <role_id>: идентификатор роли для аутентификации в сервисе SecMan.

        • <secret_id>: ключ JSON-объекта, по которому будет получено значение токена.

   • В случае отсутствия интеграции Kintsugi agent (DBDA) с системой управления секретами, сконфигурируйте параметры certificate.inmemory.path_to_client_cert и certificate.inmemory.path_to_root_cert в файле /etc/kgagent/config.yaml.

     Описание параметров представлено в пункте Конфигурация Kintsugi agent (DBDA) в случае отсутствия интеграции с HashiCorp Vault.

6. Запустите сервис, выполнив команду:

   systemctl start kgagent
   

7. Проверьте статус сервиса, выполнив команду:

   systemctl status kgagent
   

8. Настройте лимиты systemd:

   1. Отредактируйте файл службы KgAgent в systemd, чтобы задать лимиты памяти и CPU:

      sudo systemctl edit kgagent
      

   2. Добавьте в открывшемся файле:

      [Service]
      MemoryMax=512M
      CPUQuota=200%
      

      Рекомендуется:

      • Установить MemoryMax лимит памяти в 512 МБ.

      • Установить CPUQuota лимит CPU в 200%.

   3. Перезапустите службу:

      sudo systemctl daemon-reload
      sudo systemctl restart kgagent
      

Вычисление контрольной суммы find_postgres.sh#

Для вычисления контрольной суммы файла find_postgres.sh, входящего в RPM-пакет KgAgent, выполните команду:

rpm -qp --dump kgagent-X.X.X-XX.x86_64.rpm | grep find_postgres.sh

, где: X.X.X-XX – версия компонента.

Настройка интеграций#

Настройка интеграции с системой управления секретами#

Настройка интеграции с системой управления секретами конфигурируется в одном из двух блоков:

• certificate.secman – если требуется интеграция Kintsugi agent (DBDA) с хранилищем секретов Secret Management System (далее – SecMan).

• certificate.inmemory – в случае отсутствия интеграции Kintsugi agent (DBDA) с системой управления секретами.

Конфигурация Kintsugi agent (DBDA) для интеграции с SecMan#

Для интеграции с Kintsugi agent с SecMan определите следующие параметры в файле /etc/kgagent/config.yaml:

Конфигурация Kintsugi agent (DBDA) в случае отсутствия интеграции с HashiCorp Vault#

В случае отсутствия интеграции с HashiCorp Vault выполните конфигурацию следующих параметров:

Настройка интеграции Kintsugi agent (DBDA) с системой Kintsugi (DBCM)#

Для настройки интеграции Kintsugi agent (DBDA) с системой Kintsugi (DBCM) определите следующие параметры в файле /etc/kgagent/config.yaml:

Проверка результата#

Для валидации установки Kintsugi agent (DBDA) убедитесь, что:

1. Выполнена установка Kintsugi agent (DBDA) на хосте с наблюдаемыми БД.

   При выполнении команды systecmtl status kgagent в ответ получаем успешный статус запуска службы.

2. Выполнена интеграция Kintsugi agent (DBDA) с системой управления секретами.

   В логе KgAgent присутствует запись о корректном получении секретов из SecMan.

3. Выполнена интеграция Kintsugi agent (DBDA) с системой Kintsugi (DBCM).

   В логе KgAgent присутствует запись об успешном подключении к системе Kintsugi (DBCM).

4. Лимиты службы KgAgent (MemoryMax и CPUQuota) установлены в соответствии с рекомендациями.

   При выполнении команды systemctl status значения Memory и CPU не превышают установленные лимиты.