Мониторинг Microsoft Hyper-V: различия между версиями

Материал из Документация Ключ-АСТРОМ
Нет описания правки
 
(не показано 7 промежуточных версий 1 участника)
Строка 1: Строка 1:
== Инфраструктура Microsoft Hyper-V ==
Расширение предназначено для локального мониторинга кластеров, узлов и виртуальных машин Microsoft Hyper-V.
Контролируйте работоспособность и производительность кластеров, хостов и виртуальных машин Hyper-V.


=== Обзор ===
== Назначение ==
Это расширение контролирует производительность структуры Hyper-V, отслеживая работоспособность, производительность и использование ресурсов виртуальных машин Hyper-V вместе с контекстом их хостовых и кластерных ресурсов. Расширение Hyper-V использует командлеты PowerShell и WMI для сбора данных из гипервизора Windows, следуя передовым практикам, применяемым Microsoft.


'''Это предназначено для пользователей, которые:'''
Расширение собирает показатели Microsoft Hyper-V с помощью WMI и PowerShell непосредственно на узлах гипервизора.


хотят получить полный мониторинг своих кластеров Hyper-V, обнаруживать проблемы до того, как они окажутся серьезными, и определять первопричину на уровне виртуализации и приложений, включая:
С помощью расширения можно:


* Узкие места процессора
* контролировать состояние кластеров Hyper-V;
* Узкие места памяти
* анализировать загрузку процессора и памяти узлов;
* Узкие места сети
* отслеживать количество и состояние виртуальных машин;
* Узкие места в хранении
* контролировать использование процессора и памяти виртуальными машинами;
* Зависимые приложения, размещенные в кластере Hyper-V
* анализировать физические и виртуальные накопители;
* отслеживать Cluster Shared Volumes;
* контролировать физические и виртуальные сетевые интерфейсы;
* выявлять нехватку вычислительных ресурсов и хранилища;
* связывать обнаруженные виртуальные машины с гостевыми ОС, контролируемыми ЕдинымАгентом;
* использовать готовую панель мониторинга и шаблоны оповещений.


=== Варианты использования ===
== Архитектура мониторинга ==
'''Это расширение позволяет вам:'''


* Контролировать работоспособность и производительность кластера Hyper-V, используя встроенные экраны анализа и удобные в навигации панели мониторинга.
Расширение работает локально на каждом узле Hyper-V.
* Убедиться, что ресурсы оптимально распределены между виртуальными машинами.
* Связать производительность приложений и виртуальных машин, отслеживаемых с помощью ЕдиногоАгента, с базовыми ресурсами Hyper-V, выделенными для виртуальных машин.


=== Начало ===
Удалённый запуск через АктивныйШлюз не поддерживается.
Это расширение выполняется ЕдинымАгентом (локальный мониторинг). Для начала активируйте расширение в своей среде с помощью внутрипродуктового концентратора на каждом хосте, включающем кластер Hyper-V. Это означает, что на всех хост-машинах кластера ЕдиногоАгента должен быть уже установлен.


В настройках конфигурации предоставьте учетной записи пользователя Windows как минимум следующие разрешения:
Для полноценного мониторинга кластера необходимо:


* Группа администраторов Hyper-V
* установить ЕдиныйАгент на каждый узел Hyper-V;
* Доступ на чтение к кластеру, проверьте с помощью Get-ClusterAccess
* установить расширение в Ключ-АСТРОМ;
* Доступ для чтения и записи к каталогу Windows TEMP
* разрешить запуск расширения от имени <code>LOCAL SYSTEM</code>;
* включить конфигурацию расширения на каждом узле кластера.


=== Подробности ===
Расширение выполняет:


==== Собранные показатели: ====
* WMI-запросы к локальному хранилищу показателей Windows;
* PowerShell-команды для получения конфигурации Hyper-V, сведений о кластере и дополнительных метрик;
* построение связей между кластерами, узлами, виртуальными машинами, дисками и сетевыми интерфейсами.


* Здоровье виртуальных машин
== Поддерживаемые системы ==
* Использование памяти
* Загрузка ЦП
* Операции хранилища
* Сетевой трафик


=== Это расширение создано на основе Extension Framework 2.0 и обеспечивает: ===
Для работы расширения необходима 64-разрядная операционная система с включённой аппаратной виртуализацией:


