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

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

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

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

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

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

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

Платформа	Архитектуры	Версии
Windows	x64, ARM64, legacy	Windows 7 / Server 2008 R2 и выше, legacy-сборка доступна для ручной установки
Linux	amd64, 386, arm64, arm	Современные дистрибутивы Linux

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

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

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

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

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

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

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

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

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

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

Инциденты и проблемы агентов

При включённом создании тикетов Infrax различает две ситуации. Новый узел без единого ответа сначала получает время на установку. После его окончания создаётся низкоприоритетный инцидент «Агент не установлен». Если агент раньше отвечал, но перестал, создаётся отдельный инцидент «Агент перестал отвечать». Отсутствующая дата ответа не считается старым ответом.

• первый ответ агента позволяет автоматически закрыть инцидент отсутствия установки;
• отключение контроля или отметка, что агент не требуется, также закрывают такой инцидент;
• если одна проверка обнаружит достаточно инцидентов «Агент не установлен», система автоматически создаст обычную проблему в состоянии «Новая»;
• почти одновременная потеря связи с ранее работавшими агентами одной сети образует самостоятельную проблему; при совпадении сети и времени система может связать её с проблемой недоступности узлов через общую вышестоящую проблему, не перенося инциденты.

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

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

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

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

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

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

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

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

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

• Сохраняет структуру проекта узлов
• Показывает статус агента компактными бейджами
• Поддерживает выбор целых папок (чекбоксы с промежуточным состоянием)
• Отображает IP-адреса рядом с названиями узлов
• Действия строки собраны под одной кнопкой ⋮ («Действия над машиной»): она проявляется при наведении на строку и при переходе на неё с клавиатуры и открывает то же меню, что и в таблице, плюс пункт «Открыть карточку»
• У папки показаны счётчики: сколько внутри машин с агентом и сколько требуют внимания

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

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

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

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

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

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

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

• Windows: подключение выполняется по административным учетным данным, затем агент копируется на узел, создается и запускается служба InfraxAgent
• Linux: подключение выполняется по SSH, затем копируется бинарный файл, устанавливается служба InfraxAgent и запускается агент

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

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

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

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

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

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

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

В колонке "Версия агента" отображается установленная сборка. Если доступна новая версия, в дереве и таблице появляется индикатор обновления.

• Текущая версия — установленная версия агента
• Доступная версия — новая версия, которая доступна для обновления

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

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

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

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

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

Агенты на узлах площадки

Узлы площадки обслуживает её шлюз: сервер INFRAX не обращается к таким узлам напрямую. Кнопки и пункты меню при этом те же, что и для обычных узлов — Установить агента, Обновить агента, Удалить агента. Если среди выбранных узлов есть узлы площадок, они не ставятся в очередь фоновых задач, а обслуживаются отдельным окном.

Окно работы через площадку

Заголовок окна зависит от операции: Установка агента через площадку, Обновление агента через площадку или Удаление агента через площадку. Под заголовком выводится строка «Узлов на площадках: {count}. Работу выполняет шлюз площадки, этапы приходят по мере выполнения.» — у обновления вторая половина строки другая: «Файл агента шлюз берёт у себя на площадке, этапы приходят по мере выполнения.». Каждый узел показан строкой вида «{title} — площадка {site}».

• Этапы приходят по мере выполнения — обновлять окно вручную не нужно
• Узлы обрабатываются по одному, а не одновременно
• Результат записывается в карточку узла так же, как при обычной установке
• Когда работа закончена, окно закрывается кнопкой Закрыть

Полный перечень этапов, их статусов и итоговых сообщений приведён в разделе Работа с узлами площадки.

Учётные данные узла

Операция	Нужны ли учётные данные	Комментарий
Установка агента	Да	Их можно ввести вручную или подобрать автоматически. Без них операция отклоняется: «Для установки агента нужны учётные данные узла.»
Обновление агента	Нет	Файл агента шлюз берёт у себя на площадке, учётные данные узла для обновления не запрашиваются
Удаление агента	Да	Без них операция отклоняется: «Для удаления агента нужны учётные данные узла.»

Узлы основной площадки в это окно не попадают: их агент устанавливается, обновляется и удаляется обычной задачей.

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

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

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

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

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

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

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

Скрытие узла

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

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

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

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

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

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

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

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

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

Выбор узлов

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

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

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

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

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

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

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

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

• Стоит полосой под органами управления, над списком, и появляется, только когда что-то отмечено
• Показывает количество выбранных узлов
• Доступна кнопка "Отменить выбор" для сброса выделения

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

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

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

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

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

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

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

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

Порты агента

Агент INFRAX использует следующие порты:

Порт	Назначение	Описание
4151 (по умолчанию)	API агента	Основной порт для связи с сервером INFRAX (метрики, команды, скрипты). Может быть изменён
4152	Console	Порт для подключения через Console (только Windows). Используется для удаленного доступа к экрану компьютера

Изменение порта агента

По умолчанию агент работает на порту 4151. Если этот порт занят или его необходимо изменить по другим причинам, порт можно настроить.

Изменение порта на стороне агента — выполняется одним из способов:

• Через интерактивное меню агента — при запуске агента в консольном режиме выберите пункт «9. Изменить порт агента». Введите новый порт и перезапустите агента
• Через файл конфигурации — отредактируйте файл infrax_config.json (Linux: /opt/infrax-agent/data/, Windows: C:\ProgramData\InfraxAgent\data\), добавив поле "port": 5151. После изменения перезапустите агента

Указание порта на стороне INFRAX — чтобы сервер INFRAX знал, на каком порту работает агент конкретного узла:

1. Откройте настройки узла в разделе управления сетевыми узлами
2. Найдите поле «Порт агента» (расположено под полем IP-адреса)
3. Нажмите на иконку замка, чтобы разблокировать поле
4. Введите порт, на котором работает агент на этом узле
5. Сохраните настройки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проблема	Возможные причины	Решение
Установка не запускается	Нет учетных данных, нет сетевого доступа	Проверьте учетные данные администратора и доступность узла
Агент установлен, но нет ответа	Служба не запущена, блокировка брандмауэром	Проверьте статус службы на узле и откройте порт агента (по умолчанию 4151)
Обновление не работает	Нет доступа к узлу, агент запущен с ошибками	Проверьте доступность узла и попробуйте переустановить агент
Устаревшая версия не обновляется	Ошибка в процессе обновления	Используйте диагностику и проверьте логи задачи
Агент есть, но не собирает метрики	Проблемы с правами доступа на узле	Проверьте права службы агента (она должна работать от SYSTEM или root)
Вручную установленный агент не получает сертификат	У узла не выбрана ОС Windows или Linux	Откройте настройки узла и установите ОС — Windows или Linux
Агент не ставится на Windows-узел площадки	Через шлюз площадки обслуживаются только Linux-узлы	Используйте ручную установку на самом узле; подробности — в разделе Работа с узлами площадки
Часть выбранных узлов пропущена	Шлюз их площадки не на связи	Проверьте состояние площадки в разделе Узлы сети и повторите операцию, когда площадка вернётся на связь