Настройка взаимодействия Агента 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» в основных настройках и нажимаем кнопку «Создать».
Для проверки подключения доступна команда «Проверить доступность»: