Nutanix Clusters extension

  • Latest Dynatrace
  • Extension
  • Published Oct 27, 2025

Monitor Nutanix clusters' performance, usage, and availability.

Get started

Overview

Deploy Dynatrace monitoring across Nutanix hybrid cloud clusters.

The Nutanix Clusters extension runs on a Dynatrace ActiveGate and connects to the Nutanix Prism APIs. Activate the extension in your environment via the in-product Hub, then provide the Prism API URLs and a user account to connect to Prism APIs.

Use cases

  • Operational monitoring of your Nutanix clusters using Prism API in Dynatrace, integrated with related insights into the infrastructure and apps that your Nutanix clusters host.
  • Monitor resource utilization, latency, and bandwidth of clusters, hosts, virtual machines, and storage containers, and receive alerts for detected anomalies.
  • Root cause analysis of Nutanix cluster performance bottlenecks, leveraging a dependency model that connects all the entities that comprise Nutanix clusters, down to the OS instances that run the workflows monitored with Dynatrace OneAgent.
  • Simplify monitoring of your Nutanix infrastructure.
  • Gain essential insights into your Nutanix clusters while retaining the context of the workloads and apps that the clusters enable.
  • Leverage a topological model that reflects the Nutanix platform composition to understand dependencies between Nutanix component operations and the performance of workloads that run on Nutanix.
  • Automatically monitor dozens of Nutanix performance metrics, from hosts through virtual machines and storage containers to disks and the network.
  • Extend Dynatrace insights into the infrastructure on which virtual machines run and pinpoint the root causes of issues in their virtualization and application layers.
  • Receive alerts on performance and availability issues detected in your Nutanix infrastructure.
  • Take proactive actions based on anomalies detected in Nutanix infrastructure before they affect your applications.

Requirements

  • Each monitoring configuration supports only one Prism Central connection. Separate monitoring configurations should be defined for each Prism Central.
  • To monitor Nutanix clusters managed by Prism Central, a user account with the following (or equivalent) roles is required to view all resources:
    • Cluster Viewer
    • Storage Viewer
    • Virtual Machine Viewer
    • Network Infra Admin
    • Monitoring Viewer (required only if alerts and events need to be imported)

      To import alerts, events, and categories, set restInterface=true in the custom.properties file. For more details, see Configuration properties and parameters of ActiveGate.

Breaking change in Release 3.0

Release 3.0 of this extension standardizes on the Nutanix v4 API. Nutanix monitoring now relies entirely on the Prism Central v4 API. Earlier versions used APIs v1 and v2, but these are deprecated and will soon be unsupported. As a result, monitoring via the Prism Element API will no longer be available.

The v4 API streamlines configuration and runtime but removes several metrics. Review any alerts and dashboards that use metrics from older extensions. You may need to update metric IDs, replace deprecated metrics, or remove visuals that no longer apply.

Leverage OneAgent to get insights into all Nutanix virtual machines

Install OneAgent on all your Nutanix virtual machines. OneAgent is aware of the Nutanix AHV virtualization technology and uses this information to characterize your workflows. The Nutanix Clusters extension topologically connects Nutanix Hosts and Virtual Machines to OneAgent-monitored hosts.

Compatibility information

  • A Nutanix cluster offering v4 API, reachable from an ActiveGate set up in your Dynatrace environment.
  • Nutanix v4 API connection details: Prism URL, user name, and password for authentication with the Prism v4 API.
  • A user account with the required user roles to view all resources.

Supported Nutanix Versions

The following Nutanix versions have been tested to work with the extension. Other versions of Nutanix not listed may be compatible with the extension.

  • AOS Versions: 7.x
  • Prism version: 2023.4 and newer

Details

Extension package contents

  • Python scripts for metric ingestion using a pull model.
  • Topology definitions for physical and logical Nutanix entities.
  • Sample dashboard for monitoring overview.
  • Sample alerts for CPU and memory usage at cluster, host, and VM levels.
  • Unified analysis views for each entity.

Monitored entities

The Nutanix Clusters extension collects metrics and builds topological relationships for:

  • Cluster
  • Host
  • Virtual machine
  • Storage container
  • Disk
  • Virtual disk
  • Network
  • Alerts
  • Event metrics

Metrics

License consumption is based on the number of metric data points ingested. The following formula provides approximate annual data points ingested, assuming all feature sets are turned on.

