Управление агентами

Агенты INFRAX — это программные компоненты, устанавливаемые на серверы и рабочие станции для сбора детальных метрик мониторинга, выполнения скриптов и удаленного управления. Агенты обеспечивают глубокую интеграцию системы с инфраструктурой и позволяют получать данные, недоступные при обычном сетевом мониторинге.

ℹ️ О разделе

В этом разделе описаны операции установки, обновления, удаления агентов, диагностика их работы, управление видимостью и массовые действия.

Содержание раздела

Что такое агент

Агент INFRAX — это легковесный сервис, работающий на удаленных узлах (серверы, рабочие станции) и выполняющий следующие функции:

  • Сбор системных метрик — CPU, RAM, дисковое пространство, сетевой трафик
  • Мониторинг служб и процессов — контроль работы критичных приложений
  • Выполнение скриптов — удаленный запуск команд и сценариев
  • Обнаружение ПО — автоматическое определение установленных приложений
  • Управление контейнерами — интеграция с Docker, мониторинг контейнеров

Поддерживаемые платформы

Агенты INFRAX поддерживают:

Платформа Архитектуры Версии
Windows x64, ARM64, legacy (Win7/2008R2) Windows 7 / Server 2008 R2 и выше
Linux amd64, 386, arm64, arm Все современные дистрибутивы
⚠️ Требования

Для установки агентов на узлах необходимо:

  • Windows: настроенные учетные данные для RDP/WinRM
  • Linux: настроенные учетные данные для SSH с правами sudo
  • Доступность узла по сети для серверной части INFRAX

Просмотр агентов

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

  1. В боковом меню выберите Узлы сети
  2. В верхней части страницы найдите переключатель режимов отображения
  3. Выберите режим "Группировка по агентам" или аналогичный (зависит от версии)
ℹ️ Примечание

В режиме просмотра агентов отображаются только узлы типа SSH и RDP с операционными системами Windows и Linux. Другие типы узлов не поддерживают установку агентов и не отображаются.

Панель статистики

В верхней части экрана отображается панель со статистикой агентов:

Карточка Описание
Всего узлов сети Общее количество узлов с поддержкой агентов (SSH/RDP)
Агенты актуальные Количество узлов с установленными актуальными агентами
Устаревшие агенты Количество узлов, на которых установлена старая версия агента
Без агентов Количество узлов, на которых агенты не установлены
Скрыты Количество узлов, скрытых из списка (не требуют агентов)
Нет ответа >10 мин Количество узлов, от которых нет связи более 10 минут

Карточки статистики являются фильтрами — клик по карточке отфильтрует список узлов по соответствующему статусу.

Статусы агентов

Каждый агент может находиться в одном из следующих статусов:

Статус Бейдж Описание
Установлен Установлен Агент установлен, работает и имеет актуальную версию
Устарел Устарел Агент установлен, но версия ниже текущей в системе
Не установлен Не установлен Агент не установлен или был удален
Нет ответа Нет ответа Агент установлен, но не отвечает более 10 минут
Скрыты Скрыты Узел скрыт из списка (не требует установки агента)
💡 Автоматическое обновление

Статистика активности агентов автоматически обновляется каждые 2 минуты. Также вы можете обновить данные вручную, нажав кнопку "Обновить".

Режимы отображения

Интерфейс управления агентами поддерживает два режима отображения:

Табличное представление

Режим "Таблица" отображает узлы в виде таблицы с колонками:

  • Статус агента — текущий статус с бейджем
  • Узел сети — название узла с иконкой ОС и путь в иерархии
  • IP-адрес — сетевой адрес узла
  • ОС — операционная система (Windows/Linux)
  • Версия агента — установленная версия агента (если есть)
  • Последняя активность — время последней связи с агентом
  • Действия — кнопки управления агентом

Возможности табличного режима:

  • Поиск по всем полям (глобальный поиск)
  • Фильтры по каждой колонке (выпадающее меню в заголовке)
  • Сортировка по любой колонке (клик по заголовку)
  • Множественная сортировка (Shift + клик)
  • Выбор узлов для массовых действий (чекбоксы)