* Конфигурацию, необходимую для управления выполнением командлетов PowerShell Hyper-V и сбора метрик из них
* Windows 10 Enterprise, Pro или Education;
* Панель инструментов
* Windows Server 2016 и более новые версии.
* Определения топологии
* Унифицированные экраны анализа


=== Информация о совместимости ===
Версия конфигурации виртуальных машин Hyper-V должна быть <code>9.0</code> или выше.
Для этого расширения требуется:


* ОС x64 с виртуализацией, активируемой BIOS:
Минимальная версия Ключ-АСТРОМ — <code>1.318.0</code>.
** Windows 10 Корпоративная/Профессиональная/Образовательная
** Windows Server 2016 или новее


Примечание о топологических связях между обнаруженными виртуальными машинами Hyper-V и экземплярами виртуальных машин, отслеживаемыми ЕдинымАгентом:
Расширение выполняется только на Windows.


* Начиная с версии 2.0.13, это расширение поддерживает связь SAME_AS между обнаруженными виртуальными машинами и контролируемыми ЕдинымАгентом экземплярами гостевой ОС, используя IP-адрес в качестве свойства соединения.
== Требования ==
* Эти отношения позволяют:
 
** Аналитику ИИ для совместного анализа показателей, полученных с помощью этого расширения и ЕдиногоАгента, для полной характеристики производительности контролируемых экземпляров гостевой ОС
Перед установкой убедитесь, что:
** Приложение Discovery and Coverage, предлагающее, какие обнаруженные виртуальные машины следует оснастить ЕдинымАгентом для полного контроля производительности
 
* Эта связь работает для известных гостевых ОС Windows, но имеет ограничения, когда гостевая ОС — это Linux. Это ограничение связано с тем, что на Hyper-V гостевая ОС Linux должна быть оснащена службой интеграции Linux от Microsoft , в то время как эта служба поддерживает ограниченный спектр дистрибутивов Linux.
* на каждом узле кластера установлен и работает ЕдиныйАгент;
* роль Hyper-V установлена и активна;
* аппаратная виртуализация включена в BIOS или UEFI;
* доступны локальные WMI-классы Hyper-V;
* PowerShell может выполнять команды управления Hyper-V;
* для кластерной конфигурации установлен компонент Failover Clustering;
* служба ЕдиныйАгент имеет доступ к WMI, системному реестру и PowerShell;
* расширению разрешён запуск от имени <code>LOCAL SYSTEM</code>.
 
== Настройка повышенных привилегий ==
 
Обычно Python-расширения выполняются от имени <code>LOCAL SERVICE</code>. Этой учётной записи недостаточно для выполнения части PowerShell-команд и чтения некоторых WMI-объектов Hyper-V.
 
Расширение должно выполняться от имени <code>LOCAL SYSTEM</code>.
 
На каждом узле Hyper-V откройте файл <code>extensionsuser.conf</code> в каталоге конфигурации ЕдиногоАгента и добавьте:
 
<pre>
elevated_privileges_extensions=[ru.ruscomtech.extension.hyperv:*]
</pre>
 
Если в параметре уже перечислены другие расширения, добавьте IBM Hyper-V через запятую, не удаляя существующие значения.
 
После изменения конфигурации перезапустите службу ЕдиногоАгента.
 
Проверьте этот параметр на каждом узле кластера, где должно выполняться расширение.
 
== Установка расширения ==
 
# Откройте раздел управления расширениями в Ключ-АСТРОМ.
# Загрузите подписанный архив расширения.
# Убедитесь, что установлена версия <code>4.1.5</code>.
# Настройте запуск с повышенными привилегиями на узлах Hyper-V.
# Создайте конфигурацию мониторинга.
# Назначьте конфигурацию на все необходимые узлы Hyper-V.
# Выберите наборы функций.
# Сохраните и активируйте конфигурацию.
 
== Настройка конфигурации ==
 
=== Частота сбора ===
 
Параметр <code>Frequency</code> определяет интервал сбора данных в минутах.
 
По умолчанию данные собираются каждую минуту.
 
Для крупных кластеров интервал можно увеличить, если сбор не успевает завершиться до начала следующего цикла.
 