(
(
( 16 * number of Clusters)
+ ( 16 * number of Hosts)
+ ( 15 * number of VMs)
+ ( 12 * number of Storage Containers)
+ ( 12 * number of Disks)
+ ( 2 * number of Virtual Disks)
+ ( 3 * number of Networks)
) / <Metrics Collection Interval>
) * 60 minutes * 24 hours * 365 days data points per year

Logs

In addition to metrics, Nutanix alerts and events generate log data. Log volume depends on the number of alerts and events your environment produces and can't be estimated reliably.

Licensing and cost

There is no charge for obtaining the extension, only for the data that the extension ingests. The license consumption details depend on which licensing model you're using. This can either be Dynatrace classic licensing or the Dynatrace Platform Subscription (DPS) model.

Classic licensing

In the Dynatrace classic licensing model, metric ingestion will consume Davis Data Units (DDUs) at the rate of .001 DDUs per metric data point. Multiply the above formula for annual data points by .001 to estimate annual DDU usage.

Feature sets

When activating your extension using monitoring configuration, you can limit monitoring to one of the feature sets. To work properly the extension has to collect at least one metric after the activation.

In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.

All metrics that aren't categorized into any feature set are considered to be the default and are always reported.

A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.

nutanixClusterStats
Metric nameMetric keyDescription
Cluster Hypervisor CPU Usage %nutanix_cluster_cpu_hypervisor_usage_percentHypervisor CPU usage in cluster as a percentage
Cluster Hypervisor Memory Usage %nutanix_cluster_memory_hypervisor_usage_percentHypervisor memory usage in cluster as a percentage
Cluster Health Check Scorenutanix_cluster_health_check_scoreNCC check score indicating the health of the cluster. The value to health mapping is as follows. Good=100, Info=98, Warning=74, Critical=24, Error=13, Unknown=-1
Cluster Alertlog.nutanix_cluster_alertAlert on a Nutanix Cluster
Cluster Eventlog.nutanix_cluster_eventEvent on a Nutanix Cluster
nutanixNetworkStats
Metric nameMetric keyDescription
Network Free IPsnutanix_network_free_ipsNumber of free IPs in the network
Network Assigned IPsnutanix_network_assigned_ipsNumber of assigned IPs in the network
Network MAC Countnutanix_network_num_macsNumber of MAC addresses in the network
nutanixClusterController
Metric nameMetric keyDescription
Cluster Controller IOPSnutanix_cluster_controller_iopsNumber of IOPS of the Controller
Cluster Controller Read IOPSnutanix_cluster_controller_read_iopsNumber of Read IOPS of the Controller
Cluster Controller Write IOPSnutanix_cluster_controller_write_iopsNumber of Write IOPS of the controller
Cluster Controller AVG I/O Latencynutanix_cluster_controller_avg_io_latencyAverage I/O Latency of the Controller
Cluster Controller AVG Read I/O Latencynutanix_cluster_controller_avg_read_io_latencyAverage Read I/O Latency of the Controller
Cluster Controller AVG Write I/O Latencynutanix_cluster_controller_avg_write_io_latencyAverage Write I/O Latency of the Controller
Cluster Controller Read I/O Bandwidthnutanix_cluster_controller_read_io_bandwidthI/O Read Bandwidth of the Controller
Cluster Controller Write I/O Bandwidthnutanix_cluster_controller_write_io_bandwidthI/O Write Bandwidth of the Controller
nutanixHostStats
Metric nameMetric keyDescription
Host CPU Usage %nutanix_host_cpu_usage_percentCPU usage of the Host
Host Memory Usage %nutanix_host_hypervisor_memory_usage_percentMemory usage of the Host
Host Health Check Scorenutanix_host_health_check_scoreNCC check score indicating the health of the host. The value to health mapping is as follows. Good=100, Info=98, Warning=74, Critical=24, Error=13, Unknown=-1
Host Alertlog.nutanix_host_alertAlert on a Nutanix Host
Host Eventlog.nutanix_host_eventEvent on a Nutanix Host
nutanixPoolStorage
Metric nameMetric keyDescription
Storage Container Free Space (Physical)nutanix_pool_storage_free_space_physicalPhysical free space
Storage Container Total Space (Physical)nutanix_pool_storage_total_space_physicalPhysical total space
Storage Container Physical Usagenutanix_pool_storage_physical_usagePhysical usage in bytes
nutanixHostStorage
Metric nameMetric keyDescription
Host Storage Logical Usage Bytesnutanix_host_storage_logical_usage_bytesStorage Logical Usage for the Host
Host Storage Capacity Bytesnutanix_host_storage_capacity_bytesStorage Capacity for the Host
Host Storage Usage Bytesnutanix_host_storage_usage_bytesStorage Usage for the Host
Host Storage Free Bytesnutanix_host_storage_free_bytesStorage free Space for the Host
nutanixDiskStats
Metric nameMetric keyDescription
Disk Alertlog.nutanix_disk_alertAlert on a Nutanix Disk
Disk Eventlog.nutanix_disk_eventEvent on a Nutanix Disk
nutanixClusterStorage
Metric nameMetric keyDescription
Cluster Storage Capacitynutanix_cluster_storage_capacityTotal storage capacity in bytes of the cluster
Cluster Storage Freenutanix_cluster_storage_freeTotal free storage in bytes for the cluster
Cluster Storage Logical Usagenutanix_cluster_storage_logical_usageTotal storage logical usage in bytes for the cluster
Cluster Storage Usagenutanix_cluster_storage_usageTotal storage usage in bytes of the cluster
nutanixDiskStorage
Metric nameMetric keyDescription
Disk Storage Capacitynutanix_disk_storage_capacityStorage capacity of the Disk
Disk Storage freenutanix_disk_storage_freeFree Storage of the Disk
Disk Storage Usagenutanix_disk_storage_usageUsed Storage of the Disk
nutanixDiskIo
Metric nameMetric keyDescription
Disk IOPSnutanix_disk_io_iopsIOPS Count of the Disk
Disk Read IOPSnutanix_disk_io_read_iopsRead IOPS Count of the Disk
Disk Write IOPSnutanix_disk_io_write_iopsWrite IOPS Count of the Disk
Disk Latencynutanix_disk_io_latencyLatency of the Disk
Disk I/O Bandwidthnutanix_disk_io_bandwidthDisk I/O Bandwidth
Disk I/O Read Bandwidthnutanix_disk_io_read_bandwidthDisk I/O Read Bandwidth
Disk I/O Write Bandwidthnutanix_disk_io_write_bandwidthDisk I/O Write Bandwidth
Disk Read I/O %nutanix_disk_read_io_percentPercentage of read I/O for a disk
Disk Write I/O %nutanix_disk_write_io_percentPercentage of write I/O for a disk
nutanixPoolIo
Metric nameMetric keyDescription
Storage Container Controller IOPSnutanix_pool_io_controller_iopsController IOPS Count
Storage Container Controller Read IOPSnutanix_pool_io_controller_read_iopsController Read IOPS Count
Storage Container Controller Write IOPSnutanix_pool_io_controller_write_iopsController Write IOPS Count
Storage Container Controller Latencynutanix_pool_io_controller_latencyController Latency
Storage Container Controller Read Latencynutanix_pool_io_controller_read_latencyController Read Latency
Storage Container Controller Write Latencynutanix_pool_io_controller_write_latencyController Write Latency
Storage Container Controller I/O Bandwidthnutanix_pool_io_controller_bandwidthController I/O Bandwidth
Storage Container Controller Read I/O Bandwidthnutanix_pool_io_controller_read_bandwidthController Read I/O Bandwidth
Storage Container Controller Write I/O Bandwidthnutanix_pool_io_controller_write_bandwidthController Write I/O Bandwidth
nutanixClusterIo
Metric nameMetric keyDescription
Cluster I/O Bandwidthnutanix_cluster_io_bandwidthController I/O bandwidth in cluster in kilobytes per second
nutanixVmControllerStorage
Metric nameMetric keyDescription
VM Controller Storage IOPSnutanix_vm_controller_storage_iopsController Storage IOPS by Virtual Machine
VM Controller Storage Read IOPSnutanix_vm_controller_storage_read_iopsController Storage Read IOPS by Virtual Machine
VM Controller Storage Write IOPSnutanix_vm_controller_storage_write_iopsController Storage Write IOPS by Virtual Machine
VM Controller Storage Latencynutanix_vm_controller_storage_latencyController Storage Latency by Virtual Machine
VM Controller Storage Read Latencynutanix_vm_controller_storage_read_latencyController Storage Read Latency by Virtual Machine
VM Controller Storage Write Latencynutanix_vm_controller_storage_write_latencyController Storage Write Latency by Virtual Machine
VM Controller Storage I/O Bandwidthnutanix_vm_controller_storage_io_bandwidthController Storage Bandwidth by Virtual Machine
VM Controller Storage Read Bandwidthnutanix_vm_controller_storage_read_bandwidthController Storage Read Bandwidth by Virtual Machine
VM Controller Storage Write Bandwidthnutanix_vm_controller_storage_write_bandwidthController Storage Write Bandwidth by Virtual Machine
nutanixVirtualDiskStats
Metric nameMetric keyDescription
Virtual Disk Usagenutanix_virtual_disk_usageUsage of the virtual disk in bytes
Virtual Disk Capacitynutanix_virtual_disk_capacityCapacity of the virtual disk in bytes
nutanixVmStats
Metric nameMetric keyDescription
VM CPU Usage %nutanix_vm_cpu_usage_percentPercentage of CPU usage for Virtual Machine
VM Memory Capacitynutanix_vm_memory_capacity_bytesMemory capacity in bytes given to Virtual Machine
VM Memory Usagenutanix_vm_memory_usage_percentVirtual Machine memory utilization
VM Alertlog.nutanix_vm_alertCount of alerts generated by VM
VM Eventlog.nutanix_vm_eventCount of events generated by VM
nutanixHostController
Metric nameMetric keyDescription
Host Controller Storage IOPSnutanix_host_controller_storage_iopsController Storage IOPS Count for the Host
Host Controller Storage Read IOPSnutanix_host_controller_storage_read_iopsController Storage Read IOPS Count for the Host
Host Controller Storage Write IOPSnutanix_host_controller_storage_write_iopsController Storage Write IOPS Count for the host
Host Controller Storage Latencynutanix_host_controller_storage_latencyController Storage Latency for the Host
Host Controller Storage Read Latencynutanix_host_controller_storage_read_latencyController Storage Read Latency for the Host
Host Controller Storage Write Latencynutanix_host_controller_storage_write_latencyController Storage Write Latency for the Host
Host Controller Storage Read I/O Bandwidthnutanix_host_controller_storage_read_io_bandwidthStorage controller Read Bandwiidth for the Host
Host Controller Storage Write I/O Bandwidthnutanix_host_controller_storage_write_io_bandwidthStorage controller Write Bandwiidth for the Host
nutanixPoolStats
Metric nameMetric keyDescription
Storage Container Alertlog.nutanix_pool_alertAlert on a Nutanix Storage Container
Storage Container Eventlog.nutanix_pool_eventEvent on a Nutanix Storage Container
nutanixHostIo
Metric nameMetric keyDescription
Host I/O Bandwidthnutanix_host_io_bandwidth_kBpsAverage I/O bandwidth of all disks on host in kBps
nutanixVmHypervisor
Metric nameMetric keyDescription
VM Hypervisor I/O Latencynutanix_vm_hypervisor_io_latencyHypervisor I/O Latency for Virtual Machine
VM Hypervisor CPU Ready Time %nutanix_vm_hypervisor_cpu_ready_time_percentPercentage of Hypervisor CPU Ready Time
VM Hypervisor CPU Usage %nutanix_vm_hypervisor_cpu_usage_percentPercentage of Hypervisor CPU Usage

