Nutanix

Introduction

Nutanix is a leading provider of hyperconverged infrastructure (HCI) solutions, designed to simplify and modernize data centers. With Nutanix, organizations can seamlessly manage compute, storage, and networking resources through a single, unified platform. The software integrates seamlessly with public cloud services, offering a hybrid cloud experience that ensures scalability and flexibility. Whether used for virtualized workloads, databases, or enterprise applications, Nutanix delivers high performance, resilience, and simplicity. The platform’s robust management tools and automation capabilities reduce operational complexity, empowering IT teams to focus on innovation and strategic initiatives.

Getting Started

Compatibility

vuSmartMaps supports monitoring of your Nutanix cluster, the plugin has been tested for version Nutanix Prism API v2.

Data Collection Method

vuSmartmaps collects health and performance data for given Nutanix cluster using our internal data collector agent. The metrics are fetched using the Nutanix Prism API.

Prerequisites

Inputs for Configuring Data Source

• Data Source Name: Data source name to uniquely identify the source.
• Username: Username to be used for API endpoint
• Password: Password to be used for API endpoint
• Host: Host IP of the machine where the Nutanix Metric API is running
• Port: Port of the machine where the Nutanix Metric API is running
• Polling Frequency: Specifies the interval in seconds at which data is collected. Data collection occurs once every specified period.

Firewall Requirement

To collect data from this O11ySource, ensure the following ports are opened:

Source IP	Destination IP	Destination Port	Protocol	Direction
IP address(es) of the vuSmartmaps Server	Nutanix API Endpoint	Nutanix API Endpoint Port (Configurable by User)	TCP	Outbound

*Before providing the firewall requirements, please update the port based on the customer environment.

Configuring the Target

• Enable Nutanix Prism Services: Ensure that your Nutanix environment is configured to collect and report health and performance metrics. Nutanix Prism Central (PC) or Prism Element (PE) must be properly configured and accessible.
• Enable Detailed Metrics: Ensure that detailed metrics collection is enabled in your Nutanix Prism settings to get granular data on resources and methods.
• Configure Nutanix Prism APIs: Nutanix Prism APIs should be configured and accessible. Make sure you have the API endpoints and authentication details (username and password or API token).
• Assign Necessary Permissions: Ensure that the user or role accessing the Nutanix Prism API has the necessary permissions. Below are the specific API calls and the required permissions:

Configuration Steps

• Enable the Nutanix O11ySource.
• Enable the Nutanix O11ySource.
• Select the Sources tab and press the + button to add a new instance of the service to be monitored.
• Populate all the configurations.
• Click on Save and Continue to create the instance.

Metrics Collected

