使用API查看性能指标
Active IQ Unified Manager 在下为您提供了一组API /datacenter
用于查看数据中心中集群和存储对象的性能数据的类别。这些 API 可检索不同存储对象的性能数据,例如集群,节点, LUN ,卷,聚合, Storage VM , FC 接口, FC 端口,以太网端口和 IP 接口。
。 /metrics
和 /analytics
API提供了不同的性能指标视图、使用这些视图、您可以深入了解数据中心中以下存储对象的不同详细信息级别:
-
集群
-
nodes
-
Storage VM
-
聚合
-
volumes
-
LUN
-
FC接口
-
FC端口
-
以太网端口
-
IP 接口
下表对进行了比较 /metrics
和 /analytics
API中有关检索到的性能数据的详细信息。
指标 | 分析 |
---|---|
单个对象的性能详细信息。例如、 |
数据中心中多个相同类型对象的性能详细信息。例如、 |
基于检索时间间隔参数的存储对象性能指标示例。 |
特定类型存储对象在特定时间段(超过 72 小时)内的性能的高级别聚合值。 |
将检索对象的基本详细信息,例如节点或集群的详细信息。 |
未检索到任何特定详细信息。 |
系统会为单个对象检索累积计数器,例如读取,写入,总计和其他计数器,例如最小,最大,第 95 百分位以及一段时间内的平均性能值。 |
对于同一类型的所有对象,将显示一个聚合值。 |
时间范围和示例数据基于以下计划:数据的时间范围。示例可以是 1 小时, 12 小时, 1 天, 2 天, 3 天, 15d , 1 瓦, 1 米, 2 米, 3 米, 6 万。如果范围超过 3 天( 72 小时),则可以获得 1 小时的样本,否则为 5 分钟的样本。每个时间范围的时间段如下:
|
超过 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和性能指标是双倍值 |
HTTP 动词 | 路径 | Description |
---|---|---|
|
|
检索由集群密钥的输入参数指定的集群的性能数据(示例和摘要)。返回的信息包括集群密钥和 UUID ,时间范围, IOPS ,吞吐量和样本数量。 |
|
|
检索数据中心中所有集群的高级别性能指标。您可以根据所需条件筛选结果。系统将返回聚合 IOPS ,吞吐量和收集时间段(以小时为单位)等值。 |
|
|
检索由节点密钥的输入参数指定的节点的性能数据(示例和摘要)。返回的信息包括节点 UUID ,时间范围, IOPS 摘要,吞吐量,延迟和性能,收集的样本数量以及利用率百分比。 |
|
|
检索数据中心中所有节点的高级别性能指标。您可以根据所需条件筛选结果。系统将返回节点和集群密钥等信息以及聚合 IOPS ,吞吐量和收集时间段(以小时为单位)等值。 |
|
|
检索聚合密钥的输入参数指定的聚合的性能数据(示例和摘要)。返回的信息包括时间范围, IOPS 摘要,延迟,吞吐量和性能容量,为每个计数器收集的样本数以及利用率百分比。 |
|
|
检索数据中心中所有聚合的高级别性能指标。您可以根据所需条件筛选结果。系统将返回聚合密钥和集群密钥等信息以及聚合 IOPS ,吞吐量和收集时间段(以小时为单位)等值。 |
|
|
检索由 LUN 或卷密钥的输入参数指定的 LUN 或文件共享(卷)的性能数据(示例和摘要)。信息,例如读取,写入和总 IOPS ,延迟和吞吐量的最小值,最大值和平均值摘要, 并返回为每个计数器收集的样本数量。 |
|
|
检索数据中心中所有 LUN 或卷的高级别性能指标。您可以根据所需条件筛选结果。将返回 Storage VM 和集群密钥等信息以及聚合 IOPS ,吞吐量和收集时间段(以小时为单位)等值。 |
|
|
检索由 Storage VM 密钥的输入参数指定的 Storage VM 的性能数据(示例和摘要)。基于每个受支持协议的IOPS摘要、例如 |
|
|
检索数据中心中所有 Storage VM 的高级别性能指标。您可以根据所需条件筛选结果。将返回 Storage VM UUID ,聚合 IOPS ,延迟,吞吐量和收集时间段(以小时为单位)等信息。 |
|
|
检索由端口密钥的输入参数指定的特定以太网端口的性能指标。如果提供的间隔(时间范围)来自支持的范围,则 API 将返回累积计数器,例如该时间段内的最小,最大和平均性能值。 |
|
|
检索数据中心环境中所有以太网端口的性能指标概要。返回的信息包括集群和节点密钥和 UUID ,吞吐量,收集期限以及端口的利用率百分比。您可以按可用参数筛选结果,例如端口密钥,利用率百分比,集群和节点名称以及 UUID 等。 |
|
|
检索由接口密钥的输入参数指定的特定网络 FC 接口的性能指标。如果提供的间隔(时间范围)来自支持的范围,则 API 将返回累积计数器,例如该时间段内的最小,最大和平均性能值。 |
|
|
检索数据中心环境中所有以太网端口的性能指标概要。将返回集群和 FC 接口密钥和 UUID ,吞吐量, IOPS ,延迟和 Storage VM 等信息。您可以按可用参数筛选结果,例如集群和 FC 接口名称和 UUID , Storage VM ,吞吐量等。 |
|
|
检索由端口密钥的输入参数指定的特定 FC 端口的性能指标。如果提供的间隔(时间范围)来自支持的范围,则 API 将返回累积计数器,例如该时间段内的最小,最大和平均性能值。 |
|
|
检索数据中心环境中所有 FC 端口的性能指标概要。返回的信息包括集群和节点密钥和 UUID ,吞吐量,收集期限以及端口的利用率百分比。您可以按可用参数筛选结果,例如端口密钥,利用率百分比,集群和节点名称以及 UUID 等。 |
|
|
检索由接口密钥的输入参数指定的网络 IP 接口的性能指标。如果从支持的范围提供间隔(时间范围),则 API 将返回相关信息,例如样本数量,累积计数器,吞吐量以及接收和传输的数据包数量。 |
|
|
检索数据中心环境中所有网络 IP 接口的性能指标概要。将返回集群和 IP 接口密钥以及 UUID ,吞吐量, IOPS 和延迟等信息。您可以按可用参数筛选结果,例如集群和 IP 接口名称以及 UUID , IOPS ,延迟,吞吐量等。 |