=== Уровень журналирования ===
 
Доступны уровни:
 
* <code>INFO</code> — обычная работа;
* <code>DEBUG</code> — подробная диагностика.
 
Используйте <code>DEBUG</code> только при устранении неполадок.
 
=== Режим фильтрации ===
 
Параметр <code>Filter Mode</code> определяет действие регулярных выражений:
 
{| class="wikitable"
! Режим
! Описание
|-
| <code>ALLOW</code>
| Собираются только сущности, соответствующие регулярному выражению.
|-
| <code>DENY</code>
| Сущности, соответствующие регулярному выражению, исключаются из мониторинга.
|}
 
Значение по умолчанию — <code>ALLOW</code>.
 
Выражение <code>.*</code> в режиме <code>ALLOW</code> включает все сущности соответствующего типа.
 
=== Фильтры сущностей ===
 
Можно настроить отдельные регулярные выражения для:
 
{| class="wikitable"
! Параметр
! Что фильтруется
|-
| <code>Cluster Filter</code>
| Кластеры Hyper-V.
|-
| <code>Host Filter</code>
| Узлы Hyper-V.
|-
| <code>VM Filter</code>
| Виртуальные машины.
|-
| <code>Network Interface Card Filter</code>
| Физические сетевые интерфейсы узлов.
|-
| <code>Storage Device Filter</code>
| Физические накопители узлов.
|-
| <code>Virtual Network Interface Card Filter</code>
| Виртуальные сетевые интерфейсы.
|-
| <code>Virtual Storage Device Filter</code>
| Виртуальные накопители.
|}
 
Например:
 
<pre>
^.*-test$
</pre>
 
В режиме <code>ALLOW</code> выражение включает только сущности, имена которых заканчиваются на <code>-test</code>. В режиме <code>DENY</code> такие сущности исключаются.
 
Ошибочное регулярное выражение может привести к отсутствию данных.
 
== Наборы функций ==
 
Для работы конфигурации необходимо выбрать хотя бы один набор функций.
 
{| class="wikitable"
! Набор функций
! Метрик
! Назначение
|-
| <code>cluster-shared-volume</code>
| 5
| Размер, свободное и используемое пространство, скорость чтения и записи Cluster Shared Volumes.
|-
| <code>host-virtual-machine</code>
| 3
| Количество виртуальных машин, количество работающих машин и время работы узла.
|-
| <code>host-cpu</code>
| 4
| Загрузка процессора, резерв процессора, количество физических и логических ядер.
|-
| <code>host-memory</code>
| 4
| Общая, используемая и доступная память узла, процент использования.
|-
| <code>basic-network-interface-card</code>
| 3
| Переданные, полученные и суммарные пакеты физических сетевых интерфейсов.
|-
| <code>advanced-network-interface-card</code>
| 3
| Переданный, полученный и суммарный трафик физических сетевых интерфейсов.
|-
| <code>basic-storage-device</code>
| 4
| Использование, общий размер, занятое и свободное пространство физических накопителей.
|-
| <code>advanced-storage-device</code>
| 3
| Скорость чтения, скорость записи и IOPS физических накопителей.
|-
| <code>virtual-machine</code>
| 9
| Процессор, память и давление на память виртуальных машин.
|-
| <code>basic-virtual-network-interface-card</code>
| 3
| Переданные, полученные и суммарные пакеты виртуальных сетевых интерфейсов.
|-
| <code>advanced-virtual-network-interface-card</code>
| 3
| Переданный, полученный и суммарный трафик виртуальных сетевых интерфейсов.
|-
| <code>basic-virtual-storage-device</code>
| 4
| Использование и объём виртуальных накопителей.
|-
| <code>advanced-virtual-storage-device</code>
| 3
| Скорость чтения, скорость записи и IOPS виртуальных накопителей.
|}
 
Для базового мониторинга рекомендуется включить:
 
* <code>host-virtual-machine</code>;
* <code>host-cpu</code>;
* <code>host-memory</code>;
* <code>virtual-machine</code>;
* <code>basic-storage-device</code>;
* <code>basic-virtual-storage-device</code>;
* <code>cluster-shared-volume</code> — для кластерной конфигурации.
 
Расширенные наборы сетевых и дисковых показателей включайте при необходимости.
 
