Настройка взаимодействия Агента ETL и информационной базы ETL

3 минутное чтение

При использовании для сбора данных Агента ETL, он должен передавать информацию о ходе процесса сбора(логи, количественные данные и т.п.) в базу ETL. Эта передача выполняется асинхронно и для передачи используется http сервис базы ETL.

Для настройки взаимодействия Агента ETL с базой ETL необходимо выполнить следующие действия:

Опубликовать http сервис хс_ДанныеОтАгентов базы ETL на веб сервере;
Создать пользователя в базе ETL для подключения Агента ETL;
Настроить файл конфигурации Агента ETL;
Создать запись об Агенте ETL в базе ETL и проверить подключение.

Публикация базы ETL на веб-сервер

Для взаимодействия необходимо выполнить публикацию http сервиса хс_ДанныеОтАгентов на веб-сервере.

Инструкции по настройке веб-серверов и способах публикации доступны в руководстве администратора на сайте Информационно-технологического сопровождения 1C.

см. также Инструкция публикации IIS на инфостарт

Для публикации сервиса в пользовательском режиме необходимо:

Зайти конфигуратором в базу ETL, запустив его от Администратора.
В режиме конфигуратора перейти: “Администрирование/Публикация на веб. сервере…”.
В открывшемся окне выбрать вкладку HTTP сервисы и установить флаг напротив сервиса хс_ДанныеОтАгентов.
Сохранить настройки и перезагрузить веб-сервер.

Создание пользователя для подключения к HTTP сервису базы ETL

Пользователь создается следующим образом:

Необходимо создать(если еще не создана) группу доступа для агентов ETL. “Администрирование” -> “Настройка пользователей и прав” -> “Группа доступа”.
В группе доступа необходимо выбрать предустановленный профиль “Агент ETL”
Создать пользователя через “Администрирование” -> “Настройка пользователей и прав” -> “Пользователи” с привязкой к группе доступа из пункта 1.

Настройка setting.json

Следующим этапом является настройка setting.json.
Расположение:

в linux: /etc/agentetl/settings.json;
в Windows: C:\Program Files\AgentETL\settings.json.

Пример файла:

{
    ...
    "Login": "oAzwKP",
    "Password": "ysjjRwyG",
    ...
    "ETLLogURL": "http://*ЛОГИН*:*ПАРОЛЬ*@"Адрес_сервера"/"Название базы"/hs/AgentsUpload/Logs",
    "ETLLogInterval": 30,
    "ETLSuccessURL": "http://*ЛОГИН*:*ПАРОЛЬ*@"Адрес_сервера"/"Название базы"/hs/AgentsUpload/ack",
    ...
}

“Login”, “Password” - параметры, которые используются Агентом ETL при аутентификации внешних сервисов, отправляющих Агенту ETL команды.
Основным отправителем таких команд является база ETL. Поэтому значения из этих параметров, должны быть указаны и в базе ETL, в соответствующих настройках;
“ETLLogURL” - адрес публикации базы ETL, на который будет выполняться отправка логов Агентом ETL
“ETLLogInterval” - интервал отправки логов Агентом ETL в базу ETL
“ETLSuccessURL” - адрес публикации базы ETL, по которому выполняется прием квитанции от Агента ETL о завершении сбора данных
ЛОГИН и ПАРОЛЬ в “ETLLogURL” и “ETLSuccessURL” - логин и пароль пользователя, созданного в основной базе ETL, который будет использоваться Агентом ETL для подключения к публикации.

Настройка базы ETL для взаимодействия с Агентом

Для создания записи в базе ETL об Агенте необходимо сначала включить возможность использования Агентов. Для этого надо перейти в Главное -> Информация -> Основные настройки -> Настройки получения данных.

При активации этого признака, в базе ETL становится доступным использование функциональных возможностей Агентов ETL в части сбора данных, выполнения различных SQL скриптов. Последнее необходимо при разворачивании продукта Modus ETL на операционных системах семейства Linux.

Далее следует добавить АгентаETL с логином и паролем из файла настроек setting.json Агента ETL (параметры “Login”, “Password”).
Для этого переходим по гиперссылке “Агенты ETL” в основных настройках и нажимаем кнопку “Создать”.
Для проверки подключения доступна команда “Проверить доступность”.