Мониторинг виртуализации

Основные возможности

• Автоматическое обнаружение — система сама находит установленные платформы виртуализации на узлах
• Периодические проверки — регулярная проверка доступности платформ каждые 5 минут
• Отслеживание версий — сохранение информации о версии обнаруженной платформы
• Определение статуса — автоматическая пометка платформ как активных или неактивных
• Обновления в реальном времени — мгновенное обновление информации в интерфейсе через WebSocket
• Интеграция с агентами — проверки выполняются через установленных агентов без необходимости открывать API платформ

Архитектура мониторинга

1. Планировщик задач (Cron)

Система использует внутренний планировщик для запуска задач обнаружения сервисов каждые 5 минут (300 секунд).

2. Задача обнаружения сервисов

Универсальная задача автообнаружения проверяет все узлы с установленными агентами на наличие платформ виртуализации.

3. Выполнение проверок через агентов

Для каждой платформы выполняются специальные скрипты проверки:

• Docker — выполнение команды docker --version через агента
• Proxmox VE — проверка установки Proxmox через агента на Linux узлах
• Hyper-V — проверка роли Hyper-V через PowerShell на Windows узлах с агентом
• VMware vCenter/ESXi — обнаружение по открытым портам при сканировании сети

4. Обработка результатов

Система анализирует ответы от агентов и обновляет информацию о доступных сервисах на узлах.

5. Уведомление интерфейса

При обнаружении изменений система отправляет WebSocket уведомления всем подключенным пользователям для обновления интерфейса.

Параметры задачи

• Название задачи: DiscoverNetworkNodes
• Интервал выполнения: каждые 5 минут (300 секунд)
• Охват: все настроенные сети и узлы с установленными агентами
• Тип задачи: системная cron-задача
• Приоритет: фоновая задача с низким приоритетом

Алгоритм работы (двухэтапный)

Этап 1: Обнаружение и обновление узлов сети

• Параллельное сканирование всех настроенных сетей (ping + проверка портов)
• Обнаружение базовых сервисов: SSH, RDP, Web, VMware vCenter/ESXi
• Определение операционной системы по эвристике
• Сохранение новых узлов в таблицу обнаружения
• Автоматическое обновление существующих узлов:
  • Добавление недостающих сервисов
  • Обновление ОС (если не была определена)

Этап 2: Обнаружение платформ виртуализации через агента

• Получение списка всех узлов сети с установленными агентами
• Асинхронная проверка всех поддерживаемых платформ:
  • Docker — на узлах с SSH или RDP
  • Proxmox VE — на узлах с SSH (Linux)
  • Hyper-V — на узлах с RDP (Windows)
• Обработка результатов:
  • Если платформа обнаружена — добавляется в список сервисов или помечается как активная
  • Если платформа не обнаружена — увеличивается счетчик неудачных проверок
  • Сохраняется информация о версии обнаруженной платформы
  • Записывается временная метка последней проверки
• Уведомление интерфейса при обнаружении изменений

Docker

Требования:

• Установленный агент

Метод обнаружения:

• Выполнение команды docker --version
• Проверка ответа на наличие строки "DOCKER_INSTALLED:"
• Извлечение версии Docker из ответа

Proxmox VE

Требования:

• Linux узел
• Установленный агент
• Установленный Proxmox VE на узле

Метод обнаружения:

• Выполнение скрипта проверки Proxmox через агент
• Проверка ответа на наличие строки "PROXMOX_INSTALLED:"
• Извлечение версии Proxmox из ответа

Microsoft Hyper-V

Требования:

• Windows Server узел
• Установленный агент
• Установленная роль Hyper-V

Метод обнаружения:

• Выполнение PowerShell скрипта проверки Hyper-V
• Проверка ответа на наличие строки "HYPERV_INSTALLED:"
• Извлечение версии Hyper-V из ответа

VMware vCenter / ESXi

Требования:

• Доступность узла по сети
• Открытые порты VMware

Метод обнаружения:

• Обнаружение по портам при сканировании сети (порты 443, 902, 903)
• Автоматическое определение типа (vCenter или ESXi)

Состояния платформы

Активная платформа

• Платформа успешно обнаружена при последней проверке
• Доступна для управления через интерфейс INFRAX
• Отображается в списке доступных сервисов узла
• Показывается в дереве узлов как отдельный виртуальный узел

Неактивная платформа

• Платформа не обнаружена при последних 3 проверках подряд
• Автоматически помечается системой как неактивная
• Сохраняется в списке сервисов, но помечается как недоступная
• Может быть вызвана временными проблемами с сетью, остановкой службы или удалением платформы