== Собираемые данные ==
 
=== Кластеры и Cluster Shared Volumes ===
 
Расширение собирает:
 
* общий размер тома;
* используемое пространство;
* доступное пространство;
* скорость чтения;
* скорость записи.
 
=== Узлы Hyper-V ===
 
Для каждого узла собираются:
 
* количество виртуальных машин;
* количество работающих виртуальных машин;
* время работы;
* загрузка процессора;
* резерв процессора;
* количество физических процессоров;
* количество логических процессоров;
* общий объём памяти;
* используемая память;
* доступная память;
* процент использования памяти.
 
=== Виртуальные машины ===
 
Для виртуальных машин собираются:
 
* количество виртуальных процессоров;
* резерв процессора;
* использование процессора относительно ресурсов узла;
* фактическое использование процессора внутри виртуальной машины;
* общий объём памяти;
* используемая память;
* доступная память;
* процент использования памяти;
* давление на память.
 
Показатель фактической загрузки процессора отражает загрузку, видимую внутри виртуальной машины. Обычный показатель загрузки отражает использование относительно полной вычислительной мощности узла.
 
=== Накопители ===
 
Для физических и виртуальных накопителей собираются:
 
* общий размер;
* используемое пространство;
* свободное пространство;
* процент использования;
* скорость чтения;
* скорость записи;
* количество операций ввода-вывода в секунду.
 
=== Сетевые интерфейсы ===
 
Для физических и виртуальных сетевых интерфейсов собираются:
 
* отправленные пакеты;
* полученные пакеты;
* общий поток пакетов;
* отправленные байты;
* полученные байты;
* общий сетевой трафик.
 
== Топология ==
 
Расширение создаёт сущности:
 
* кластер Hyper-V;
* узел Hyper-V;
* виртуальная машина;
* физический накопитель;
* виртуальный накопитель;
* физический сетевой интерфейс;
* виртуальный сетевой интерфейс.
 
Создаются следующие связи:
 
* узел входит в кластер;
* виртуальная машина работает на узле;
* физический накопитель относится к узлу;
* физический сетевой интерфейс относится к узлу;
* виртуальный накопитель относится к виртуальной машине;
* виртуальный сетевой интерфейс относится к виртуальной машине.
 
Если гостевая ОС также контролируется ЕдинымАгентом, расширение пытается связать обнаруженную виртуальную машину с соответствующим экземпляром гостевой ОС по IP-адресу.
 
Для гостевых Windows связь обычно определяется автоматически. Для Linux результат зависит от поддержки Microsoft Linux Integration Services и доступности IP-адресов гостевой системы.
 
== Панели мониторинга ==
 
В пакет входят:
 
* классическая панель <code>Hyper-V Overview</code>;
* панель нового формата <code>Microsoft Hyper-V Infrastructure Overview</code>;
* аналитические представления кластеров, узлов, виртуальных машин, дисков и сетевых интерфейсов.
 
Панели позволяют анализировать:
 
* распределение ресурсов между виртуальными машинами;
* загрузку процессоров и памяти;
* заполнение физических и виртуальных дисков;
* состояние Cluster Shared Volumes;
* сетевую нагрузку;
* взаимосвязи между кластером, узлами и виртуальными машинами.
 
== Оповещения ==
 
Расширение содержит десять шаблонов оповещений.
 
{| class="wikitable"
! Оповещение
! Условие по умолчанию
|-
| Высокая загрузка процессора кластера
| Выше 85%.
|-
| Высокое использование файловой системы кластера
| Выше 80%.
|-
| Высокое использование памяти кластера
| Выше 85%.
|-
| Мало свободного места на Cluster Shared Volume
| Ниже 15%.
|-
| Высокая загрузка процессора узла
| Выше 85%.
|-
| Высокое использование памяти узла
| Выше 85%.
|-
| Высокая загрузка физического накопителя
| Выше 85%.
|-
| Высокая загрузка виртуального накопителя
| Выше 85%.
|-
| Высокая загрузка процессора виртуальной машины
| Выше 85%.
|-
| Высокое использование памяти виртуальной машины
| Выше 85%.
|}
 
Порог проверяется в окне из пяти измерений. По умолчанию достаточно одного нарушающего измерения для создания события.
 