Древовидное представление

Режим "Дерево" отображает узлы в виде иерархической структуры папок:

  • Сохраняет структуру организации узлов
  • Показывает статус агента компактными бейджами
  • Поддерживает выбор целых папок (чекбоксы с промежуточным состоянием)
  • Отображает IP-адреса рядом с названиями узлов
  • Кнопки действий доступны при наведении

Переключение режимов: используйте кнопки-табы в верхней панели для переключения между режимами "Таблица" и "Дерево".

Установка агентов

INFRAX поддерживает автоматическую и ручную установку агентов.

Автоматическая установка

Для автоматической установки агента на узел:

  1. Найдите узел в списке (таблица или дерево)
  2. Нажмите кнопку установки ⬇️ (иконка загрузки, зеленая кнопка)
  3. Подтвердите действие в диалоговом окне
  4. Дождитесь завершения установки

Что происходит при автоматической установке:

  • Windows: подключение через WinRM/RDP, копирование агента, создание и запуск службы
  • Linux: подключение через SSH, копирование бинарного файла, установка systemd-службы, запуск
⚠️ Требования для автоматической установки
  • Узел должен иметь настроенные учетные данные (унаследованные или собственные)
  • Для Windows требуется доступ по WinRM или RDP с правами администратора
  • Для Linux требуется SSH-доступ с правами sudo
  • Брандмауэр должен разрешать подключения к узлу

Отслеживание процесса установки

После запуска установки создается задача в системе задач. Вы можете отслеживать ее прогресс:

  • В интерфейсе отображается индикатор выполнения
  • При успешной установке статус узла изменится на "Установлен"
  • При ошибке отобразится описание проблемы
  • Логи установки доступны в разделе истории задач

Обновление агентов

Когда в системе появляется новая версия агента, устаревшие агенты отмечаются статусом "Устарел".

Обновление одного агента

  1. Найдите узел с устаревшим агентом (статус "Устарел")
  2. Нажмите кнопку обновления ⬆️ (иконка стрелки вверх, оранжевая кнопка)
  3. Подтвердите действие
  4. Дождитесь завершения обновления

В колонке "Версия агента" отображается:

  • Текущая версия — установленная версия агента
  • Доступная версия — версия, до которой можно обновить (если агент устарел)
ℹ️ Процесс обновления

При обновлении агента:

  • Старая версия агента останавливается
  • Бинарный файл заменяется на новый
  • Агент запускается заново
  • Перерыв в мониторинге минимален (обычно менее 1 минуты)

Удаление агентов

Для удаления агента с узла:

  1. Найдите узел в списке
  2. Нажмите кнопку удаления 🗑️ (иконка корзины, красная кнопка)
  3. Подтвердите удаление в диалоговом окне
  4. Дождитесь завершения операции

Что происходит при удалении:

  • Windows: остановка службы INFRAXAgent, удаление файла C:\Windows\INFRAXAgent.exe, удаление службы
  • Linux: остановка службы INFRAXAgent, удаление файлов из /opt/infrax-agent/, удаление символической ссылки /usr/bin/infraxagent
⚠️ Последствия удаления

После удаления агента:

  • Перестанет поступать детальная информация о системных метриках
  • Не будут доступны функции выполнения скриптов
  • Не будет работать мониторинг Docker-контейнеров
  • Базовый ping-мониторинг останется активным

Ручная установка

В некоторых случаях автоматическая установка невозможна (ограничения безопасности, отсутствие сетевого доступа). В этом случае используется ручная установка.

Скачивание агента

Для скачивания агента:

  1. В интерфейсе управления агентами нажмите кнопку "Ручная установка" (иконка гаечного ключа)
  2. Откроется модальное окно с доступными версиями агентов
  3. Выберите нужную версию:
