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

Подключение Monq-agent

Агенты - программы, устанавливаемые и конфигурируемые на отдельных серверах для выполнения Заданий по сбору данных из внешних источников (информационных систем).

По умолчанию все Задания в создаваемых Потоках данных выполняются на системном Агенте Monq, который входит в поставку системы.

Если потребности в запуске внешнего агента нет - данный этап можно пропустить.

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

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

Изображение

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

  2. Нажмите кнопку Добавить координатор.

  3. Выберите владельца - Рабочую группу пользователей, которые будут иметь доступ к агенту.

  4. Введите название координатора.

  5. Добавьте метки, которые будут связывать выполнение заданий на данном координаторе.

    Изображение

  6. Нажмите Добавить - будет создан Координатор и открыта страница управления данным координатором.

    Изображение

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

  8. Следующим шагом установите и запустите Агент 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/latest/linux-x64/monq-agent.zip

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

    unzip monq-agent.zip

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

    chmod +x ./monq-agent

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

    # Базовый URI системы monq
    BaseUri="https://monq.domain.com"
    # API-ключ координатора для авторизации агента
    ApiKey="fc63b95b-0393-430a-b8d0-46a8c4813675"
    # Путь к хранилищу файлов (опционально)
    FileStorage=""
    # Таймаут выполнения заданий в секундах (опционально)
    Timeout=10

    # Настройки плагинов (опционально)
    [Plugins]
    # Путь к DLL плагинам C# linux
    CSharpPath="/opt/monq-agent/plugins"

    # Настройки соединения с координатором (опционально)
    [Connection]
    # Таймаут установки соединения в секундах
    Timeout=10
    # Количество попыток установки соединения
    RetryCount=12

    # Информация об агенте (опционально)****
    [Agent]
    # Название (опционально)
    # Name="monq-agent-hostname"
    # Описание
    Description=""
    # Количество слотов для параллельного выполнения заданий
    SlotsCount=2

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

  6. Скачайте и подключите к Агенту плагины

    В текущей версии агентов поддерживаются следующие плагины:

    • nagiosCheckConnection - плагин проверки соединения с системой мониторинга Nagios.
    • nagiosEventsDataFlow - плагин сбора данных с системы мониторинга Nagios.
    • scomCheckConnection - плагин для проверки соединения с системой мониторинга SCOM.
    • scomEventsDataFlow - плагин сбора данных с системы мониторинга SCOM.
    • vmwareEventsDataFlow - плагин сбора данных об изменениях в топологии VmWare vCenter.
    • vmwareTopologySync - плагин синхронизации топологии с VmWare vCenter.
    • zabbixCheckConnection - плагин проверки соединения с системой мониторинга Zabbix.
    • zabbixCheckVersion - плагин проверки версии Zabbix.
    • zabbixEventsDataFlow - плагин сбора данных с системы мониторинга Zabbix.
    • K8sMetricsDataFlow - плагин автообнаружения и сбора метрик с Kubernetes.
    • K8sTopologySync - плагин синхронизации топологии с Kubernetes.

    ⚠️ Плагины для Агентов можно скачать по ссылке.

    Для подключения плагина к Агенту:

    1. Разархивируйте архив с плагином в директорию указанную в конфигурационном файле, например: CSharpPath=/opt/monq-agent/plugins
    2. Перезапустите агент.
    3. Обнаруженный в директории плагин автоматически будет подключен к Агенту.

  7. Создайте конфигурацию сервиса 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

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

    sudo systemctl daemon-reload

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

    sudo systemctl status monq-agent.service

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

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

    sudo systemctl start monq-agent.service

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

    sudo journalctl -u monq-agent.service -f

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

    Nov 23 13:37:39 elk monq-agent[102088]: [2021-11-23 13:37:39 +03:00 INF]  Establishing connection.
    Nov 23 13:37:44 elk monq-agent[102088]: [2021-11-23 13:37:44 +03:00 INF]  Connection established.

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

Чтобы назначить выполнение Заданий на данном Агенте, необходимо в Потоке данных добавить соответствующую метку к Заданию.

Метка создается на 5-м шаге при создании Координатора