Azubarev: Новая страница: «= Nutanix = Расширение предназначено для удалённого мониторинга инфраструктуры Nutanix через API Prism Central. Оно собирает показатели кластеров, гипервизоров, виртуальных машин, дисков, сетей и контейнеров хранения, а также формирует связанные сущности в Ключ-АСТ...»

2026-09-25T19:54:57Z

Новая страница: «= Nutanix = Расширение предназначено для удалённого мониторинга инфраструктуры Nutanix через API Prism Central. Оно собирает показатели кластеров, гипервизоров, виртуальных машин, дисков, сетей и контейнеров хранения, а также формирует связанные сущности в Ключ-АСТ...»

Новая страница

= Nutanix =

Расширение предназначено для удалённого мониторинга инфраструктуры Nutanix через API Prism Central. Оно собирает показатели кластеров, гипервизоров, виртуальных машин, дисков, сетей и контейнеров хранения, а также формирует связанные сущности в Ключ-АСТРОМ.

{| class="wikitable"
! Параметр
! Значение

|-
| Идентификатор
| <code>ru.ruscomtech.extension.nutanix</code>
|-
| Источник данных
| Nutanix Prism Central API
|-
| Режим выполнения
| Удалённый, через АктивныйШлюз
|}

== Возможности расширения ==

* Мониторинг кластеров Nutanix.
* Контроль загрузки процессора и памяти гипервизоров.
* Мониторинг хостов и виртуальных машин.
* Сбор IOPS, пропускной способности и задержек.
* Контроль физических и виртуальных дисков.
* Мониторинг контейнеров хранения.
* Получение статистики сетей.
* Импорт оповещений и событий Nutanix.
* Преобразование категорий Nutanix в теги сущностей.
* Фильтрация кластеров, виртуальных машин и контейнеров хранения.
* Связывание виртуальных машин и гипервизоров с контролируемыми хостами.
* Готовая обзорная панель.
* Готовые шаблоны обнаружения аномалий.

== Совместимость ==

Версия <code>3.5.3</code> использует API Prism Central версии 4.

Рекомендуемая конфигурация:

* Nutanix AOS <code>7.x</code>;
* Prism Central <code>2023.4+</code>;
* доступ к Prism Central API версии 4;
* HTTPS-порт Prism Central <code>9440</code>.

Мониторинг через Prism Element API в версии расширения <code>3.x</code> не поддерживается. Если среда не предоставляет API версии 4, необходимо использовать расширение Nutanix версии <code>2.x</code>.

Одна конфигурация расширения поддерживает подключение только к одному Prism Central. Для нескольких экземпляров Prism Central создайте отдельные конфигурации.

== Требования ==

Для работы расширения необходимы:

* АктивныйШлюз с включённым выполнением расширений.
* Сетевой доступ от АктивногоШлюза к Prism Central.
* Учётная запись Nutanix с ролью <code>Prism Viewer</code>.
* Доступ к API Prism Central версии 4.
* Разрешение HTTPS-соединений к порту <code>9440</code>.

Вместо роли <code>Prism Viewer</code> можно попробовать назначить следующие ограниченные роли:

* <code>Cluster Viewer</code>;
* <code>Monitoring Viewer</code>;
* <code>Network Shared Resources Viewer</code>;
* <code>Storage Viewer</code>;
* <code>Virtual Machine Viewer</code>.

Доступность всех данных при использовании ограниченных ролей зависит от версии Prism Central. Если часть API недоступна, используйте роль <code>Prism Viewer</code>.

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

# Откройте раздел управления расширениями Ключ-АСТРОМ.
# Загрузите подписанный пакет <code>ru.ruscomtech.extension.nutanix-3.5.3.zip</code>.
# Установите расширение.
# Добавьте конфигурацию мониторинга.
# Выберите группу АктивныхШлюзов.
# Настройте подключение к Prism Central.
# Выберите необходимые наборы метрик.
# Сохраните и включите конфигурацию.

== Конфигурация подключения ==

{| class="wikitable"
! Параметр
! Описание
|-
| URL
| Адрес Prism Central. Рекомендуемый формат: <code>prism-central.example.local:9440</code>.
|-
| Use credential vault
| Использование учётных данных из хранилища секретов.
|-
| Select vault credentials
| Запись хранилища с именем пользователя и паролем.
|-
| User name
| Пользователь Prism Central с правами просмотра.
|-
| Password
| Пароль пользователя.
|-
| Proxy
| Необязательный прокси-сервер для подключения к Prism Central API.
|-
| Import Nutanix Alerts
| Импорт оповещений Nutanix.
|-
| Import Nutanix Events
| Импорт событий Nutanix.
|-
| Import Nutanix Categories as Entity Tags
| Добавление категорий Nutanix как тегов сущностей.
|-
| Access Token
| Токен Ключ-АСТРОМ, необходимый для импорта оповещений, событий и категорий.
|-
| Filter Mode
| Режим применения фильтров: <code>allow</code> или <code>deny</code>.
|-
| Cluster Filter
| Регулярные выражения для фильтрации кластеров.
|-
| VM Filter
| Регулярные выражения для фильтрации виртуальных машин.
|-
| Storage Container Filter
| Регулярные выражения для фильтрации контейнеров хранения.
|-
| Log level
| Уровень журналирования: <code>INFO</code> или <code>DEBUG</code>.
|-
| Frequency
| Интервал сбора в минутах. По умолчанию — одна минута.
|}

