入门
使用API查看性能指标
建议更改
PDF
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 ，延迟，吞吐量等。 |