Перед включением шаблонов адаптируйте пороговые значения к обычной нагрузке среды.
 
== Проверка работы ==
 
После активации конфигурации:
 
# Проверьте состояние расширения на каждом узле Hyper-V.
# Убедитесь, что расширение запущено от имени <code>LOCAL SYSTEM</code>.
# Проверьте появление сущностей Hyper-V Host.
# Для кластерной среды проверьте появление Hyper-V Cluster.
# Убедитесь, что на каждом узле отображаются работающие виртуальные машины.
# Проверьте метрики процессора и памяти.
# Проверьте физические и виртуальные накопители.
# Откройте панель <code>Microsoft Hyper-V Infrastructure Overview</code>.
# Проверьте связи между кластером, узлами и виртуальными машинами.
 
== Устранение неполадок ==
 
=== Расширение не запускается ===
 
Проверьте:
 
* установлен ли ЕдиныйАгент на узле;
* добавлено ли расширение в <code>elevated_privileges_extensions</code>;
* перезапущена ли служба ЕдиногоАгента после изменения конфигурации;
* соответствует ли имя расширения <code>ru.ruscomtech.extension.hyperv</code>;
* доступен ли PowerShell;
* включена ли роль Hyper-V;
* отсутствуют ли ошибки в журнале расширения.
 
=== Узел отображается, но виртуальные машины отсутствуют ===
 
Проверьте:
 
* набор функций <code>virtual-machine</code>;
* фильтр виртуальных машин;
* режим <code>ALLOW</code> или <code>DENY</code>;
* права на выполнение команд Hyper-V PowerShell;
* доступ к WMI-классам Hyper-V;
* наличие работающих виртуальных машин на этом узле.
 
Расширение должно быть включено на каждом узле кластера. Один узел не собирает все локальные показатели виртуальных машин с остальных узлов.
 
=== Не определяется кластер ===
 
Проверьте:
 
* установлен ли компонент Failover Clustering;
* доступна ли команда получения сведений о кластере в PowerShell;
* фильтр кластера;
* выполнение расширения от имени <code>LOCAL SYSTEM</code>.
 
Узлы, не входящие в кластер, могут контролироваться отдельно.
 
=== После миграции виртуальная машина видна на двух узлах ===
 
Версия <code>4.1.5</code> содержит исправления очистки устаревших данных о размещении виртуальных машин.
 
Проверьте:
 
* что на всех узлах используется одинаковая версия расширения;
* что конфигурация активна на всех узлах;
* что сбор данных завершается без ошибок;
* что фильтры виртуальных машин одинаковы на всех узлах.
 
=== Не создаётся связь с гостевой ОС ===
 
Связь определяется по IP-адресу.
 
Проверьте:
 
* установлен ли ЕдиныйАгент внутри гостевой ОС;
* передаёт ли Hyper-V IP-адрес виртуальной машины;
* совпадает ли IP-адрес с адресом гостевой ОС;
* установлен ли Microsoft Linux Integration Services для Linux-гостя.
 
== История изменений ==
 
{| class="wikitable"
! Версия
! Изменения
|-
| 4.1.5
| Перепакованы Python-библиотеки для будущей совместимости с Python 3.14.
|-
|}

Текущая версия от 02:36, 2 октября 2026

Расширение предназначено для локального мониторинга кластеров, узлов и виртуальных машин Microsoft Hyper-V.

Назначение

Расширение собирает показатели Microsoft Hyper-V с помощью WMI и PowerShell непосредственно на узлах гипервизора.

С помощью расширения можно:

  • контролировать состояние кластеров Hyper-V;
  • анализировать загрузку процессора и памяти узлов;
  • отслеживать количество и состояние виртуальных машин;
  • контролировать использование процессора и памяти виртуальными машинами;
  • анализировать физические и виртуальные накопители;
  • отслеживать Cluster Shared Volumes;
  • контролировать физические и виртуальные сетевые интерфейсы;
  • выявлять нехватку вычислительных ресурсов и хранилища;
  • связывать обнаруженные виртуальные машины с гостевыми ОС, контролируемыми ЕдинымАгентом;
  • использовать готовую панель мониторинга и шаблоны оповещений.

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

Расширение работает локально на каждом узле Hyper-V.

