Nutanix AHV

Кластеры Nutanix, считываемые через REST API v4 Prism Central. Один Prism Central охватывает все зарегистрированные в нём кластеры.

Каждую минуту DumbMonit читает, с базовой HTTP-аутентификацией на порту 9440:

Что	Путь
Кластеры	/api/clustermgmt/v4.0/config/clusters
Хосты	/api/clustermgmt/v4.0/config/hosts
ВМ AHV	/api/vmm/v4.0/ahv/config/vms
Контейнеры хранилища	/api/clustermgmt/v4.0/config/storage-containers
Уровень заполнения каждого контейнера	/api/clustermgmt/v4.0/stats/storage-containers/{extId}
Неустранённые оповещения	/api/monitoring/v4.0/serviceability/alerts

Списки читаются по 100 элементов на страницу, до 1000 элементов каждый. Уровень заполнения и оповещения необязательны: если роль учётной записи их не разрешает, остальное всё равно собирается. Nutanix объявила API v1, v2.0 и v3 устаревшими; развивается только v4, и ей нужен Prism Central pc.2024.3 или новее.

Проверено только по документации производителя — пока не испытано на реальной системе

Эта интеграция построена на спецификациях API v4 от Nutanix (пути и поля в том виде, как их определяют официальные сгенерированные клиенты) и проверена на записанных ответах, а не на работающем Prism Central. Сообщите нам, если что-то не работает.

Что отслеживается

Все метрики с префиксом dumbmonit_nutanix_.

Метрика	Метки	Значение
clusters		Кластеры, без самого Prism Central.
cluster_info	cluster, version	Значение 1: версия AOS каждого кластера.
cluster_available	cluster	1, когда Prism Central достигает кластера.
hosts		Хосты всех кластеров.
host_info	host, cluster, hypervisor	Значение 1: гипервизор, который запущен на каждом хосте.
host_cpu_cores, host_memory_bytes	host, cluster	Ёмкость.
host_degraded	host, cluster	1, когда Nutanix помечает хост как деградировавший.
host_maintenance	host, cluster	1, когда хост входит в режим обслуживания или находится в нём.
vms, vms_running		ВМ AHV и сколько из них включено.
vm_power_state_info	vm, cluster, state	Значение 1: on, off, paused или undetermined.
vm_running	vm, cluster	1, когда ВМ включена.
vm_vcpus, vm_memory_bytes	vm, cluster	Сокеты × ядра × потоки и настроенная память.
storage_containers		Контейнеры хранилища, без внутренних контейнеров Nutanix.
storage_container_capacity_bytes, storage_container_used_bytes, storage_container_used_percent	container, cluster	Уровень заполнения по последней статистике за последние тридцать минут.
alerts_unresolved, alerts_critical, alerts_warning		Неустранённые оповещения: все и по важности.

Применяемые встроенные правила:

• Nutanix host degraded: хост помечен как деградировавший пять минут (Warning).
• Nutanix storage container almost full: контейнер заполнен на 90 % пятнадцать минут (Advisory).
• Nutanix critical alerts: Prism Central сообщает хотя бы об одном неустранённом критическом оповещении пять минут (Warning).

Создайте пользователя только для чтения в Prism Central

1. В Prism Central откройте Admin Center > IAM > Identities и добавьте локального пользователя с длинным случайным паролем, с таким именем.

   dumbmonit

2. В разделе Admin Center > IAM > Authorization Policies создайте политику со встроенной ролью Prism Viewer для всех сущностей и назначьте её этому пользователю. Prism Viewer читает кластеры, хосты, ВМ, контейнеры хранилища и оповещения и ничего не изменяет.

3. В DumbMonit введите адрес Prism Central, например «prism-central.lan», с этим именем пользователя и паролем. Один Prism Central сообщает обо всех зарегистрированных в нём кластерах.

4. DumbMonit только читает API v4 (clustermgmt, vmm и monitoring, версия 4.0): он никогда не включает и не выключает ВМ, никогда не закрывает оповещение и никогда не изменяет контейнер хранилища.

Warning

API v4 предоставляет Prism Central pc.2024.3 или новее; кластер, управляемый только Prism Element или более старым Prism Central, не поддерживается. Prism Central поставляется с самоподписанным сертификатом: отметьте Accept an unverifiable certificate, если хост DumbMonit не доверяет его центру сертификации.

Учётные данные

Учётные данные	Поля
Имя пользователя и пароль	Локальный пользователь dumbmonit с ролью Prism Viewer.

Адрес: имя хоста или IP Prism Central, host:port или URL. Параметры:

• Порт (9440).
• Принимать непроверяемый сертификат: собственный сертификат Prism Central самоподписан.
• Тайм-аут на запрос (15 с).

Диагностика

«Nutanix Prism Central refused the credentials … (401)»: неверное имя пользователя или пароль.

«Nutanix Prism Central has no /api/clustermgmt/v4.0/…»: указан адрес Prism Element или Prism Central старше pc.2024.3.

Нет storage_container_used_percent: роль не разрешает читать статистику; контейнеры всё равно учитываются, с их настроенной ёмкостью.