Протокол в поле URL можно не указывать. Если порт отсутствует, расширение автоматически использует <code>9440</code>.

Пример:

<pre>
prism-central.example.local:9440
</pre>

Версия <code>3.5.3</code> не выполняет проверку сертификата Prism Central. Подключение должно выполняться только через доверенную внутреннюю сеть.

== Настройка прокси ==

Прокси требуется только в том случае, если АктивныйШлюз не может напрямую подключиться к Prism Central.

Пример адреса:

<pre>
http://proxy.example.local:8080
</pre>

При необходимости укажите имя пользователя и пароль прокси.

== Импорт оповещений, событий и категорий ==

Импорт является необязательным. Для сбора обычных метрик токен Ключ-АСТРОМ не требуется.

Если необходимо импортировать оповещения, события или категории:

# Включите REST-интерфейс АктивногоШлюза, установив <code>restInterface=true</code> в файле <code>custom.properties</code>.
# Создайте токен доступа Ключ-АСТРОМ.
# Предоставьте токену права чтения сущностей и управления тегами сущностей.
# Укажите токен в поле <code>Access Token</code>.
# Включите необходимые параметры импорта.

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

Категории Nutanix добавляются как теги соответствующих сущностей Ключ-АСТРОМ.

== Фильтрация сущностей ==

Фильтры принимают регулярные выражения. Можно настроить до десяти выражений для каждого типа сущности.

Режим <code>allow</code> включает сущности, имя которых соответствует хотя бы одному выражению.

Режим <code>deny</code> исключает сущности, имя которых соответствует хотя бы одному выражению.

Пример выбора объектов, имена которых заканчиваются на <code>-test</code>:

<pre>
^.*-test$
</pre>

Фильтр кластера также применяется к входящим в него сущностям. Фильтр виртуальных машин распространяется на их виртуальные диски, а фильтр контейнеров хранения — на связанные виртуальные диски.

== Наборы метрик ==

{| class="wikitable"
! Область
! Наборы
|-
| Кластеры
| <code>nutanix_cluster_stats</code>, <code>nutanix_cluster_controller</code>, <code>nutanix_cluster_io</code>, <code>nutanix_cluster_storage</code>
|-
| Хосты
| <code>nutanix_host_stats</code>, <code>nutanix_host_controller</code>, <code>nutanix_host_io</code>, <code>nutanix_host_storage</code>
|-
| Виртуальные машины
| <code>nutanix_vm_stats</code>, <code>nutanix_vm_hypervisor</code>, <code>nutanix_vm_controller_storage</code>
|-
| Физические диски
| <code>nutanix_disk_stats</code>, <code>nutanix_disk_io</code>, <code>nutanix_disk_storage</code>
|-
| Контейнеры хранения
| <code>nutanix_pool_stats</code>, <code>nutanix_pool_io</code>, <code>nutanix_pool_storage</code>
|-
| Сети
| <code>nutanix_network_stats</code>
|-
| Виртуальные диски
| <code>nutanix_virtual_disk_stats</code>
|}

В крупных средах рекомендуется включать только необходимые наборы. Если сбор не укладывается в заданный интервал, увеличьте значение <code>Frequency</code> или разделите объекты между несколькими конфигурациями с помощью фильтров.

== Основные метрики ==

=== Кластеры ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>nutanix_cluster_cpu_hypervisor_usage_percent</code>
| Использование процессора гипервизорами кластера.
|-
| <code>nutanix_cluster_memory_hypervisor_usage_percent</code>
| Использование памяти гипервизорами кластера.
|-
| <code>nutanix_cluster_health_check_score</code>
| Оценка состояния кластера по результатам NCC.
|-
| <code>nutanix_cluster_controller_iops</code>
| Количество операций ввода-вывода контроллера.
|-
| <code>nutanix_cluster_controller_avg_io_latency</code>
| Средняя задержка операций ввода-вывода.
|-
| <code>nutanix_cluster_storage_capacity</code>
| Общая ёмкость хранилища кластера.
|-
| <code>nutanix_cluster_storage_free</code>
| Свободное пространство кластера.
|-
| <code>nutanix_cluster_storage_usage</code>
| Используемое пространство кластера.
|}

