Supported Versions |
---|
Active IQ Unified Manager 9.9 |
Introduction
NetApp Active IQ Unified Manager
NetApp® OnCommand® Unified Manager is a graphical management product that provides comprehensive monitoring and key management capabilities for NetApp ONTAP® systems to help manage the availability, capacity, protection, and performance risks of your storage systems.
You can deploy Unified Manager on a Linux server, on a Windows server, or as a virtual appliance on a VMware host.
Storage resources in a 2-node cluster:

Physical storage resources
Refers to the physical storage objects provided by ONTAP. Physical storage resources include disks, clusters, storage controllers, nodes, and aggregates.
Logical storage resources
Refers to the storage resources provided by ONTAP that are not tied to a physical resource. These resources are associated with a storage virtual machine (SVM, formerly known as Vserver), and they exist independently of any specific physical storage resource such as a disk, array LUN, or aggregate.
Cluster
A cluster consists of one or more nodes grouped together as (HA pairs) to form a scalable cluster. Creating a cluster enables the nodes to pool their resources and distribute work across the cluster, while presenting administrators with a single entity to manage. Clustering also enables continuous service to end users if individual nodes go offline.
Node
A node is a controller in a cluster. It is connected to other nodes in the cluster over a private management cluster network. It is also connected to the disk shelves that provide physical storage for the Data ONTAP system or to third-party storage arrays that provide array LUNs for Data ONTAP use.
Volume
Volumes are data containers that enable you to partition and manage your data. Understanding the types of volumes and their associated capabilities enables you to design your storage architecture for maximum storage efficiency and ease of administration.
Volumes are the highest-level logical storage object. Unlike aggregates, which are composed of physical storage resources, volumes are completely logical objects.
Aggregate
An aggregate is a collection of disks (or partitions) arranged into one or more RAID groups. It is the most basic storage object within ONTAP and is required to allow for the provisioning of space for connected hosts.
SVM
Storage Virtual Machines (SVMs) contain data volumes and one or more LIFs (logical interfaces) through which they serve data to the clients.
A cluster can have one or more SVMs with FlexVol volumes and SVMs with Infinite Volume.
Namespace
A namespace is a logical grouping of volumes that are joined together at junction points to create a single, logical file system that derives from the Storage Virtual Machine (SVM) root volume. Each SVM has a namespace.
Prerequisites
Software: Active IQ Unified manager 9.9 - Available
Install the integration
From All Clients, select a client.
Go to Setup > Integrations > Integrations.
From Available Integrations, select Adapter > NetApp Active IQ Unified Manager. The Install NetApp Active IQ Unified Manager Integration popup appears.
Note: Ensure that Adapter addon is enabled at client and partner levels.

Enter the following information:
a. Name: Name of the integration
b. Upload Logo: Optional logo for the integration.
c. GateWay Profiles: Select a gateway management profile to associate with the client.Click Install. The Integration page displays the installed integration.

Configure the integration
In CONFIGURATION section, click + Add.
On Create Adapter Configuration, enter:
- Name: Configuration name.
- Protocol: Protocol
- HostName/IP Address: IP address or host name of the target.
- Port: Port
- Alert Configuration: Configure the alerts based on your requirements.
Default configuration:
{"alertFilters":{"alertStates":["new","obsolete","acknowledged","resolved"],"alertOnRootResource":true},"alertStateSeverityMapping":[{"new":{"critical":"Critical","error":"Critical","warning":"Warning","information":"Info","normal":"Info"}},{"acknowledged":{"critical":"Critical","error":"Critical","warning":"Warning","information":"Info","normal":"Info"}},{"obsolete":{"critical":"Ok","error":"Ok","warning":"Ok","information":"Ok","normal":"Ok"}},{"resolved":{"critical":"Ok","error":"Ok","warning":"Ok","information":"Ok","normal":"Ok"}}]}
You can add/change alert state/severity mapping accordingly.
- Events Polling: Select the appropriate option. If you select TRUE, events polling is done.
- Notification Alerts: Select TRUE or FALSE.
In the Credential section, select Custom and enter the Username and Password.
In the Resource Types & Metrics section, select the metrics you want and configure for availability and alert conditions.
In the Discovery Schedule section, select Recurrence Pattern to add one of the following patterns:
- Minutes
- Hourly
- Daily
- Weekly
- Monthly
In the Monitoring Schedule section, configure how frequently the monitoring action should trigger.

- Click Save.
After saving the integration, NetApp storage resources are discovered and monitoring is enabled as specified by the configuration profile.
The configuration is saved and displayed on the page.

You can perform the actions manually, like Discovery, Monitoring or even Disable the configuration.
The discovered resource(s) are displayed in the Infrastructure page under
Storage > NetApp Active IQ Unified Manager, with Resource Type as Storage.

NetApp Cluster (Resource Type) is displayed under Components:

View resource metrics
To confirm NetApp Active IQ monitoring, review the following:
- Metric graphs: A graph is plotted for each metric that is enabled in the configuration.
- Alerts: Alerts are generated for metrics that are configured as defined for integration.