Платформа Версии для скачивания
Windows Windows (x64), Windows (ARM64), Windows legacy (Win7/2008R2)
Linux Linux (amd64), Linux (386), Linux (arm64), Linux (arm)

Инструкция для Linux

  1. Скачайте подходящий бинарный файл и загрузите на сервер (например, в /tmp)
  2. Выдайте права на исполнение: 
    sudo chmod +x /tmp/infraxagent*
  3. Установка службы и бинаря: 
    sudo /tmp/infraxagent* install
  4. Запустите агент: 
    sudo /usr/bin/infraxagent start

Файлы агента в Linux:

  • Бинарный файл: /opt/infrax-agent/infraxagent
  • Символическая ссылка: /usr/bin/infraxagent
  • Служба: INFRAXAgent
  • Логи: /opt/infrax-agent/logs

Инструкция для Windows

  1. Скачайте подходящий файл агента и перенесите на целевой сервер в любую папку (после установки можно удалить)
  2. Запустите от имени администратора: двойной клик или через PowerShell
  3. Выберите пункт меню «Установить сервис» и после этого запустите агент (будет предложено сделать это автоматически)

Файлы агента в Windows:

  • Бинарный файл: C:\Windows\INFRAXAgent.exe
  • Служба: INFRAXAgent
  • Логи: C:\ProgramData\INFRAXAgent\logs
💡 Совет

В модальном окне ручной установки отображается информационное сообщение: "Предпочтительно использовать автоматическую установку агентов на этой странице. Скачивание ниже — запасной вариант." Используйте ручную установку только когда автоматическая невозможна.

Управление видимостью

Не все узлы с SSH/RDP требуют установки агентов. Чтобы не загромождать интерфейс, такие узлы можно скрыть.

Скрытие узла

Для скрытия узла из списка агентов:

  1. Найдите узел в списке
  2. Нажмите кнопку 🚫 (иконка запрета, серая кнопка)
  3. Узел получит статус "Скрыты"

Скрытые узлы:

  • Не отображаются в общем списке (если не активен фильтр "Скрыты")
  • Не учитываются в статистике активных агентов
  • Реальный статус агента сохраняется (можно увидеть при наведении)

Восстановление видимости

Для восстановления видимости узла:

  1. Кликните по карточке "Скрыты" в панели статистики
  2. Найдите нужный узел в отфильтрованном списке
  3. Нажмите кнопку ✓ (иконка галочки, зеленая кнопка)
  4. Узел вернется в общий список с реальным статусом агента
ℹ️ Когда скрывать узлы

Рекомендуется скрывать узлы, на которых:

  • Установка агентов невозможна по политикам безопасности
  • Детальный мониторинг не требуется (например, временные тестовые машины)
  • Агенты были намеренно не установлены

Массовые действия

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

Выбор узлов

В табличном режиме:

  • Используйте чекбоксы в первой колонке таблицы
  • Чекбокс в заголовке таблицы выбирает все узлы на текущей странице

В древовидном режиме:

  • Чекбоксы поддерживают промежуточное состояние
  • Выбор папки выбирает все вложенные узлы
  • Частичный выбор отображается значком минуса

Панель массовых действий

При выборе узлов появляется плавающая панель действий:

Действие Описание
Установить агентов Запускает установку агентов на всех выбранных узлах
Обновить агентов Обновляет агенты до актуальной версии на всех выбранных узлах
Удалить агентов Удаляет агенты со всех выбранных узлов
Скрыть узлы Скрывает выбранные узлы из списка (видна когда фильтр не "Скрыты")
Показать узлы Восстанавливает видимость узлов (видна когда фильтр "Скрыты")

Панель действий:

  • Автоматически позиционируется внизу экрана (фиксируется или размещается статически)
  • Показывает количество выбранных узлов
  • Доступна кнопка "Отменить выбор" для сброса выделения
⚠️ Массовые операции

При выполнении массовых действий:

  • Для каждого узла создается отдельная задача
  • Задачи выполняются параллельно (с ограничением на количество одновременных)
  • Прогресс можно отслеживать в разделе "Задачи"
  • Неудачные установки не останавливают обработку других узлов

