Viewing performance metrics
Suggest changes
PDFs
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 |
Performance details for multiple objects of the same type in a data center. For example, the |
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 {
"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 {
"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:
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.
|
The IOPS and performance metrics returned by these APIs are double values, for example |
| HTTP Verb | Path | Description |
|---|---|---|
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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 |
|
|
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. |
|
|
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. |