Hierarchy of NetApp Active IQ resources:
NETAPP (Storage)
— Cluster( NetApp Cluster)
— Node(STORAGE_ARRAY_CLUSTER_NODE)
— Aggregates(STORAGE_ARRAY_POOL)
— SVMs(STORAGE_ARRAY_VSERVER)
— Volumes(STORAGE_ARRAY_VOLUME)
— LUNs(STORAGE_ARRAY_LUN)
Supported Metrics
Metric Name | Metric Display Name | Units |
---|---|---|
netapp_cluster_system_TotalSize The total storage capacity for this cluster | NetApp Cluster System Total Size | GB |
netapp_cluster_system_SizeAvailable System Available size | Netapp Cluster System Size Available | GB |
netapp_cluster_system_Utilization System Utilization | Netapp Cluster System Utilization | % |
netapp_cluster_Iops Average number of input/output operations the cluster processes per second. | NetApp Cluster Iops | Req per Sec |
netapp_cluster_ThroughPut Average number of megabytes of data transferred to and from this cluster per second. | NetApp Cluster ThroughPut | Bps |
netapp_node_Latency The average response time for all I/O requests, expressed in milliseconds per operation. | NetApp Node Latency | count |
netapp_node_ThroughPut The throughput on the node, measured in megabytes per second. | NetApp Node ThroughPut | Bps |
netapp_node_Iops The average input/output operations per second on the node. | NetApp Node Iops | Req per Sec |
netapp_aggregate_SizeTotal Total usable space not including WAFL reserve and aggregate Snapshot copy reserve | NetApp Cluster Aggregate Size Total | GB |
netapp_aggregate_SizeAvailable Space available on the Aggregate | NetApp Cluster Aggregate Size Available | GB |
netapp_aggregate_PercentUsedCapacity Percentage used Capacity of an Aggregate | NetApp Cluster Aggregate Percentage Used Capacity | % |
netapp_aggregate_Status The status of aggregate state. Possible Values: 0-unknown, 1-onlining, 2-online, 3-offline, 4-offlining, 5-relocating, 6-unmounted, 7-restricted, 8-inconsistent, 9-failed | NetApp Aggregate Status | |
netapp_aggregate_Iops The average input/output operations per second on the aggregates. | NetApp Aggregate Iops | Req per Sec |
netapp_aggregate_ThroughPut The throughput on the aggregates, measured in megabytes per second. | NetApp Aggregate ThroughPut | Bps |
netapp_aggregate_Latency The average response time for all I/O requests, expressed in milliseconds per operation. | NetApp Aggregate Latency | count |
netapp_vserver_Latency The average response time for all I/O requests, expressed in milliseconds per operation. | NetApp Vserver Latency | count |
netapp_vserver_Iops The input/output operations per second for the SVM. | NetApp Vserver Iops | Req per Sec |
netapp_vserver_ThroughPut The throughput on the SVM, measured in megabytes per second. | NetApp Vserver ThroughPut | Bps |
netapp_vserver_Status The status of cluster health. Possible Values: 0-starting, 1-running, 2-stopping, 3-stopped, 4-deleting | NetApp Vserver Status | |
netapp_volume_SizeTotal Total provisioned size. The default size is equal to the minimum size of 20MB, in bytes | NetApp Cluster Volume Size Total | GB |
netapp_volume_SizeAvailable The available space in volume, in bytes. | NetApp Cluster Volume Size Available | GB |
netapp_volume_PercentageSizeUsed Percentage of the volume size that is used. This field is valid only when the volume is online. | NetApp Cluster Volume Utilization | % |
netapp_volume_ThroughPut For FlexVol volumes, this is the throughput on the volume, measured in megabytes per second. For FlexGroup volumes, this is the sum of MBps for all constituent volumes. | NetApp Volume ThroughPut | Bps |
netapp_volume_Iops The input/output operations per second for the volumes. | NetApp Volume Iops | Req per Sec |
netapp_volume_Status The state of the volume that is being exported. Possible States: 0-offline, 1-online, 2-mixed, 3-error | NetApp Volume Status | |
netapp_lun_SizeTotal The total provisioned size of the LUN | NetApp Cluster LUN Size Total | GB |
netapp_lun_SizeAvailable The available storage capacity for this LUNs, in gigabytes. | NetApp LUN Available Size | GB |
netapp_lun_SizePercentageUsed LUN Utilization | NetApp Cluster LUN Utilization | % |
netapp_lun_Iops The input/output operations per second for the LUNs. | NetApp LUN Iops | Req per Sec |
netapp_lun_Latency The average response time for all I/O requests, expressed in milliseconds per operation. | NetApp Lun Latency | count |
netapp_lun_ThroughPut The throughput on the LUN, measured in megabytes per second. | NetApp Lun ThroughPut | Bps |
netapp_lun_Status The status of LUN health. Possible Values: 0-offline, 1-online | NetApp Lun Status |
Risks and Limitations
- App can handle below 3 different types of alerts:
- Connectivity Exception
- Authentication Exception
- Using metric for monitoring the resources and generate alerts when the threshold values are breached.
- App cannot control monitoring pause/resume actions based on the above alerts
- Discovery and Monitoring frequencies depend on the number of resources. If number of resources increase, then discovery and monitoring frequencies will also increase:
- For discovery, the recommended minimum frequency is 30 minutes for around 1500 resources
- Recommended minimum monitoring frequency is 10 minutes for around 1500 resources
References
NetApp-Active-IQ - version 9.9 (Sample responses from Swagger)
Swagger Link: https://library.netapp.com/ecmdocs/ECMLP2876865/html/index.html#/datacenter/metrics_svm_get_by_key