=== Хосты и виртуальные машины ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>nutanix_host_cpu_usage_percent</code>
| Использование процессора хоста.
|-
| <code>nutanix_host_hypervisor_memory_usage_percent</code>
| Использование памяти хоста.
|-
| <code>nutanix_host_health_check_score</code>
| Оценка состояния хоста.
|-
| <code>nutanix_host_controller_storage_iops</code>
| IOPS контроллера хранения хоста.
|-
| <code>nutanix_vm_cpu_usage_percent</code>
| Использование процессора виртуальной машиной.
|-
| <code>nutanix_vm_memory_usage_percent</code>
| Использование памяти виртуальной машиной.
|-
| <code>nutanix_vm_hypervisor_cpu_ready_time_percent</code>
| Время ожидания процессора гипервизора.
|-
| <code>nutanix_vm_controller_storage_latency</code>
| Задержка операций хранения виртуальной машины.
|}

=== Хранилище и сети ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>nutanix_disk_io_iops</code>
| IOPS физического диска.
|-
| <code>nutanix_disk_io_latency</code>
| Задержка физического диска.
|-
| <code>nutanix_disk_storage_free</code>
| Свободное пространство физического диска.
|-
| <code>nutanix_pool_storage_free_space_physical</code>
| Свободное физическое пространство контейнера хранения.
|-
| <code>nutanix_pool_io_controller_latency</code>
| Задержка контроллера контейнера хранения.
|-
| <code>nutanix_virtual_disk_usage</code>
| Использование виртуального диска.
|-
| <code>nutanix_network_free_ips</code>
| Количество свободных IP-адресов сети.
|-
| <code>nutanix_network_assigned_ips</code>
| Количество назначенных IP-адресов.
|}

Значение показателя состояния NCC интерпретируется следующим образом:

{| class="wikitable"
! Значение
! Состояние
|-
|100
|Норма
|-
|98
|Информация
|-
|74
|Предупреждение
|-
|24
|Критическое состояние
|-
|13
|Ошибка
|-
|-1
|Неизвестно
|}

== Создаваемые сущности ==

{| class="wikitable"
! Тип
! Назначение
|-
| <code>nutanix:cluster</code>
| Кластер Nutanix.
|-
| <code>nutanix:host</code>
| Хост гипервизора.
|-
| <code>nutanix:vm</code>
| Виртуальная машина.
|-
| <code>nutanix:disk</code>
| Физический диск.
|-
| <code>nutanix:virtual_disk</code>
| Виртуальный диск.
|-
| <code>nutanix:storage_container</code>
| Контейнер хранения.
|-
| <code>nutanix:network</code>
| Сеть Nutanix.
|-
| <code>nutanix:project</code>
| Проект Nutanix.
|}

Расширение формирует связи между кластерами, хостами, виртуальными машинами, дисками, контейнерами хранения, сетями и проектами.

Если внутри виртуальной машины установлен ЕдиныйАгент, сущность Nutanix VM связывается с контролируемым хостом по IP-адресу. Аналогичная связь создаётся для хоста гипервизора.

== Шаблоны обнаружения аномалий ==

Расширение содержит следующие шаблоны:

* высокая загрузка процессора кластера;
* критическая загрузка процессора кластера;
* высокая загрузка памяти кластера;
* критическая загрузка памяти кластера;
* высокая загрузка процессора хоста;
* критическая загрузка процессора хоста.

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

# Проверьте доступность <code>https://<prism-central>:9440</code> с АктивногоШлюза.
# Убедитесь, что учётная запись может просматривать кластеры и виртуальные машины.
# Проверьте состояние конфигурации расширения.
# Откройте обзорную панель Nutanix.
# Проверьте появление сущностей кластера, хостов и виртуальных машин.
# Убедитесь, что поступают метрики с префиксом <code>nutanix_</code>.

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

{| class="wikitable"
! Проблема
! Решение
|-
| Ошибка подключения
| Проверьте адрес Prism Central, порт <code>9440</code>, DNS и правила межсетевого экрана.
|-
| Ошибка аутентификации
| Проверьте имя пользователя, пароль и назначенные роли.
|-
| Часть объектов отсутствует
| Проверьте режим и регулярные выражения фильтрации.
|-
| Сбор не завершается за интервал
| Увеличьте <code>Frequency</code>, сократите число наборов метрик или разделите объекты между конфигурациями.
|-
| Оповещения и события не импортируются
| Проверьте <code>restInterface=true</code>, токен доступа и включённые параметры импорта.
|-
| Категории не преобразуются в теги
| Проверьте права токена на чтение сущностей и управление тегами.
|-
| Нет связи между VM и контролируемым хостом
| Проверьте наличие ЕдиныйАгента и совпадение IP-адресов.
|-
| Среда не поддерживает API версии 4
| Используйте расширение Nutanix версии <code>2.x</code>.
|}

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

{| class="wikitable"
! Версия
! Изменения
|-
|3.5.3
|
* Для Ключ-АСТРОМ <code>1.313.0+</code>.
* Улучшена производительность сбора метрик физических дисков, виртуальных машин и виртуальных дисков.
* Снижена вероятность пропусков данных и превышения времени сбора в крупных средах.
|}

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