FAQ

My Nutanix environment doesn't support Nutanix API V4 yet. How can I monitor Nutanix clusters?

Use Nutanix extension version 2.x, which supports API v1 and v2 and doesn’t require API v4. Activate the latest 2.x version from the Hub. It remains supported until Nutanix ends support for API v1 and v2, expected in Q4 2026.

To monitor clusters with the 2.x extension, create a user account with the same credentials in Prism Central and all managed Prism Element clusters. This account must have the Cluster Admin role or equivalent API access.

Is the Access Token required to run the extension?

No, the Access Token is only required to import alerts and events. It allows Dynatrace to configure alerts automatically.

Generate the token via Menu > Access Tokens and enter it in the configuration field. If you don’t need alerts/events, disable those options. Leaving them enabled without a token will invalidate the configuration.

I see data gaps when running the extension and/or Prism Central becomes overloaded. What should I do?

This may happen if too many metrics are configured, causing Prism Central API bottlenecks.

Try splitting configurations with filters and distributing them across multiple ActiveGates. Monitor Prism Central’s load closely—too many ActiveGates can overwhelm it.

In large environments, ensure Prism Central runs on a machine with enough capacity to handle API calls for all monitored entities, which may number in the tens of thousands.

Related tags
VirtualizationPythonHypervisorNutanixInfrastructure Observability