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

Материал из Документация Ключ-АСТРОМ
← Предыдущая правка
ВизуальныйВики-текст
Нет описания правки
Нет описания правки
 
Строка 1: Строка 1:
'''''[[Расширения]] / [[Расширения#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F%202.0|Расширения 2.0]] / Мониторинг Microsoft Hyper-V'''''
Расширение предназначено для локального мониторинга кластеров, узлов и виртуальных машин Microsoft Hyper-V.


== Инфраструктура Microsoft Hyper-V ==
== Назначение ==
Контролируйте работоспособность и производительность кластеров, хостов и виртуальных машин Hyper-V.


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


'''Это предназначено для пользователей, которые:'''
С помощью расширения можно:


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


* Узкие места процессора
== Архитектура мониторинга ==
* Узкие места памяти
* Узкие места сети
* Узкие места в хранении
* Зависимые приложения, размещенные в кластере Hyper-V


=== Варианты использования ===
Расширение работает локально на каждом узле Hyper-V.
'''Это расширение позволяет вам:'''


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


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


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


* Группа администраторов Hyper-V
Расширение выполняет:
* Доступ на чтение к кластеру, проверьте с помощью Get-ClusterAccess
* Доступ для чтения и записи к каталогу Windows TEMP


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


==== Собранные показатели: ====
== Поддерживаемые системы ==


* Здоровье виртуальных машин
Для работы расширения необходима 64-разрядная операционная система с включённой аппаратной виртуализацией:
* Использование памяти
* Загрузка ЦП
* Операции хранилища
* Сетевой трафик


=== Это расширение создано на основе Extension Framework 2.0 и обеспечивает: ===
* Windows 10 Enterprise, Pro или Education;
* Windows Server 2016 и более новые версии.


* Конфигурацию, необходимую для управления выполнением командлетов PowerShell Hyper-V и сбора метрик из них
Версия конфигурации виртуальных машин Hyper-V должна быть <code>9.0</code> или выше.
* Панель инструментов
* Определения топологии
* Унифицированные экраны анализа


=== Информация о совместимости ===
Минимальная версия Ключ-АСТРОМ — <code>1.318.0</code>.
Для этого расширения требуется:


* ОС x64 с виртуализацией, активируемой BIOS:
Расширение выполняется только на Windows.
** Windows 10 Корпоративная/Профессиональная/Образовательная
** Windows Server 2016 или новее


=== Вопросы и ответы ===
== Требования ==


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


