Skip to main content
Active IQ Unified Manager
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

使用 API 查看性能指标

PDF

Active IQ Unified Manager为您提供了一组 API `/datacenter`类别，使您能够查看数据中心中的集群和存储对象的性能数据。这些 API 检索不同存储对象的性能数据，例如集群、节点、LUN、卷、聚合、存储虚拟机、FC 接口、FC 端口、以太网端口和 IP 接口。

这 `/metrics`和 `/analytics`API 提供了性能指标的不同视图，使用这些视图，您可以深入了解数据中心中以下存储对象的不同级别的详细信息：

  • 集群

  • 节点

  • 存储虚拟机

  • 聚合

  • 卷

  • LUN

  • FC 接口

  • FC 端口

  • 以太网端口

  • IP 接口

下表对 `/metrics`和 `/analytics`与检索到的性能数据细节有关的 API。

指标 分析

单个对象的性能详细信息。例如， /datacenter/cluster/clusters/{key}/metrics API 要求输入集群键作为路径参数来检索该特定集群的指标。

数据中心内同一类型的多个对象的性能详细信息。例如， /datacenter/cluster/clusters/analytics API 检索数据中心中所有集群的集体指标。

根据检索的时间间隔参数对存储对象的性能指标进行采样。

某一类型存储对象在一定时期内（72 小时以上）的性能高级聚合值。

检索对象的基本详细信息，例如节点或集群的详细信息。

未检索到具体细节。

检索单个对象的累积计数器，例如最小值、最大值、第 95 个百分位数和一段时间内的平均性能值，例如读取、写入、总计和其他计数器。

对于同一类型的所有对象，将显示单个聚合值。

时间范围和样本数据基于以下时间表：数据的时间范围。例如 1h、12h、1d、2d、3d、15d、1w、1m、2m、3m、6m。如果范围超过 3 天（72 小时），您将获得 1 小时样本，否则您将获得 5 分钟样本。每个时间段的周期如下：

  • 1 小时：最近 5 分钟内采样的一小时内的指标。

  • 12h：最近 12 小时内每 5 分钟采样一次的指标。

  • 1d：最近一天 5 分钟内采样的指标。

  • 2d：最近 2 天的 5 分钟采样指标。

  • 3d：最近 3 天的 5 分钟采样指标。

  • 15d：最近 15 天的 1 小时内采样的指标。

  • 1w：最近一周内 1 小时内采样的指标。

  • 1m：最近一个月内 1 小时内采样的指标。

  • 2m：最近 2 个月内 1 小时内采样的指标。

  • 3m：最近 3 个月内 1 小时内采样的指标。

  • 6m：最近 6 个月内 1 小时内采样的指标。

    可用值：1h、12h、1d、2d、3d、15d、1w、1m、2m、3m、6m

    默认值：1h

超过72小时。计算此样本的持续时间以 ISO-8601 标准格式表示。

指标 API 的输出示例

例如， /datacenter/cluster/nodes/{key}/metrics API 检索节点的以下详细信息（以及其他信息）：

