Подключение 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

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

   • BaseUri - базовый URL пространства monq.

   • ApiKey - скопированный ключ на 7-м шаге создания координатора.

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-м шаге при создании Координатора