使用API查看性能指标
建议更改
PDF
Active IQ Unified Manager在类别下为您提供了一组API /datacenter、可用于查看数据中心中集群和存储对象的性能数据。这些 API 可检索不同存储对象的性能数据，例如集群，节点， LUN ，卷，聚合， Storage VM ， FC 接口， FC 端口，以太网端口和 IP 接口。
`/metrics`和 `/analytics`API提供了不同的性能指标视图、您可以使用这些视图深入查看数据中心中以下存储对象的不同详细信息级别：
-
集群
-
节点
-
Storage VM
-
聚合
-
卷
-
LUN
-
FC接口
-
FC端口
-
以太网端口
-
IP接口
下表根据检索到的性能数据的详细信息对和 /analytics`API进行了比较 `/metrics。
| 指标 | 分析 |
|---|---|
单个对象的性能详细信息。例如、 `/datacenter/cluster/clusters/{key}/metrics`API要求输入集群密钥作为路径参数、以便检索该特定集群的指标。 |
数据中心中多个相同类型对象的性能详细信息。例如、 `/datacenter/cluster/clusters/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 动词 | 路径 | 说明 |
|---|---|---|
|
|
检索由集群密钥的输入参数指定的集群的性能数据（示例和摘要）。返回的信息包括集群密钥和 UUID ，时间范围， IOPS ，吞吐量和样本数量。 |
|
|
检索数据中心中所有集群的高级别性能指标。您可以根据所需条件筛选结果。系统将返回聚合 IOPS ，吞吐量和收集时间段（以小时为单位）等值。 |
|
|
检索由节点密钥的输入参数指定的节点的性能数据（示例和摘要）。返回的信息包括节点 UUID ，时间范围， IOPS 摘要，吞吐量，延迟和性能，收集的样本数量以及利用率百分比。 |
|
|
检索数据中心中所有节点的高级别性能指标。您可以根据所需条件筛选结果。系统将返回节点和集群密钥等信息以及聚合 IOPS ，吞吐量和收集时间段（以小时为单位）等值。 |
|
|
检索聚合密钥的输入参数指定的聚合的性能数据（示例和摘要）。返回的信息包括时间范围， IOPS 摘要，延迟，吞吐量和性能容量，为每个计数器收集的样本数以及利用率百分比。 |
|
|
检索数据中心中所有聚合的高级别性能指标。您可以根据所需条件筛选结果。系统将返回聚合密钥和集群密钥等信息以及聚合 IOPS ，吞吐量和收集时间段（以小时为单位）等值。 |
|
|
检索由 LUN 或卷密钥的输入参数指定的 LUN 或文件共享（卷）的性能数据（示例和摘要）。信息，例如读取，写入和总 IOPS ，延迟和吞吐量的最小值，最大值和平均值摘要， 并返回为每个计数器收集的样本数量。 |
|
|
检索数据中心中所有 LUN 或卷的高级别性能指标。您可以根据所需条件筛选结果。将返回 Storage VM 和集群密钥等信息以及聚合 IOPS ，吞吐量和收集时间段（以小时为单位）等值。 |
|
|
检索由 Storage VM 密钥的输入参数指定的 Storage VM 的性能数据（示例和摘要）。返回基于每个受支持协议(例如和 |
|
|
检索数据中心中所有 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 ，延迟，吞吐量等。 |