Перейти к основному содержимому
Версия: 9.0

Подключение агентов

Для подключения агента к платформе Monq необходимо создать координатор агентов - сущность, которая выполняет распределение заданий сборщиков данных на подключенные к нему агенты.

Создание координатора​

  1. Перейдите в раздел Сбор данных (ETL) - Агенты через главное меню

  2. Нажмите кнопку Создать координатор

  3. Заполните форму создания координатора:

    Изображение

    • Введите название координатора
    • Добавьте метки

      💡 Метки необходимы для связи конфигураций сборщиков данных с агентам, которые будут выполнять Yaml-задания

  4. Нажмите Создать, будет создан координатор и открыт экран управления им

    Изображение

  5. Скопируйте и сохраните API-ключ координатора, он потребуется при настройке агента

Следующим действием необходимо установить агент Monq. В зависимости от того, какой узел вы будете ставить на мониторинг, представлено две инструкции по установке агента на ОС Windows и ОС Linux.

Установка агента в ОС Windows​

Минимальная версия агента, совместимая с Monq 9.0 - 3.0.0

Запустите оболочку PowerShell от имени администратора и выполните следующие действия:

  1. Создайте директорию C:\monq-agent и перейдите в нее.

    PS C:\>
    PS C:\> mkdir monq-agent
    PS C:\> cd monq-agent
    PS C:\monq-agent>

  2. Загрузите актуальную версию агента для ОС Windows.

    PS C:\monq-agent> Invoke-WebRequest https://downloads.monq.ru/tools/monq-agent/v3.0.1/win-x64/monq-agent.zip -OutFile c:\monq-agent\monq-agent.zip

  3. Извлеките содержимое архива в папку, например: C:\monq-agent\monq-agent.exe

    PS C:\monq-agent> Expand-Archive -Path ".\monq-agent.zip" -DestinationPath ".\"

  4. Удалите ненужный теперь архив с агентом:

    PS C:\monq-agent> Remove-Item ".\monq-agent.zip"

  5. Создайте в директории с исполняемым файлом файл конфигурации monitoring-agent.conf:

    PS C:\monq-agent> Set-Content -Path ".\monitoring-agent.conf" -Encoding UTF8 -Force -Value @(
        'BaseUri="https://monq.youdomain.ru"'
        'ApiKey="fc63b95b-0393-430a-b8d0-46a8c4813675"'
        '[Plugins]'
        'Autoload=true'
        '[Agent]'
        'Name="monq-agent-windows-server"'
        'Description=""'
        'SlotsCount=4'
    )

    Замените значения в конфигурационном файле на свои:

    • BaseUri - базовый URL пространства Monq.
    • ApiKey - API-ключ координатора.

  6. Произведите пробный запуск агента командой monq-agent.exe start

    PS C:\monq-agent> .\monq-agent.exe start
    [2025-09-10 11:53:19 +03:00 INF]  [Http Plugin v3.0.1.0] was loaded.
    [2025-09-10 11:53:19 +03:00 INF]  [Tcp v3.0.1.0] was loaded.
    [2025-09-10 11:53:19 +03:00 INF]  [Udp v3.0.1.0] was loaded.
    [2025-09-10 11:53:19 +03:00 INF]  Loading plugins from C:\monq-agent\plugins...
    [2025-09-10 11:53:19 +03:00 INF]  3 plugins were loaded.
    [2025-09-10 11:53:19 +03:00 INF]  Started MetricsReporterService.
    [2025-09-10 11:53:19 +03:00 INF]  Starting service...
    [2025-09-10 11:53:19 +03:00 INF] ["HTTP GET https://***/api/public/pl/v1/agents/scheduler/version"] Start processing HTTP request GET https://***/api/public/pl/v1/agents/scheduler/version
    [2025-09-10 11:53:19 +03:00 INF] ["HTTP GET https://***/api/public/pl/v1/agents/scheduler/version"] Sending HTTP request GET https://***/api/public/pl/v1/agents/scheduler/version
    [2025-09-10 11:53:19 +03:00 INF]  Application started. Press Ctrl+C to shut down.
    [2025-09-10 11:53:19 +03:00 INF]  Hosting environment: Production
    [2025-09-10 11:53:19 +03:00 INF]  Content root path: C:\monq-agent
    [2025-09-10 11:53:20 +03:00 INF] ["HTTP GET https://***/api/public/pl/v1/agents/scheduler/version"] Received HTTP response headers after 304.976ms - 200
    [2025-09-10 11:53:20 +03:00 INF] ["HTTP GET https://***/api/public/pl/v1/agents/scheduler/version"] End processing HTTP request after 320.6513ms - 200
    [2025-09-10 11:53:20 +03:00 INF]  Establishing connection.
    [2025-09-10 11:53:21 +03:00 INF]  Connection established.

    Если запуск успешный и соединение установлено, о чем свидетельствует последняя строка, можно остановить выполнение сочетанием клавиш CTRL+C и перейти к следующему пункту конфигурации службы Windows.

    В случае возникновения ошибок с проверкой SSL сертификата можно временно добавить параметр --insecure в команду запуска.

  7. Для запуска агента в качестве службы Windows создайте и зарегистрируйте службу с помощью утилиты для командной строки Диспетчер управления службами Windows.

    PS C:\monq-agent> sc.exe create MonqAgent binPath= "C:\monq-agent\monq-agent.exe start --config C:\monq-agent\monitoring-agent.conf"

    В данном примере MonqAgent - это название службы, вы можете выбрать произвольное название.

    В случае возникновения ошибок с проверкой SSL сертификата можно временно добавить параметр --insecure в команду запуска binPath.

  8. Запустите службу

    PS C:\monq-agent> sc.exe start MonqAgent