Удалённый запуск через АктивныйШлюз не поддерживается.

Для полноценного мониторинга кластера необходимо:

  • установить ЕдиныйАгент на каждый узел Hyper-V;
  • установить расширение в Ключ-АСТРОМ;
  • разрешить запуск расширения от имени LOCAL SYSTEM;
  • включить конфигурацию расширения на каждом узле кластера.

Расширение выполняет:

  • WMI-запросы к локальному хранилищу показателей Windows;
  • PowerShell-команды для получения конфигурации Hyper-V, сведений о кластере и дополнительных метрик;
  • построение связей между кластерами, узлами, виртуальными машинами, дисками и сетевыми интерфейсами.

Поддерживаемые системы

Для работы расширения необходима 64-разрядная операционная система с включённой аппаратной виртуализацией:

  • Windows 10 Enterprise, Pro или Education;
  • Windows Server 2016 и более новые версии.

Версия конфигурации виртуальных машин Hyper-V должна быть 9.0 или выше.

Минимальная версия Ключ-АСТРОМ — 1.318.0.

Расширение выполняется только на Windows.

Требования

Перед установкой убедитесь, что:

  • на каждом узле кластера установлен и работает ЕдиныйАгент;
  • роль Hyper-V установлена и активна;
  • аппаратная виртуализация включена в BIOS или UEFI;
  • доступны локальные WMI-классы Hyper-V;
  • PowerShell может выполнять команды управления Hyper-V;
  • для кластерной конфигурации установлен компонент Failover Clustering;
  • служба ЕдиныйАгент имеет доступ к WMI, системному реестру и PowerShell;
  • расширению разрешён запуск от имени LOCAL SYSTEM.

Настройка повышенных привилегий

Обычно Python-расширения выполняются от имени LOCAL SERVICE. Этой учётной записи недостаточно для выполнения части PowerShell-команд и чтения некоторых WMI-объектов Hyper-V.

Расширение должно выполняться от имени LOCAL SYSTEM.

На каждом узле Hyper-V откройте файл extensionsuser.conf в каталоге конфигурации ЕдиногоАгента и добавьте:

elevated_privileges_extensions=[ru.ruscomtech.extension.hyperv:*]

Если в параметре уже перечислены другие расширения, добавьте IBM Hyper-V через запятую, не удаляя существующие значения.

После изменения конфигурации перезапустите службу ЕдиногоАгента.

Проверьте этот параметр на каждом узле кластера, где должно выполняться расширение.

Установка расширения

  1. Откройте раздел управления расширениями в Ключ-АСТРОМ.
  2. Загрузите подписанный архив расширения.
  3. Убедитесь, что установлена версия 4.1.5.
  4. Настройте запуск с повышенными привилегиями на узлах Hyper-V.
  5. Создайте конфигурацию мониторинга.
  6. Назначьте конфигурацию на все необходимые узлы Hyper-V.
  7. Выберите наборы функций.
  8. Сохраните и активируйте конфигурацию.

Настройка конфигурации

Частота сбора

Параметр Frequency определяет интервал сбора данных в минутах.

По умолчанию данные собираются каждую минуту.

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

Уровень журналирования

Доступны уровни:

  • INFO — обычная работа;
  • DEBUG — подробная диагностика.

Используйте DEBUG только при устранении неполадок.

Режим фильтрации

Параметр Filter Mode определяет действие регулярных выражений:

Режим Описание
ALLOW Собираются только сущности, соответствующие регулярному выражению.
DENY Сущности, соответствующие регулярному выражению, исключаются из мониторинга.

Значение по умолчанию — ALLOW.

Выражение .* в режиме ALLOW включает все сущности соответствующего типа.

Фильтры сущностей

Можно настроить отдельные регулярные выражения для:

Параметр Что фильтруется
Cluster Filter Кластеры Hyper-V.
Host Filter Узлы Hyper-V.
VM Filter Виртуальные машины.
Network Interface Card Filter Физические сетевые интерфейсы узлов.
Storage Device Filter Физические накопители узлов.
Virtual Network Interface Card Filter Виртуальные сетевые интерфейсы.
Virtual Storage Device Filter Виртуальные накопители.

Например:

^.*-test$

