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

Материал из Документация Ключ-АСТРОМ
← Предыдущая правка
ВизуальныйВики-текст
Нет описания правки
Нет описания правки
 
(не показаны 3 промежуточные версии 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 или новее


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


==== В: Необходимо ли развертывать расширение на каждом сервере (узле) в кластере Hyper-V или достаточно развернуть его на одном сервере, имеющем доступ к сведениям о кластере? ====
== Требования ==
A: Расширение должно быть включено на всех хостовых (серверных/узловых) машинах в кластере. Расширение собирает метрики с гостевых виртуальных машин, работающих на каждом хосте.


=== В: Каково потребление ВИД этим расширением? ===
Перед установкой убедитесь, что:
A: Формула для расчета потребления DDU расширения следующая:
  <code>( ( 3 * number of Clusters)
+ ( ( 9 * number of Hosts)
+ ( ( 6 * number of VMs)
+ ( ( 4 * number of Storage Devices)
+ ( ( 4 * number of Virtual Storage Devices)
+ ( ( 6 * number of NICs)
+ ( ( 6 * number of vNICs) ) * 525.6 ВИД/год</code>
Стоимость ВИД выше не включает в себя возможные события лога или пользовательские события, вызванные расширением. Для получения дополнительной информации посетите страницы стоимости событий журнала ВИД и стоимости пользовательских событий ВИД .


=== Наборы функций ===
* на каждом узле кластера установлен и работает ЕдиныйАгент;
Ниже приведен полный список наборов функций, представленных в этой версии. Чтобы обеспечить соответствие вашим потребностям, администратор может активировать и деактивировать отдельные наборы функций во время настройки.
* роль 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"
{| class="wikitable"
! colspan="1" |Название метрики
! Режим
! colspan="1" |Ключ метрики
! Описание
! colspan="1" |Описание
! colspan="1" |Единица
|-
|Отправлено сетевых пакетов
|hyperv.virtual_machine.network_interface_card.packets_sent
| -
|в сек
|-
|-
|Получено сетевых пакетов
| <code>ALLOW</code>
|hyperv.virtual_machine.network_interface_card.packets_received
| Собираются только сущности, соответствующие регулярному выражению.
| -
|в сек
|-
|-
|переданные сетевые пакеты
| <code>DENY</code>
|hyperv.virtual_machine.network_interface_card.packets_transferred
| Сущности, соответствующие регулярному выражению, исключаются из мониторинга.
| -
|в сек
|}
|}
Значение по умолчанию — <code>ALLOW</code>.
Выражение <code>.*</code> в режиме <code>ALLOW</code> включает все сущности соответствующего типа.
=== Фильтры сущностей ===
Можно настроить отдельные регулярные выражения для:
{| class="wikitable"
{| class="wikitable"
! colspan="1" |Название метрики
! Параметр
! colspan="1" |Ключ метрики
! Что фильтруется
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Загрузка ЦП
| <code>Cluster Filter</code>
|hyperv.host.cpu_utilization
| Кластеры Hyper-V.
| -
|Процент
|-
|-
|Логическое количество ЦП
| <code>Host Filter</code>
|hyperv.host.logical_cpu_count.gauge
| Узлы Hyper-V.
| -
|Ядра
|-
|-
|Физическое количество ЦП
| <code>VM Filter</code>
|hyperv.host.physical_cpu_count.gauge
| Виртуальные машины.
| -
|Ядра
|-
|-
|Резерв ЦП
| <code>Network Interface Card Filter</code>
|hyperv.host.cpu_reserve
| Физические сетевые интерфейсы узлов.
| -
|Процент
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Общее пространство
| <code>Storage Device Filter</code>
|hyperv.cluster_shared_volume.total_space
| Физические накопители узлов.
| -
|Байт
|-
|-
|Использованное дисковое пространство
| <code>Virtual Network Interface Card Filter</code>
|hyperv.cluster_shared_volume.used_space
| Виртуальные сетевые интерфейсы.
| -
|Байт
|-
|-
|Доступное место на диске
| <code>Virtual Storage Device Filter</code>
|hyperv.cluster_shared_volume.free_space
| Виртуальные накопители.
| -
|Байт
|}
|}
Например:
<pre>
^.*-test$
</pre>
В режиме <code>ALLOW</code> выражение включает только сущности, имена которых заканчиваются на <code>-test</code>. В режиме <code>DENY</code> такие сущности исключаются.
Ошибочное регулярное выражение может привести к отсутствию данных.
== Наборы функций ==
Для работы конфигурации необходимо выбрать хотя бы один набор функций.
{| class="wikitable"
{| class="wikitable"
! colspan="1" |Название метрики
! Набор функций
! colspan="1" |Ключ метрики
! Метрик
! colspan="1" |Описание
! Назначение
! colspan="1" |Единица
|-
| <code>cluster-shared-volume</code>
| 5
| Размер, свободное и используемое пространство, скорость чтения и записи Cluster Shared Volumes.
|-
|-
|Отправлено сетевых пакетов
| <code>host-virtual-machine</code>
|hyperv.хост.сетевая_интерфейсная_карта.пакеты_отправлены
| 3
| -
| Количество виртуальных машин, количество работающих машин и время работы узла.
|БайтВСекунду
|-
|-
|Получено сетевых пакетов
| <code>host-cpu</code>
|hyperv.хост.сетевая_интерфейсная_карта.пакеты_получены
| 4
| -
| Загрузка процессора, резерв процессора, количество физических и логических ядер.
|БайтВСекунду
|-
|-
|Передано сетевых пакетов
| <code>host-memory</code>
|hyperv.хост.сетевая_интерфейсная_карта.пакеты_переданы
| 4
| -
| Общая, используемая и доступная память узла, процент использования.
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Скорость чтения диска
| <code>basic-network-interface-card</code>
|hyperv.виртуальная_машина.устройство_хранения.скорость_чтения
| 3
| -
| Переданные, полученные и суммарные пакеты физических сетевых интерфейсов.
|PerSecond
|-
|-
|Скорость записи на диск
| <code>advanced-network-interface-card</code>
|hyperv.виртуальная_машина.устройство_хранения.скорость_записи
| 3
| -
| Переданный, полученный и суммарный трафик физических сетевых интерфейсов.
|PerSecond
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Скорость чтения диска
| <code>basic-storage-device</code>
|hyperv.host.disk.read_rate
| 4
| -
| Использование, общий размер, занятое и свободное пространство физических накопителей.
|PerSecond
|-
|-
|Скорость записи на диск
| <code>advanced-storage-device</code>
|hyperv.host.disk.write_rate
| 3
| -
| Скорость чтения, скорость записи и IOPS физических накопителей.
|PerSecond
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Отправлено сетевых байтов
| <code>virtual-machine</code>
|hyperv.хост.сетевая_карта_интерфейса.байты_отправлены
| 9
| -
| Процессор, память и давление на память виртуальных машин.
|БайтВСекунду
|-
|-
|Получено сетевых байтов
| <code>basic-virtual-network-interface-card</code>
|hyperv.хост.сетевая_карта_интерфейса.получено_байт
| 3
| -
| Переданные, полученные и суммарные пакеты виртуальных сетевых интерфейсов.
|БайтВСекунду
|-
|-
|Передано сетевых байтов
| <code>advanced-virtual-network-interface-card</code>
|hyperv.хост.сетевая_интерфейсная_карта.байты_передано
| 3
| -
| Переданный, полученный и суммарный трафик виртуальных сетевых интерфейсов.
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Общий размер диска
| <code>basic-virtual-storage-device</code>
|hyperv.хост.диск.общий_размер
| 4
| -
| Использование и объём виртуальных накопителей.
|Байты
|-
|-
|Доступное место на диске
| <code>advanced-virtual-storage-device</code>
|hyperv.host.disk.space_free
| 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"
{| class="wikitable"
! colspan="1" |Название метрики
! Оповещение
! colspan="1" |Ключ метрики
! Условие по умолчанию
! colspan="1" |Описание
! colspan="1" |Единица
|-
|Количество ЦП
|hyperv.virtual_machine.cpu_count.gauge
| -
|Ядра
|-
|-
|Резерв ЦП
| Высокая загрузка процессора кластера
|hyperv.виртуальная_машина.cpu_reserve
| Выше 85%.
| -
|Процент
|-
|-
|Загрузка ЦП
| Высокое использование файловой системы кластера
|hyperv.virtual_machine.cpu_utilization
| Выше 80%.
| -
|Процент
|-
|-
|Общая память
| Высокое использование памяти кластера
|hyperv.виртуальная_машина.общая_память
| Выше 85%.
| -
|Байты
|-
|-
|Использованная память
| Мало свободного места на Cluster Shared Volume
|hyperv.виртуальная_машина.используемая_память
| Ниже 15%.
| -
|Байты
|-
|-
|Давление памяти
| Высокая загрузка процессора узла
|hyperv.виртуальная_машина.давление_памяти
| Выше 85%.
| -
|Процент
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Количество виртуальных машин
| Высокое использование памяти узла
|hyperv.host.virtual_machine_count.gauge
| Выше 85%.
| -
|Считать
|-
|-
|Число запущенных виртуальных машин
| Высокая загрузка физического накопителя
|hyperv.host.running_virtual_machine_count.gauge
| Выше 85%.
| -
|Считать
|-
|-
|Время безотказной работы
| Высокая загрузка виртуального накопителя
|hyperv.host.uptime
| Выше 85%.
| -
|Секунды
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Отправлено сетевых байтов
| Высокая загрузка процессора виртуальной машины
|hyperv.виртуальная_машина.сетевая_карта_интерфейса.байты_отправлены
| Выше 85%.
| -
|БайтВСекунду
|-
|-
|Получено сетевых байтов
| Высокое использование памяти виртуальной машины
|hyperv.виртуальная_машина.сетевая_карта_интерфейса.получено_байт
| Выше 85%.
| -
|БайтВСекунду
|-
|Передано сетевых байтов
|hyperv.виртуальная_машина.сетевая_карта_интерфейса.байты_передано
| -
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|Общая память
|hyperv.host.total_memory
| -
|Килобайт
|-
|Доступная память
|hyperv.хост.доступная_память
| -
|Килобайт
|}
|}
Порог проверяется в окне из пяти измерений. По умолчанию достаточно одного нарушающего измерения для создания события.
Перед включением шаблонов адаптируйте пороговые значения к обычной нагрузке среды.
== Проверка работы ==
После активации конфигурации:
# Проверьте состояние расширения на каждом узле 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"
{| class="wikitable"
! colspan="1" |Название метрики
! Версия
! colspan="1" |Ключ метрики
! Изменения
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Общее дисковое пространство
| 4.1.5
|hyperv.виртуальная_машина.устройство_хранения.общее_дисковое_пространство
| Перепакованы Python-библиотеки для будущей совместимости с Python 3.14.
| -
|Байт
|-
|-
|Использованное дисковое пространство
|hyperv.виртуальная_машина.устройство_хранения.используемое_дисковое_пространство
| -
|Байт
|}
|}

Текущая версия от 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.
Источник — https://doc.ruscomtech.ru/index.php?title=Мониторинг_Microsoft_Hyper-V&oldid=6974