=== В: Каково потребление ВИД этим расширением? ===
* на каждом узле кластера установлен и работает ЕдиныйАгент;
A: Формула для расчета потребления DDU расширения следующая:
* роль Hyper-V установлена и активна;
  <code>( ( 3 * number of Clusters)
* аппаратная виртуализация включена в BIOS или UEFI;
+ ( ( 9 * number of Hosts)
* доступны локальные WMI-классы Hyper-V;
+ ( ( 6 * number of VMs)
* PowerShell может выполнять команды управления Hyper-V;
+ ( ( 4 * number of Storage Devices)
* для кластерной конфигурации установлен компонент Failover Clustering;
+ ( ( 4 * number of Virtual Storage Devices)
* служба ЕдиныйАгент имеет доступ к WMI, системному реестру и PowerShell;
+ ( ( 6 * number of NICs)
* расширению разрешён запуск от имени <code>LOCAL SYSTEM</code>.
+ ( ( 6 * number of vNICs) ) * 525.6 ВИД/год</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" |Единица
|-
|-
|Отправлено сетевых пакетов
| <code>ALLOW</code>
|hyperv.virtual_machine.network_interface_card.packets_sent
| Собираются только сущности, соответствующие регулярному выражению.
| -
|в сек
|-
|-
|Получено сетевых пакетов
| <code>DENY</code>
|hyperv.virtual_machine.network_interface_card.packets_received
| Сущности, соответствующие регулярному выражению, исключаются из мониторинга.
| -
|в сек
|-
|переданные сетевые пакеты
|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.host.network_interface_card.packets_sent
| 3
| -
| Количество виртуальных машин, количество работающих машин и время работы узла.
|БайтВСекунду
|-
|-
|Получено сетевых пакетов
| <code>host-cpu</code>
|hyperv.host.network_interface_card.packets_received
| 4
| -
| Загрузка процессора, резерв процессора, количество физических и логических ядер.
|БайтВСекунду
|-
|-
|Передано сетевых пакетов
| <code>host-memory</code>
|hyperv.host.network_interface_card.packets_transferred
| 4
| -
| Общая, используемая и доступная память узла, процент использования.
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Скорость чтения диска
| <code>basic-network-interface-card</code>
|hyperv.virtual_machine.storage_device.read_rate
| 3
| -
| Переданные, полученные и суммарные пакеты физических сетевых интерфейсов.
|PerSecond
|-
|-
|Скорость записи на диск
| <code>advanced-network-interface-card</code>
|hyperv.virtual_machine.storage_device.write_rate
| 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.host.network_interface_card.bytes_sent
| 9
| -
| Процессор, память и давление на память виртуальных машин.
|БайтВСекунду
|-
|-
|Получено сетевых байтов
| <code>basic-virtual-network-interface-card</code>
|hyperv.host.network_interface_card.bytes_received
| 3
| -
| Переданные, полученные и суммарные пакеты виртуальных сетевых интерфейсов.
|БайтВСекунду
|-
|-
|Передано сетевых байтов
| <code>advanced-virtual-network-interface-card</code>
|hyperv.host.network_interface_card.bytes_transferred
| 3
| -
| Переданный, полученный и суммарный трафик виртуальных сетевых интерфейсов.
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|-
|Общий размер диска
| <code>basic-virtual-storage-device</code>
|hyperv.host.disk.total_size
| 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.virtual_machine.cpu_reserve
| Выше 85%.
| -
|Процент
|-
|-
|Загрузка ЦП
| Высокое использование файловой системы кластера
|hyperv.virtual_machine.cpu_utilization
| Выше 80%.
| -
|Процент
|-
|-
|Общая память
| Высокое использование памяти кластера
|hyperv.virtual_machine.total_memory
| Выше 85%.
| -
|Байты
|-
|-
|Использованная память
| Мало свободного места на Cluster Shared Volume
|hyperv.virtual_machine.used_memory
| Ниже 15%.
| -
|Байты
|-
|-
|Давление памяти
| Высокая загрузка процессора узла
|hyperv.virtual_machine.memory_pressure
| Выше 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.virtual_machine.network_interface_card.bytes_sent
| Выше 85%.
| -
|БайтВСекунду
|-
|-
|Получено сетевых байтов
| Высокое использование памяти виртуальной машины
|hyperv.virtual_machine.network_interface_card.bytes_received
| Выше 85%.
| -
|БайтВСекунду
|-
|Передано сетевых байтов
|hyperv.virtual_machine.network_interface_card.bytes_transferred
| -
|БайтВСекунду
|}
{| class="wikitable"
! colspan="1" |Название метрики
! colspan="1" |Ключ метрики
! colspan="1" |Описание
! colspan="1" |Единица
|-
|Общая память
|hyperv.host.total_memory
| -
|Килобайт
|-
|Доступная память
|hyperv.host.available_memory
| -
|Килобайт
|}
|}
Порог проверяется в окне из пяти измерений. По умолчанию достаточно одного нарушающего измерения для создания события.
Перед включением шаблонов адаптируйте пороговые значения к обычной нагрузке среды.
== Проверка работы ==
После активации конфигурации:
# Проверьте состояние расширения на каждом узле 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.virtual_machine.storage_device.total_disk_space
| Перепакованы Python-библиотеки для будущей совместимости с Python 3.14.
| -
|Байт
|-
|-
|Использованное дисковое пространство
|hyperv.virtual_machine.storage_device.used_disk_space
| -
|Байт
|}
|}

Текущая версия от 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