В режиме ALLOW выражение включает только сущности, имена которых заканчиваются на -test. В режиме DENY такие сущности исключаются.

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

Наборы функций

Для работы конфигурации необходимо выбрать хотя бы один набор функций.

Набор функций Метрик Назначение
cluster-shared-volume 5 Размер, свободное и используемое пространство, скорость чтения и записи Cluster Shared Volumes.
host-virtual-machine 3 Количество виртуальных машин, количество работающих машин и время работы узла.
host-cpu 4 Загрузка процессора, резерв процессора, количество физических и логических ядер.
host-memory 4 Общая, используемая и доступная память узла, процент использования.
basic-network-interface-card 3 Переданные, полученные и суммарные пакеты физических сетевых интерфейсов.
advanced-network-interface-card 3 Переданный, полученный и суммарный трафик физических сетевых интерфейсов.
basic-storage-device 4 Использование, общий размер, занятое и свободное пространство физических накопителей.
advanced-storage-device 3 Скорость чтения, скорость записи и IOPS физических накопителей.
virtual-machine 9 Процессор, память и давление на память виртуальных машин.
basic-virtual-network-interface-card 3 Переданные, полученные и суммарные пакеты виртуальных сетевых интерфейсов.
advanced-virtual-network-interface-card 3 Переданный, полученный и суммарный трафик виртуальных сетевых интерфейсов.
basic-virtual-storage-device 4 Использование и объём виртуальных накопителей.
advanced-virtual-storage-device 3 Скорость чтения, скорость записи и IOPS виртуальных накопителей.

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

  • host-virtual-machine;
  • host-cpu;
  • host-memory;
  • virtual-machine;
  • basic-storage-device;
  • basic-virtual-storage-device;
  • cluster-shared-volume — для кластерной конфигурации.

Расширенные наборы сетевых и дисковых показателей включайте при необходимости.

Собираемые данные

Кластеры и Cluster Shared Volumes

Расширение собирает:

  • общий размер тома;
  • используемое пространство;
  • доступное пространство;
  • скорость чтения;
  • скорость записи.

Узлы Hyper-V

Для каждого узла собираются:

  • количество виртуальных машин;
  • количество работающих виртуальных машин;
  • время работы;
  • загрузка процессора;
  • резерв процессора;
  • количество физических процессоров;
  • количество логических процессоров;
  • общий объём памяти;
  • используемая память;
  • доступная память;
  • процент использования памяти.

Виртуальные машины

Для виртуальных машин собираются:

  • количество виртуальных процессоров;
  • резерв процессора;
  • использование процессора относительно ресурсов узла;
  • фактическое использование процессора внутри виртуальной машины;
  • общий объём памяти;
  • используемая память;
  • доступная память;
  • процент использования памяти;
  • давление на память.

Показатель фактической загрузки процессора отражает загрузку, видимую внутри виртуальной машины. Обычный показатель загрузки отражает использование относительно полной вычислительной мощности узла.

Накопители

Для физических и виртуальных накопителей собираются:

  • общий размер;
  • используемое пространство;
  • свободное пространство;
  • процент использования;
  • скорость чтения;
  • скорость записи;
  • количество операций ввода-вывода в секунду.

Сетевые интерфейсы

Для физических и виртуальных сетевых интерфейсов собираются:

  • отправленные пакеты;
  • полученные пакеты;
  • общий поток пакетов;
  • отправленные байты;
  • полученные байты;
  • общий сетевой трафик.

Топология

Расширение создаёт сущности:

  • кластер Hyper-V;
  • узел Hyper-V;
  • виртуальная машина;
  • физический накопитель;
  • виртуальный накопитель;
  • физический сетевой интерфейс;
  • виртуальный сетевой интерфейс.

Создаются следующие связи:

  • узел входит в кластер;
  • виртуальная машина работает на узле;
  • физический накопитель относится к узлу;
  • физический сетевой интерфейс относится к узлу;
  • виртуальный накопитель относится к виртуальной машине;
  • виртуальный сетевой интерфейс относится к виртуальной машине.

Если гостевая ОС также контролируется ЕдинымАгентом, расширение пытается связать обнаруженную виртуальную машину с соответствующим экземпляром гостевой ОС по IP-адресу.

