Nutanix

Nutanix

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

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

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

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

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

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

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

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

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

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

Требования

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

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

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

• Cluster Viewer;
• Monitoring Viewer;
• Network Shared Resources Viewer;
• Storage Viewer;
• Virtual Machine Viewer.

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

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

1. Откройте раздел управления расширениями Ключ-АСТРОМ.
2. Загрузите подписанный пакет ru.ruscomtech.extension.nutanix-3.5.3.zip.
3. Установите расширение.
4. Добавьте конфигурацию мониторинга.
5. Выберите группу АктивныхШлюзов.
6. Настройте подключение к Prism Central.
7. Выберите необходимые наборы метрик.
8. Сохраните и включите конфигурацию.

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

Параметр	Описание
URL	Адрес Prism Central. Рекомендуемый формат: prism-central.example.local:9440.
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	Режим применения фильтров: allow или deny.
Cluster Filter	Регулярные выражения для фильтрации кластеров.
VM Filter	Регулярные выражения для фильтрации виртуальных машин.
Storage Container Filter	Регулярные выражения для фильтрации контейнеров хранения.
Log level	Уровень журналирования: INFO или DEBUG.
Frequency	Интервал сбора в минутах. По умолчанию — одна минута.

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

Пример:

prism-central.example.local:9440

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

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

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

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

http://proxy.example.local:8080

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

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

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

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

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

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

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

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

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

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

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

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

^.*-test$

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

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

Область	Наборы
Кластеры	nutanix_cluster_stats, nutanix_cluster_controller, nutanix_cluster_io, nutanix_cluster_storage
Хосты	nutanix_host_stats, nutanix_host_controller, nutanix_host_io, nutanix_host_storage
Виртуальные машины	nutanix_vm_stats, nutanix_vm_hypervisor, nutanix_vm_controller_storage
Физические диски	nutanix_disk_stats, nutanix_disk_io, nutanix_disk_storage
Контейнеры хранения	nutanix_pool_stats, nutanix_pool_io, nutanix_pool_storage
Сети	nutanix_network_stats
Виртуальные диски	nutanix_virtual_disk_stats

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

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

Кластеры

Метрика	Описание
nutanix_cluster_cpu_hypervisor_usage_percent	Использование процессора гипервизорами кластера.
nutanix_cluster_memory_hypervisor_usage_percent	Использование памяти гипервизорами кластера.
nutanix_cluster_health_check_score	Оценка состояния кластера по результатам NCC.
nutanix_cluster_controller_iops	Количество операций ввода-вывода контроллера.
nutanix_cluster_controller_avg_io_latency	Средняя задержка операций ввода-вывода.
nutanix_cluster_storage_capacity	Общая ёмкость хранилища кластера.
nutanix_cluster_storage_free	Свободное пространство кластера.
nutanix_cluster_storage_usage	Используемое пространство кластера.

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

Метрика	Описание
nutanix_host_cpu_usage_percent	Использование процессора хоста.
nutanix_host_hypervisor_memory_usage_percent	Использование памяти хоста.
nutanix_host_health_check_score	Оценка состояния хоста.
nutanix_host_controller_storage_iops	IOPS контроллера хранения хоста.
nutanix_vm_cpu_usage_percent	Использование процессора виртуальной машиной.
nutanix_vm_memory_usage_percent	Использование памяти виртуальной машиной.
nutanix_vm_hypervisor_cpu_ready_time_percent	Время ожидания процессора гипервизора.
nutanix_vm_controller_storage_latency	Задержка операций хранения виртуальной машины.

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

Метрика	Описание
nutanix_disk_io_iops	IOPS физического диска.
nutanix_disk_io_latency	Задержка физического диска.
nutanix_disk_storage_free	Свободное пространство физического диска.
nutanix_pool_storage_free_space_physical	Свободное физическое пространство контейнера хранения.
nutanix_pool_io_controller_latency	Задержка контроллера контейнера хранения.
nutanix_virtual_disk_usage	Использование виртуального диска.
nutanix_network_free_ips	Количество свободных IP-адресов сети.
nutanix_network_assigned_ips	Количество назначенных IP-адресов.

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

Значение	Состояние
100	Норма
98	Информация
74	Предупреждение
24	Критическое состояние
13	Ошибка
Неизвестно

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

Тип	Назначение
nutanix:cluster	Кластер Nutanix.
nutanix:host	Хост гипервизора.
nutanix:vm	Виртуальная машина.
nutanix:disk	Физический диск.
nutanix:virtual_disk	Виртуальный диск.
nutanix:storage_container	Контейнер хранения.
nutanix:network	Сеть Nutanix.
nutanix:project	Проект Nutanix.

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

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

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

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

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

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

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

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

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

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

Версия	Изменения
3.5.3	Для Ключ-АСТРОМ 1.313.0+. Улучшена производительность сбора метрик физических дисков, виртуальных машин и виртуальных дисков. Снижена вероятность пропусков данных и превышения времени сбора в крупных средах.