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

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

Установка компонента Kintsugi agent (DBDA) необходима в случае, если необходимо получать метрики хоста (CPU, память) и обнаруживать установленные СУБД (PostgreSQL) на том же хосте, где установлен агент.

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

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

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

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

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

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

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

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

   unzip /path/to/standard/DBDA-bin-X.X.X-XX_std-distrib.zip && \
   tar -xvf /path/to/standard/package/bh/kgagent-std.tar.gz
   

2. Скопируйте пакет kgagent-X.X.X-XX.x86_64.rpm на хост с наблюдаемой БД и выполните его установку:

   rpm -i /path/to/standard/kgagent-X.X.X-XX.x86_64.rpm
   

3. Если используются самоподписанные сертификаты, скопируйте сертификаты agent.crt и root_cert.crt из /path/to/standard/package/conf/conf/secrets/ssl на хост с наблюдаемой БД в директорию /etc/kgagent.

4. Выполните конфигурацию компонента kgagent:

   • Запустив /etc/kgagent/configure.sh и ответив на вопросы мастера установки:

     sudo /etc/kgagent/configure.sh
     Enter path to kgagent client certificate [kgagent.crt]: /Абсолютный/путь/к/agent.crt
     Enter path to root certificate [ca.crt]: /Абсолютный/путь/к/root_cert.crt
     Enter kintsugi host address [kintsugi.localhost]: ДОМЕН-ИЛИ-IP-АДРЕС-KINTSUGI
     

   • Вручную в файле /etc/kgagent/config.yaml:

     Название	Значение	Описание
     certificate.inmemory.path_to_client_cert	/etc/kgagent/agent.crt	Путь до файла сертификата agent.crt
     certificate.inmemory.path_to_root_cert	/etc/kgagent/root_cert.crt	Путь до файла сертификата удостоверяющего центра
     auth.base_url	https://<KINTSUGI_ADDRESS>	URL аутентификации
     auth.api_path	/	Путь к ресурсу аутентификации
     auth.header_client_cert	x-forwarded-client-cert	Заголовок запроса с сертификатом технического пользователя
     uploader.host	<KINTSUGI_ADDRESS>	Адрес хоста загрузки метрик
     uploader.port	443	Порт хоста загрузки метрик
     uploader.endpoint	/agents/stream	Endpoint для загрузки метрик
     uploader.ssl_enabled	true	Режим работы SSL
     metadata.hosts	<OBSERVED_DB_HOST>	Перечень адресов хостов наблюдаемых БД
     luavm.entry_point	/etc/kgagent/plugins/init.lua	Путь к основному Lua-приложению, с которого начинается выполнение
     luavm.std_libs	["", "math", "string", "table", "io", "os", "package", "debug", "channel", "kgsys"]	Список стандартных библиотек Lua, доступных в виртуальной машине. Пустая строка - базовые функции (_G)
     luavm.memory_limit	512	Максимальный объем памяти (в МБ), выделяемый для Lua-машины
     luavm.execution_timeout_sec	300	Максимальное время выполнения скрипта в секундах
     luavm.path	/etc/kgagent/plugins	Дополнительные пути поиска Lua-приложению (аналог package.path)

     Примечание

     Для запуска компонента kgagent из конфигурации по умолчанию необходимо исключить конфигурацию внешнего хранилища секретов certificate.secman.

5. Выполните запуск компонента kgagent:

   systemctl start kgagent
   

6. Убедитесь, что запуск прошел штатно и журнал событий не содержит ошибок:

   systemctl status kgagent
   journalctl -u kgagent
   

7. Выполните вход в веб-интерфейс Kintsugi (DBCM) и на вкладке Метрики создайте объект мониторинга для заданной БД.

   На дашборде Метрики отобразится информация по собранным метрикам хоста.

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

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

Для интеграции Kintsugi agent (DBDA) c HashiCorp Vault/Secret Management System (далее – SecMan) определите следующие параметры в файле /etc/kgagent/config.yml:

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

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

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

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

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

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

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