Для гостевых Windows связь обычно определяется автоматически. Для Linux результат зависит от поддержки Microsoft Linux Integration Services и доступности IP-адресов гостевой системы.

Панели мониторинга

В пакет входят:

  • классическая панель Hyper-V Overview;
  • панель нового формата Microsoft Hyper-V Infrastructure Overview;
  • аналитические представления кластеров, узлов, виртуальных машин, дисков и сетевых интерфейсов.

Панели позволяют анализировать:

  • распределение ресурсов между виртуальными машинами;
  • загрузку процессоров и памяти;
  • заполнение физических и виртуальных дисков;
  • состояние Cluster Shared Volumes;
  • сетевую нагрузку;
  • взаимосвязи между кластером, узлами и виртуальными машинами.

Оповещения

Расширение содержит десять шаблонов оповещений.

Оповещение Условие по умолчанию
Высокая загрузка процессора кластера Выше 85%.
Высокое использование файловой системы кластера Выше 80%.
Высокое использование памяти кластера Выше 85%.
Мало свободного места на Cluster Shared Volume Ниже 15%.
Высокая загрузка процессора узла Выше 85%.
Высокое использование памяти узла Выше 85%.
Высокая загрузка физического накопителя Выше 85%.
Высокая загрузка виртуального накопителя Выше 85%.
Высокая загрузка процессора виртуальной машины Выше 85%.
Высокое использование памяти виртуальной машины Выше 85%.

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

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

Проверка работы

После активации конфигурации:

  1. Проверьте состояние расширения на каждом узле Hyper-V.
  2. Убедитесь, что расширение запущено от имени LOCAL SYSTEM.
  3. Проверьте появление сущностей Hyper-V Host.
  4. Для кластерной среды проверьте появление Hyper-V Cluster.
  5. Убедитесь, что на каждом узле отображаются работающие виртуальные машины.
  6. Проверьте метрики процессора и памяти.
  7. Проверьте физические и виртуальные накопители.
  8. Откройте панель Microsoft Hyper-V Infrastructure Overview.
  9. Проверьте связи между кластером, узлами и виртуальными машинами.

Устранение неполадок

Расширение не запускается

Проверьте:

  • установлен ли ЕдиныйАгент на узле;
  • добавлено ли расширение в elevated_privileges_extensions;
  • перезапущена ли служба ЕдиногоАгента после изменения конфигурации;
  • соответствует ли имя расширения ru.ruscomtech.extension.hyperv;
  • доступен ли PowerShell;
  • включена ли роль Hyper-V;
  • отсутствуют ли ошибки в журнале расширения.

Узел отображается, но виртуальные машины отсутствуют

Проверьте:

  • набор функций virtual-machine;
  • фильтр виртуальных машин;
  • режим ALLOW или DENY;
  • права на выполнение команд Hyper-V PowerShell;
  • доступ к WMI-классам Hyper-V;
  • наличие работающих виртуальных машин на этом узле.

Расширение должно быть включено на каждом узле кластера. Один узел не собирает все локальные показатели виртуальных машин с остальных узлов.

Не определяется кластер

Проверьте:

  • установлен ли компонент Failover Clustering;
  • доступна ли команда получения сведений о кластере в PowerShell;
  • фильтр кластера;
  • выполнение расширения от имени LOCAL SYSTEM.

Узлы, не входящие в кластер, могут контролироваться отдельно.

После миграции виртуальная машина видна на двух узлах

Версия 4.1.5 содержит исправления очистки устаревших данных о размещении виртуальных машин.

Проверьте:

  • что на всех узлах используется одинаковая версия расширения;
  • что конфигурация активна на всех узлах;
  • что сбор данных завершается без ошибок;
  • что фильтры виртуальных машин одинаковы на всех узлах.

Не создаётся связь с гостевой ОС

Связь определяется по IP-адресу.

Проверьте:

  • установлен ли ЕдиныйАгент внутри гостевой ОС;
  • передаёт ли Hyper-V IP-адрес виртуальной машины;
  • совпадает ли IP-адрес с адресом гостевой ОС;
  • установлен ли Microsoft Linux Integration Services для Linux-гостя.

История изменений

Версия Изменения
4.1.5 Перепакованы Python-библиотеки для будущей совместимости с Python 3.14.