备注 摘要值中的 95 分位数表示该期间收集的 95% 样本的计数器值小于指定的 95 分位数。 
{
     "iops": {
       "local": {
         "other": 100.53,
         "read": 100.53,
         "total": 100.53,
         "write": 100.53
       },
       "other": 100.53,
       "read": 100.53,
       "total": 100.53,
       "write": 100.53
     },
     "latency": {
       "other": 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
     },
     "timestamp": "2018-01-01T12:00:00-04:00",
     "utilization_percent": 0
   }
 ],
 "start_time": "2018-01-01T12:00:00-04:00",
 "summary": {
   "iops": {
     "local_iops": {
       "other": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "read": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "total": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "write": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       }
     },

分析 API 的输出示例

例如， /datacenter/cluster/nodes/analytics API 检索所有节点的以下值（以及其他值）：

{     "iops": 1.7471,
     "latency": 60.0933,
     "throughput": 5548.4678,
     "utilization_percent": 4.8569,
     "period": 72,
     "performance_capacity": {
       "used_percent": 5.475,
       "available_iops_percent": 168350
     },
     "node": {
       "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a",
       "uuid": "95f94e8d-8b4e-11e9-8974-00a098e0219a",
       "name": "ocum-infinity-01",
       "_links": {
         "self": {
           "href": "/api/datacenter/cluster/nodes/37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a"
         }
       }
     },
     "cluster": {
       "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a",
       "uuid": "37387241-8b57-11e9-8974-00a098e0219a",
       "name": "ocum-infinity",
       "_links": {
         "self": {
           "href": "/api/datacenter/cluster/clusters/37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a"
         },
     "_links": {
       "self": {
         "href": "/api/datacenter/cluster/nodes/analytics"
       }
     }
   },

可用 API 列表

下表描述了 `/metrics`和 `/analytics`详细的 API。

备注

这些 API 返回的 IOPS 和性能指标都是 double 值，例如 100.53。不支持使用管道符 (|) 和通配符 (*) 过滤这些浮点值。
HTTP 动词 路径 描述

GET

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

检索由集群键的输入参数指定的集群的性能数据（样本和摘要）。返回集群键和 UUID、时间范围、IOPS、吞吐量、样本数等信息。

GET

/datacenter/cluster/clusters/analytics

检索数据中心内所有集群的高级性能指标。您可以根据所需条件过滤结果。返回聚合 IOPS、吞吐量和收集周期（以小时为单位）等值。

GET

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

检索节点键的输入参数指定的节点的性能数据（样本和摘要）。返回节点 UUID、时间范围、IOPS 摘要、吞吐量、延迟和性能、收集的样本数和利用率百分比等信息。

GET

/datacenter/cluster/nodes/analytics

检索数据中心中所有节点的高级性能指标。您可以根据所需条件过滤结果。返回节点和集群键等信息以及聚合 IOPS、吞吐量和收集周期（以小时为单位）等值。

GET

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

检索聚合键的输入参数指定的聚合的性能数据（样本和摘要）。返回的信息包括时间范围、IOPS 摘要、延迟、吞吐量和性能容量、每个计数器收集的样本数以及利用率百分比。

GET

/datacenter/storage/aggregates/analytics

检索数据中心内所有聚合的高级性能指标。您可以根据所需条件过滤结果。返回诸如聚合和集群键之类的信息以及诸如聚合 IOPS、吞吐量和收集周期（以小时为单位）之类的值。

GET

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

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

检索由 LUN 或卷键的输入参数指定的 LUN 或文件共享（卷）的性能数据（样本和摘要）。返回读取、写入和总 IOPS、延迟和吞吐量的最小值、最大值和平均值的摘要以及每个计数器收集的样本数等信息。

GET

/datacenter/storage/luns/analytics

/datacenter/storage/volumes/analytics

检索数据中心内所有 LUN 或卷的高级性能指标。您可以根据所需条件过滤结果。返回存储 VM 和集群键等信息以及聚合 IOPS、吞吐量和收集周期（以小时为单位）等值。

GET

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

检索由存储 VM 键的输入参数指定的存储 VM 的性能数据（样本和摘要）。根据每个支持的协议汇总 IOPS，例如 nvmf, fcp, iscsi,`和 `nfs、吞吐量、延迟和收集的样本数量。

GET

/datacenter/svm/svms/analytics

检索数据中心内所有存储虚拟机的高级性能指标。您可以根据所需条件过滤结果。返回存储 VM UUID、聚合 IOPS、延迟、吞吐量和收集周期（以小时为单位）等信息。

GET

/datacenter/network/ethernet/ports/{key}/metrics

检索由端口键的输入参数指定的特定以太网端口的性能指标。当提供支持范围的间隔（时间范围）时，API 将返回累积的计数器，例如该时间段内的最小值、最大值和平均性能值。

GET

/datacenter/network/ethernet/ports/analytics

检索数据中心环境中所有以太网端口的高级性能指标。返回集群和节点密钥和 UUID、吞吐量、收集周期和端口的利用率百分比等信息。您可以根据可用参数（例如端口键、利用率百分比、集群和节点名称以及 UUID 等）过滤结果。

GET

/datacenter/network/fc/interfaces/{key}/metrics

检索由接口键的输入参数指定的特定网络 FC 接口的性能指标。当提供支持范围的间隔（时间范围）时，API 将返回累积的计数器，例如该时间段内的最小值、最大值和平均性能值。

GET

/datacenter/network/fc/interfaces/analytics

检索数据中心环境中所有以太网端口的高级性能指标。返回集群和 FC 接口密钥和 UUID、吞吐量、IOPS、延迟和存储 VM 等信息。您可以根据可用参数过滤结果，例如集群和 FC 接口名称和 UUID、存储 VM、吞吐量等。

GET

/datacenter/network/fc/ports/{key}/metrics

检索由端口键的输入参数指定的特定 FC 端口的性能指标。当提供支持范围的间隔（时间范围）时，API 将返回累积的计数器，例如该时间段内的最小值、最大值和平均性能值。

GET

/datacenter/network/fc/ports/analytics

检索数据中心环境中所有 FC 端口的高级性能指标。返回集群和节点密钥和 UUID、吞吐量、收集周期和端口的利用率百分比等信息。您可以根据可用参数（例如端口键、利用率百分比、集群和节点名称以及 UUID 等）过滤结果。

GET

/datacenter/network/ip/interfaces/{key}/metrics

检索接口键的输入参数指定的网络 IP 接口的性能指标。当从支持的范围中提供一个间隔（时间范围）时，API 将返回信息，例如样本数、累积计数器、吞吐量以及接收和传输的数据包数。

GET

/datacenter/network/ip/interfaces/analytics

检索数据中心环境中所有网络 IP 接口的高级性能指标。返回集群和 IP 接口密钥和 UUID、吞吐量、IOPS 和延迟等信息。您可以根据可用参数过滤结果，例如集群和 IP 接口名称和 UUID、IOPS、延迟、吞吐量等。