Name	Description	Data Type
Timestamp	Time at which the data was collected	DateTime64
Cluster Incarnation ID	Unique ID for the cluster incarnation	Int64
Cluster UUID	Unique identifier for the cluster	String
Name	Name of the cluster	String
Cluster External IP Address	IP address for external cluster communication	String
Is NS Enabled	Indicates if NS is enabled	Int64
Cluster External Data Services IP Address	IP address for external data services	String
Timezone	Time zone of the cluster	String
Operational Mode	Operational mode of the cluster	String
Encrypted	Indicates if the data is encrypted	Int64
Storage Type	Type of storage used in the cluster	String
Version	Version of the cluster software	String
Number of Nodes	Total number of nodes in the cluster	Int64
Full Version	Complete version information	String
Multicluster	Indicates if it is a multicluster setup	Int64
Cloud Cluster	Indicates if the cluster is cloud-based	Int64
Has Self Encrypting Drive	Indicates if self-encrypting drives are used	Int64
Cluster Architecture	Architecture of the cluster	String
Hypervisor Avg IO Latency Usecs	Average IO latency in microseconds	Int64
Number of Read IOPS	Number of read IOPS	Int64
Hypervisor Write IO Bandwidth kBps	Write IO bandwidth in kBps	Int64
Timespan Usecs	Time span in microseconds	Int64
Controller Number of Read IOPS	Number of read IOPS for controller	Int64
Read IO PPM	Read IO in parts per million	Int64
Controller Number of IOPS	Total number of IOPS for controller	Int64
Total Read IO Time Usecs	Total read IO time in microseconds	Int64
Controller Total Read IO Time Usecs	Controller total read IO time in microseconds	Int64
Replication Transmitted Bandwidth kBps	Replication transmitted bandwidth in kBps	Int64
Hypervisor Number of IO	Total number of IO operations for hypervisor	Int64
Controller Total Transformed Usage Bytes	Total transformed usage in bytes	Int64
Hypervisor CPU Usage PPM	CPU usage in parts per million	Int64
Controller Number of Write IO	Number of write IO for controller	Int64
Average Read IO Latency Usecs	Average read IO latency in microseconds	Int64
Content Cache Logical SSD Usage Bytes	Logical SSD usage in content cache	Int64
Controller Total IO Time Usecs	Total IO time for controller in microseconds	Int64
Controller Total Read IO Size kBytes	Total read IO size in kilobytes	Int64
Controller Number of Sequential IO	Number of sequential IO for controller	Int64
Controller Read IO PPM	Read IO in parts per million for controller	Int64
Content Cache Number of Lookups	Number of lookups in content cache	Int64
Controller Total IO Size kBytes	Total IO size for controller in kilobytes	Int64
Content Cache Hit PPM	Content cache hit rate in parts per million	Int64
Controller Number of IO	Total number of IO operations for controller	Int64
Hypervisor Average Read IO Latency Usecs	Hypervisor average read IO latency in microseconds	Int64
Content Cache Dedup Reference Count PPH	Content cache deduplication reference count per hour	Int64
Number of Write IOPS	Number of write IOPS	Int64
Controller Number of Random IO	Number of random IO operations for controller	Int64
Number of IOPS	Total number of IOPS	Int64
Replication Received Bandwidth kBps	Replication received bandwidth in kBps	Int64
Hypervisor Number of Read IO	Total number of read IO operations for hypervisor	Int64
Hypervisor Total Read IO Time Usecs	Total read IO time for hypervisor in microseconds	Int64
Controller Average IO Latency Usecs	Average IO latency for controller in microseconds	Int64
Hypervisor HyperV CPU Usage PPM	HyperV CPU usage in parts per million	Int64
Number of IO	Total number of IO operations	Int64
Controller Number of Read IO	Number of read IO operations for controller	Int64
Hypervisor Number of Write IO	Number of write IO operations for hypervisor	Int64
Controller Sequential IO PPM	Sequential IO in parts per million for controller	Int64
Controller Read IO Bandwidth kBps	Read IO bandwidth for controller in kBps	Int64
Controller IO Bandwidth kBps	Total IO bandwidth for controller in kBps	Int64
Hypervisor HyperV Memory Usage PPM	HyperV memory usage in parts per million	Int64
Hypervisor Timespan Usecs	Timespan for hypervisor in microseconds	Int64
Hypervisor Number of Write IOPS	Number of write IOPS for hypervisor	Int64
Replication Number of Transmitted Bytes	Number of transmitted bytes for replication	Int64
Total Read IO Size kBytes	Total read IO size in kilobytes	Int64
Hypervisor Total IO Size kBytes	Total IO size for hypervisor in kilobytes	Int64
Average IO Latency Usecs	Average IO latency in microseconds	Int64
Hypervisor Number of Read IOPS	Number of read IOPS for hypervisor	Int64
Content Cache Saved SSD Usage Bytes	Saved SSD usage in content cache	Int64
Controller Write IO Bandwidth kBps	Write IO bandwidth for controller in kBps	Int64
Controller Write IO PPM	Write IO in parts per million for controller	Int64
Hypervisor Average Write IO Latency Usecs	Hypervisor average write IO latency in microseconds	Int64
Hypervisor Total Read IO Size kBytes	Total read IO size for hypervisor in kilobytes	Int64
Read IO Bandwidth kBps	Read IO bandwidth in kBps	Int64
Hypervisor ESX Memory Usage PPM	ESX memory usage in parts per million	Int64
Hypervisor Memory Usage PPM	Total memory usage for hypervisor in parts per million	Int64
Hypervisor Number of IOPS	Total number of IOPS for hypervisor	Int64
Hypervisor IO Bandwidth kBps	Total IO bandwidth for hypervisor in kBps	Int64
Controller Number of Write IOPS	Number of write IOPS for controller	Int64
Total IO Time Usecs	Total IO time in microseconds	Int64
Hypervisor KVM CPU Usage PPM	KVM CPU usage in parts per million	Int64
Content Cache Physical SSD Usage Bytes	Physical SSD usage in content cache	Int64
Controller Random IO PPM	Random IO in parts per million for controller	Int64
Controller Average Read IO Size kBytes	Average read IO size for controller in kilobytes	Int64
Total Transformed Usage Bytes	Total transformed usage in bytes	Int64
Average Write IO Latency Usecs	Average write IO latency in microseconds	Int64
Number of Read IO	Total number of read IO operations	Int64
Write IO Bandwidth kBps	Write IO bandwidth in kBps	Int64
Hypervisor Read IO Bandwidth kBps	Read IO bandwidth for hypervisor in kBps	Int64
Random IO PPM	Random IO in parts per million	Int64
Content Cache Number of Hits	Number of hits in content cache	Int64
Total Untransformed Usage Bytes	Total untransformed usage in bytes	Int64
Hypervisor Total IO Time Usecs	Total IO time for hypervisor in microseconds	Int64
Number of Random IO	Total number of random IO operations	Int64
Hypervisor KVM Memory Usage PPM	KVM memory usage in parts per million	Int64
Controller Average Write IO Size kBytes	Average write IO size for controller in kilobytes	Int64
Controller Average Read IO Latency Usecs	Average read IO latency for controller in microseconds	Int64
Number of Write IO	Total number of write IO operations	Int64
Hypervisor ESX CPU Usage PPM	ESX CPU usage in parts per million	Int64
Total IO Size kBytes	Total IO size in kilobytes	Int64
IO Bandwidth kBps	Total IO bandwidth in kBps	Int64
Content Cache Physical Memory Usage Bytes	Physical memory usage in content cache	Int64
Replication Number of Received Bytes	Number of received bytes for replication	Int64
Controller Timespan Usecs	Timespan for controller in microseconds	Int64
Number of Sequential IO	Number of sequential IO operations	Int64
Content Cache Saved Memory Usage Bytes	Saved memory usage in content cache	Int64
Sequential IO PPM	Sequential IO in parts per million	Int64
Write IO PPM	Write IO in parts per million	Int64
Controller Average Write IO Latency Usecs	Average write IO latency for controller in microseconds	Int64
Content Cache Logical Memory Usage Bytes	Logical memory usage in content cache	Int64
Data Reduction Overall Saving Ratio PPM	Overall data reduction saving ratio in parts per million	Int64
Storage Reserved Free Bytes	Reserved free storage in bytes	Int64
Storage Tier DAS SATA Usage Bytes	Usage in DAS SATA tier storage	Int64
Data Reduction Compression Saved Bytes	Saved bytes from compression data reduction	Int64
Data Reduction Saving Ratio PPM	Overall data reduction saving ratio in parts per million	Int64
Data Reduction Erasure Coding Post Reduction Bytes	Saved bytes after erasure coding	Int64
Storage Tier SSD Pinned Usage Bytes	Usage in pinned SSD tier storage	Int64
Storage Reserved Usage Bytes	Reserved storage usage in bytes	Int64
Data Reduction Erasure Coding Saving Ratio PPM	Erasure coding saving ratio in parts per million	Int64
Data Reduction Thin Provision Saved Bytes	Saved bytes from thin provisioning	Int64
Storage Tier DAS SATA Capacity Bytes	Capacity in DAS SATA tier storage	Int64
Storage Tier DAS SATA Free Bytes	Free storage in DAS SATA tier	Int64
Storage Usage Bytes	Total storage usage in bytes	Int64
Data Reduction Erasure Coding Saved Bytes	Total saved bytes from erasure coding	Int64
Storage Recycle Bin Usage Bytes	Usage in recycle bin	Int64
Data Reduction Compression Pre Reduction Bytes	Compression pre-reduction saved bytes	Int64
Storage Rebuild Capacity Bytes	Rebuild capacity in bytes	Int64
Storage Tier DAS SATA Pinned Usage Bytes	Pinned usage in DAS SATA tier storage	Int64
Data Reduction Pre Reduction Bytes	Total pre-reduction saved bytes	Int64
Storage Tier SSD Capacity Bytes	Capacity in SSD tier storage	Int64
Data Reduction Clone Saved Bytes	Saved bytes from data cloning	Int64
Storage Tier SSD Free Bytes	Free storage in SSD tier	Int64
Data Reduction Dedup Pre Reduction Bytes	Pre-reduction saved bytes from deduplication	Int64
Data Reduction Erasure Coding Pre Reduction Bytes	Pre-reduction saved bytes from erasure coding	Int64
Storage Capacity Bytes	Total storage capacity in bytes	Int64
Data Reduction Dedup Post Reduction Bytes	Post-reduction saved bytes from deduplication	Int64
Storage Snapshot Reclaimable Bytes	Reclaimable bytes from storage snapshots	Int64
Data Reduction Clone Saving Ratio PPM	Clone saving ratio in parts per million	Int64
Storage Logical Usage Bytes	Logical storage usage in bytes	Int64
Data Reduction Saved Bytes	Total saved bytes from data reduction	Int64
Storage Free Bytes	Total free storage in bytes	Int64
Storage Tier SSD Usage Bytes	Usage in SSD tier storage	Int64
Data Reduction Compression Post Reduction Bytes	Post-reduction saved bytes from compression	Int64
Data Reduction Post Reduction Bytes	Total post-reduction saved bytes	Int64
Data Reduction Dedup Saved Bytes	Total saved bytes from deduplication	Int64
Data Reduction Overall Saved Bytes	Total overall saved bytes from data reduction	Int64
Data Reduction Thin Provision Post Reduction Bytes	Post-reduction saved bytes from thin provisioning	Int64
Data Reduction Thin Provision Saving Ratio PPM	Thin provisioning saving ratio in parts per million	Int64
Data Reduction Compression Saving Ratio PPM	Compression saving ratio in parts per million	Int64
Data Reduction Dedup Saving Ratio PPM	Deduplication saving ratio in parts per million	Int64
Storage Reserved Capacity Bytes	Reserved storage capacity in bytes	Int64
Data Reduction Thin Provision Pre Reduction Bytes	Pre-reduction saved bytes from thin provisioning	Int64