На данном этапе подключение агента завершено.

Установка агента в ОС Linux​

Минимальная версия агента, совместимая с Monq 9.0 - 3.0.0

Для установки агента Monq в ОС Linux выполните следующие действия:

  1. Создайте директорию /opt/monq-agent и перейдите в нее:

    mkdir -p /opt/monq-agent && cd /opt/monq-agent

  2. Загрузите актуальную версию monq-agent используя команду wget:

    wget https://downloads.monq.ru/tools/monq-agent/v3.0.1/linux-x64/monq-agent.zip

  3. Разархивируйте загруженный архив monq-agent.zip в текущую директорию:

    unzip monq-agent.zip

  4. Сделайте двоичный файл monq-agent исполняемым в Linux:

    chmod +x ./monq-agent

  5. Создайте в директории /opt/monq-agent файл конфигурации агента - monitoring-agent.conf, следующего содержания:

    BaseUri="https://monq.youdomain.ru"
    ApiKey="fc63b95b-0393-430a-b8d0-46a8c4813675"
    [Plugins]
    Autoload=true
    [Agent]
    Name="monq-agent-linuxhost"
    Description=""
    SlotsCount=4

    Замените значения в конфигурационном файле на свои:

    • BaseUri - базовый URL пространства Monq.
    • ApiKey - API-ключ координатора.

  6. Создайте конфигурацию сервиса systemd для автоматического запуска агента.

    В директории /etc/systemd/system/ разместите файл конфигурации monq-agent.service следующего содержания:

    [Unit]
    Description=Monqlab Agent Service
    Documentation=https://docs.monq.ru/

    [Service]
    Type=notify
    WorkingDirectory=/opt/monq-agent
    ExecStart=/opt/monq-agent/monq-agent start --config /opt/monq-agent/monitoring-agent.conf
    StandardOutput=syslog
    User=root

    [Install]
    WantedBy=multi-user.target
    Alias=monq-agent.service

  7. Загрузите новый файл конфигурации в systemd (выполняется каждый раз при изменении файла monq-agent.service):

    sudo systemctl daemon-reload

  8. Проверьте статус сервиса monq-agent.service командой:

    sudo systemctl status monq-agent.service

    Текущий статус сервиса monq-agent.service будет Active: inactive (dead).

  9. Запустите сервис monq-agent.service командой:

    sudo systemctl start monq-agent.service

  10. Просмотрите результат запуска сервиса monq-agent.service командой:

    sudo journalctl -u monq-agent.service -f

    Об успешном запуске и подключении агента к платформе, свидетельствует запись в лог-файле:

    ...
    [2025-09-10 11:31:22 +03:00 INF]  Establishing connection.
    [2025-09-10 11:31:23 +03:00 INF]  Connection established.
    [2025-09-10 11:31:23 +03:00 INF]  0 work configurations were received for update.
    ...

На данном этапе подключение агента завершено.