Механизм счетчика неудачных проверок

Система использует счетчик неудачных проверок для определения статуса платформы:

• 0 неудачных проверок — платформа активна и работает нормально
• 1-2 неудачных проверки — могут быть временные проблемы, платформа еще считается активной
• 3+ неудачных проверки — платформа помечается как неактивная

Счетчик сбрасывается на 0 при успешной проверке платформы.

Хранение метаданных

Для каждой обнаруженной платформы система сохраняет метаданные:

• Версия платформы — точная версия обнаруженной платформы
• Временная метка последней проверки — время последней успешной или неудачной проверки
• Счетчик неудачных проверок — количество последовательных неудачных проверок

В дереве узлов

Платформы виртуализации отображаются как виртуальные узлы в дереве:

• Docker — отображается с иконкой Docker
• Proxmox VE — отображается с логотипом Proxmox
• Hyper-V — отображается с иконкой Windows и меткой Hyper-V
• VMware — отображается с соответствующей иконкой VMware

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

В заголовке узла

При выборе виртуального узла платформы в правой панели отображается:

• Название платформы — например, "Docker", "Proxmox VE", "Hyper-V"
• Версия платформы — если доступна
• Количество виртуальных машин или контейнеров — общее количество и количество запущенных

Сообщения о статусе

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

• "Проверка наличия..." — идет проверка доступности платформы
• "... не установлен" — платформа не обнаружена на узле
• "Нет виртуальных машин" — платформа установлена, но VM/контейнеров нет
• Список VM/контейнеров — платформа активна и доступна

WebSocket уведомления

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

• Обнаружена новая платформа — при первом обнаружении платформы на узле
• Платформа стала неактивной — после 3 неудачных проверок
• Платформа восстановлена — при успешной проверке после периода недоступности

Уведомления обновляют интерфейс в реальном времени без необходимости обновления страницы.

Платформа не обнаруживается

Проблема: Установленная платформа виртуализации не отображается в интерфейсе INFRAX.

Возможные причины и решения:

• Агент не установлен — установите агента на узел
• Агент не работает — проверьте статус агента и перезапустите его при необходимости
• Неправильный тип агента — для Proxmox нужен агент, для Hyper-V — агент
• Платформа установлена недавно — подождите до 5 минут для следующей автоматической проверки
• Проблемы с правами доступа — убедитесь, что учетные данные агента имеют права на выполнение команд проверки

Платформа помечена как неактивная

Проблема: Ранее обнаруженная платформа больше не отображается или помечена как недоступная.

Возможные причины и решения:

• Служба платформы остановлена — запустите соответствующую службу на узле
• Временные проблемы с сетью — проверьте сетевое подключение к узлу
• Агент остановлен или не отвечает — перезапустите агента на узле
• Платформа была удалена — если платформа действительно удалена, это нормальное поведение
• Изменились учетные данные — обновите учетные данные агента в настройках узла

Долгая проверка платформы

Проблема: При открытии управления платформой долго отображается сообщение "Проверка наличия...".

Возможные причины и решения:

• Медленное соединение с узлом — проверьте качество сетевого соединения
• Высокая нагрузка на узел — агент может медленно отвечать из-за загрузки системы
• Таймаут подключения — увеличьте таймаут в настройках или проверьте брандмауэр

Версия платформы не отображается

Проблема: Платформа обнаружена, но версия показывается как "Неизвестная версия".

Возможные причины и решения:

• Нестандартная установка — платформа установлена нестандартным способом
• Проблема парсинга версии — формат вывода версии отличается от ожидаемого
• Недостаточно прав — агент не имеет прав на выполнение команды получения версии

Это не влияет на работу управления платформой, только на отображение информации.

Обеспечение надежного мониторинга

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

Мониторинг критичных платформ

• Обращайте внимание на изменения — если платформа стала неактивной, проверьте причину
• Не полагайтесь только на автоматику — периодически проверяйте статус важных платформ вручную
• Документируйте инфраструктуру — ведите учет всех платформ виртуализации в организации
• Планируйте обновления — учитывайте, что обновление платформы может временно сделать её недоступной

Оптимизация работы

• Не останавливайте задачу DiscoverNetworkNodes — это может нарушить автоматическое обнаружение узлов и сервисов
• Интервал 5 минут оптимален — не рекомендуется изменять интервал проверки без необходимости
• Используйте виртуальные узлы — они предоставляют удобный доступ к управлению платформами прямо из дерева узлов