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

  1. From All Clients, select a client.

  2. Go to Setup > Integrations > Integrations.

  3. 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.

  1. 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.

  2. Click Install. The Integration page displays the installed integration.

Configure the integration

  1. In CONFIGURATION section, click + Add.

  2. 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.

  3. In the Credential section, select Custom and enter the Username and Password.

  4. In the Resource Types & Metrics section, select the metrics you want and configure for availability and alert conditions.

  5. In the Discovery Schedule section, select Recurrence Pattern to add one of the following patterns:

    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly

  6. In the Monitoring Schedule section, configure how frequently the monitoring action should trigger.

  1. 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 NameMetric Display NameUnits
netapp_cluster_system_TotalSize

The total storage capacity for this cluster
NetApp Cluster System Total SizeGB
netapp_cluster_system_SizeAvailable

System Available size
Netapp Cluster System Size AvailableGB
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 IopsReq per Sec
netapp_cluster_ThroughPut

Average number of megabytes of data transferred to and from this cluster per second.
NetApp Cluster ThroughPutBps
netapp_node_Latency

The average response time for all I/O requests, expressed in milliseconds per operation.
NetApp Node Latencycount
netapp_node_ThroughPut

The throughput on the node, measured in megabytes per second.
NetApp Node ThroughPutBps
netapp_node_Iops

The average input/output operations per second on the node.
NetApp Node IopsReq per Sec
netapp_aggregate_SizeTotal

Total usable space not including WAFL reserve and aggregate Snapshot copy reserve
NetApp Cluster Aggregate Size TotalGB
netapp_aggregate_SizeAvailable

Space available on the Aggregate
NetApp Cluster Aggregate Size AvailableGB
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 IopsReq per Sec
netapp_aggregate_ThroughPut

The throughput on the aggregates, measured in megabytes per second.
NetApp Aggregate ThroughPutBps
netapp_aggregate_Latency

The average response time for all I/O requests, expressed in milliseconds per operation.
NetApp Aggregate Latencycount
netapp_vserver_Latency

The average response time for all I/O requests, expressed in milliseconds per operation.
NetApp Vserver Latencycount
netapp_vserver_Iops

The input/output operations per second for the SVM.
NetApp Vserver IopsReq per Sec
netapp_vserver_ThroughPut

The throughput on the SVM, measured in megabytes per second.
NetApp Vserver ThroughPutBps
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 TotalGB
netapp_volume_SizeAvailable

The available space in volume, in bytes.
NetApp Cluster Volume Size AvailableGB
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 ThroughPutBps
netapp_volume_Iops

The input/output operations per second for the volumes.
NetApp Volume IopsReq 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 TotalGB
netapp_lun_SizeAvailable

The available storage capacity for this LUNs, in gigabytes.
NetApp LUN Available SizeGB
netapp_lun_SizePercentageUsed

LUN Utilization
NetApp Cluster LUN Utilization%
netapp_lun_Iops

The input/output operations per second for the LUNs.
NetApp LUN IopsReq per Sec
netapp_lun_Latency

The average response time for all I/O requests, expressed in milliseconds per operation.
NetApp Lun Latencycount
netapp_lun_ThroughPut

The throughput on the LUN, measured in megabytes per second.
NetApp Lun ThroughPutBps
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