Диагностика агентов

При проблемах с агентами доступен инструмент пошаговой диагностики подключения.

Запуск диагностики

Для запуска диагностики:

  1. Откройте настройки узла (клик по узлу или кнопка управления)
  2. В интерфейсе настроек узла найдите раздел диагностики агента
  3. Нажмите кнопку запуска диагностики
  4. Дождитесь завершения всех шагов проверки

Шаги диагностики

Диагностика проверяет:

  • Шаг 1: Проверка, установлен ли уже агент
  • Шаг 2: Доступность узла по сети (ping)
  • Шаг 3: Доступность порта агента (по умолчанию 4151)
  • Шаг 4: Проверка SSL-сертификата агента
  • Шаг 5: Подключение к агенту по HTTPS
  • Шаг 6: Проверка версии агента
  • Шаг 7: Проверка последней активности

Результаты диагностики

Для каждого шага отображается:

  • Статус: OK (зеленый), FAIL (красный), SKIP (желтый)
  • Сообщение: краткое описание результата
  • Детали: подробный вывод команд и запросов (скрываемый блок)
  • Рекомендации: советы по устранению проблем

После завершения диагностики доступны действия:

  • Скачать отчет (JSON) — сохранить результаты диагностики в файл
  • Остановить — прервать выполнение диагностики (если требуется)
ℹ️ Автоматическое раскрытие

Шаги с ошибками (FAIL) и пропущенные (SKIP) автоматически раскрываются для просмотра деталей. Успешные шаги (OK) остаются свернутыми.

Лучшие практики

Когда устанавливать агенты

  • Всегда устанавливайте на критичные серверы — мониторинг CPU, RAM, дисков необходим для своевременного обнаружения проблем
  • Рабочие станции — при необходимости детального контроля (инвентаризация ПО, выполнение скриптов)
  • Серверы с Docker — агенты обеспечивают мониторинг контейнеров
  • Узлы для выполнения скриптов — автоматизация задач через систему задач

Когда не устанавливать агенты

  • Сетевые устройства — для них достаточно ping-мониторинга
  • Временные тестовые машины — скройте их из списка
  • Узлы с ограничениями безопасности — если политики запрещают установку ПО
  • Узлы с достаточным ping-мониторингом — если детальные метрики не требуются

Обслуживание агентов

  • Следите за обновлениями — регулярно обновляйте устаревшие агенты
  • Проверяйте агенты без ответа — узлы со статусом "Нет ответа >10 мин" требуют внимания
  • Используйте массовые действия — обновляйте группы агентов одновременно
  • Скрывайте неактуальные узлы — поддерживайте список агентов в актуальном состоянии
  • Проверяйте логи — при проблемах изучайте логи агента на узле и логи задач установки

Безопасность

  • Используйте безопасные учетные данные — не храните пароли администратора для всех узлов
  • Ограничьте доступ к серверу INFRAX — агенты подключаются к нему, защитите его
  • Следите за SSL-сертификатами — агенты используют взаимную TLS-аутентификацию
  • Регулярно обновляйте — новые версии содержат исправления безопасности

Решение проблем

Проблема Возможные причины Решение
Установка не запускается Нет учетных данных, нет сетевого доступа Проверьте настройки учетных данных и доступность узла
Агент установлен, но нет ответа Служба не запущена, блокировка брандмауэром Проверьте статус службы на узле, настройки firewall
Обновление не работает Нет доступа к узлу, агент запущен с ошибками Попробуйте переустановить агент
Устаревшая версия не обновляется Ошибка в процессе обновления Используйте диагностику, проверьте логи
Агент есть, но не собирает метрики Проблемы с правами доступа на узле Проверьте права службы агента (должна работать от SYSTEM/root)
💡 Рекомендация

Используйте автоматическую установку везде, где это возможно. Ручная установка требуется только в редких случаях строгих ограничений безопасности или отсутствия сетевого доступа к узлам.