Skip to main content
Active IQ Unified Manager 9.9
9.9
A newer release of this product is available.

Viewing performance metrics

Contributors

Active IQ Unified Manager provides you with a set of APIs under the /datacenter category that enable you to view the performance data of your clusters and storage objects in a data center. These APIs retrieve the performance data of the different storage objects, such as clusters, nodes, LUNs, volumes, aggregates, and storage VMs.

The /metrics and /analytics APIs give different views of the performance metrics, using which, you can drill down to different levels of details for the following storage objects in your data center:

  • clusters

  • nodes

  • storage VMs

  • aggregates

  • volumes

  • LUNs

The following table draws a comparison between the /metrics and /analytics APIs with respect to the particulars of the performance data retrieved.

Metrics Analytics

Performance details for a single object. For example, the /datacenter/cluster/clusters/{key}/metrics API requires the cluster key to be entered as the path parameter for retrieving the metrics for that specific cluster.

Performance details for multiple objects of the same type in a data center. For example, the /datacenter/cluster/clusters/analytics API retrieves the collective metrics of all the clusters in a data center.

Performance metrics sample for a storage object based on the time interval parameter for retrieval.

High-level aggregated value of performance for a certain type of storage object for a certain period (above 72 hours).

Basic details of the object are retrieved, such as details of a node or cluster.

No specific details are retrieved.

Accumulated counters, such as, minimum, maximum, and the average performance values over a period of time are retrieved for a single object, such as, read, write, total, and other counters. For example, the /datacenter/cluster/nodes/{key}/metrics API retrieves the following details (among others) for a node :

 {
      "iops": {
        "local": {
          "others": 100.53,
          "read": 100.53,
          "total": 100.53,
          "write": 100.53
        },
        "others": 100.53,
        "read": 100.53,
        "total": 100.53,
        "write": 100.53
      },
      "latency": {
        "others": 100.53,
        "read": 100.53,
        "total": 100.53,
        "write": 100.53
      },
      "performance_capacity": {
        "available_iops_percent": 0,
        "free_percent": 0,
        "system_workload_percent": 0,
        "used_percent": 0,
        "user_workload_percent": 0
      },
      "throughput": {
        "other": 100.53,
        "read": 100.53,
        "total": 100.53,
        "write": 100.53
      },

A single aggregated value is displayed for all the objects of the same type. For example, the /datacenter/cluster/nodes/analytics API retrieves the following values (among others) for all the nodes:

 {
      "iops": 2757.5723,
      "latency": 0.8266,
      "throughput": 13254.6992,
      "utilization_percent": 58.6488,
      "period": 72,
      "performance_capacity": {
        "used_percent": 63.5317,
        "available_iops_percent": 60731.3086
      },

The time range and sample data is based on the following schedule:The time range for the data. Examples can be 1h, 12h, 1d, 2d, 3d, 15d, 1w, 1m, 2m, 3m, 6m. You get 1 hour samples if the range is more than 3 days (72 hr) else it is 5 minutes samples. The period for each time range is as follows:

  • 1h: Metrics over the most recent hour sampled over 5 minutes.

  • 12h: Metrics over the most recent 12 hours sampled over 5 minutes.

  • 1d: Metrics over the most recent day sampled over 5 minutes.

  • 2d: Metrics over the most recent 2 days sampled over 5 minutes.

  • 3d: Metrics over the most recent 3 days sampled over 5 minutes.

  • 15d: Metrics over the most recent 15 days sampled over 1 hour.

  • 1w: Metrics over the most recent week sampled over 1 hour.

  • 1m: Metrics over the most recent month sampled over 1 hour.

  • 2m: Metrics over the most recent 2 months sampled over 1 hour.

  • 3m: Metrics over the most recent 3 months sampled over 1 hour.

  • 6m: Metrics over the most recent 6 months sampled over 1 hour.

Available values : 1h, 12h, 1d, 2d, 3d, 15d, 1w, 1m, 2m, 3m, 6m

Default value : 1h

Above 72 hours, that is 3 days. The duration over which this sample is calculated are represented in the ISO-8601 standard format.

The following table describes the /metrics and /analytics APIs in details.

Note

The IOPS and performance metrics returned by these APIs are double values, for example 100.53. Filtering these float values by the pipe (|) and wildcard (*) characters is not supported.

HTTP Verb Path Description

GET

/datacenter/cluster/clusters/{key}/metrics

Retrieves performance data (sample and summary) for a cluster specified by the input parameter of the cluster key. Information, such as the cluster key and UUID, time range, IOPS, throughput, and number of samples is returned.

GET

/datacenter/cluster/clusters/analytics

Retrieves high-level performance metrics for all the clusters in a data center. You can filter your results based on the required criteria. Values, such as aggregated IOPS, throughput, and the period of collection (in hours) are returned.

GET

/datacenter/cluster/nodes/{key}/metrics

Retrieves performance data (sample and summary) for a node specified by the input parameter of the node key. Information, such as the node UUID, time range, summary of the IOPS, throughput, latency, and performance, the number of samples collected, and percentage utilized is returned.

GET

/datacenter/cluster/nodes/analytics

Retrieves high-level performance metrics for all the nodes in a data center. You can filter your results based on the required criteria. Information, such as node and cluster keys, and values, such as aggregated IOPS, throughput, and the period of collection (in hours) are returned.

GET

/datacenter/storage/aggregates/{key}/metrics

Retrieves performance data (sample and summary) for an aggregate specified by the input parameter of the aggregate key. Information, such as the time range, summary of the IOPS, latency, throughput, and performance capacity, the number of samples collected for each counter, and percentage utilized is returned.

GET

/datacenter/storage/aggregates/analytics

Retrieves high-level performance metrics for all the aggregates in a data center. You can filter your results based on the required criteria. Information, such as aggregate and cluster keys, and values, such as aggregated IOPS, throughput, and the period of collection (in hours) are returned.

GET

/datacenter/storage/luns/{key}/metrics

/datacenter/storage/volumes/{key}/metrics

Retrieves performance data (sample and summary) for a LUN or a file share (volume) specified by the input parameter of the LUN or volume key. Information, such as the summary of the minimum, maximum, and average of the read, write, and total IOPS, latency, and throughput, and the number of samples collected for each counter is returned.

GET

/datacenter/storage/luns/analytics

/datacenter/storage/volumes/analytics

Retrieves high-level performance metrics for all the LUNs or volumes in a data center. You can filter your results based on the required criteria. Information, such as storage VM and cluster keys, and values, such as aggregated IOPS, throughput, and the period of collection (in hours) are returned.

GET

/datacenter/svm/svms/{key}/metrics

Retrieves performance data (sample and summary) for a storage VM specified by the input parameter of the storage VM key. Summary of the IOPS based on each supported protocol, such as nvmf, fcp, iscsi, and nfs, throughput, latency, and the number of samples collected are returned.

GET

/datacenter/svm/svms/analytics

Retrieves high-level performance metrics for all the storage VMs in a data center. You can filter your results based on the required criteria. Information, such as storage VM UUID, aggregated IOPS, latency, throughput, and the period of collection (in hours) are returned.

GET

/datacenter/cluster/licensing/licenses /datacenter/cluster/licensing/licenses/{key}

Returns the details of the licenses installed on the clusters in your data center. You can filter your results based on the required criteria. Information, such as the license key, cluster key, expiry date, and license scope is returned.You can enter a license key to retrieve the details of a specific license.