Unisphere for PowerMax 10.x：如何通过 RESTAPI 获取设备级指标

本文综述如何通过 REST API 向 Unisphere for PowerMax 10.x 实例收集设备级指标。

每次 RESTAPI 调用都需要做三件事：

• A URL
• 呼叫类型
• 有效负载

要收集卷指标，URL 为：

• https://< IPorFQDN>：8443/univmax/restapi/performance/Volume/metrics

呼叫类型为：POST
JSON 的 Payload 结构如下：（对于 XML，请参阅“其他信息”部分）

{
"systemId": "000xxxxxxxxx",
"volumeStartRange": "xxxxx",
"volumeEndRange": "xxxxx",
"dataFormat": "Maximum",
"endDate":xxxxxxxxxxxxxx,
"metrics": [
"metric1",
"metric2",
"metric3",
"etc"
],
"startDate": xxxxxxxxxxxxxxx
}

每个字段都有要求。这适用于使用以下字段的任何调用： 

• “systemId” 需要阵列序列号的完整 12 位数字，并且必须用引号括起来。
• “volumeStartRange” 和 “volumeEndRange” 都需要 5 位的设备 ID，并且必须用引号括起来。（是的，您可以拥有多个。
• “dateFormat” 可以是 Maximum 或 Average，也可以放在引号中。
• “startDate” 和 “endDate” 是以毫秒为单位的 EPOCH 时间戳（包括日期和时间）。
• 在“metrics” 中，您可以列出多个指标，但它们必须用引号引起来并以逗号分隔。

通过具有有效的 URL、调用类型和有效负载，您就拥有了有效的调用。但是，对于卷指标，后端设备上有其他限制：

• 卷必须位于 SG 中。
• SG 必须在 MV 中。
• SG 必须位于系统注册的“存储组实时”指标收集列表中。
• 将 SG 添加到 Real-time 的路径是：设置 >性能>系统注册>单击剪贴板

• 最后，时间范围不能超过 60 分钟。
  • 以毫秒为单位构建 EPOCK 时间时，请确保开始日期和结束日期的间隔不超过 60 分钟。 
  • 建议在呼叫测试期间设置较小的时间窗口，例如五分钟。 

满足所有限制后，您可以运行呼叫并获取包含设备指标的 HTTP 200 响应代码：

 

以下是可能需要的一些其他信息：

设备级指标调用的 XML 有效负载格式：

<volumeParam xmlns="http://www.emc.com/em/2012/07/univmax/restapi/performance">
  <startDate>...</startDate>
  <endDate>...</endDate>
  <systemId>...</systemId>
  <volumeStartRange>...</volumeStartRange>
  <volumeEndRange>...</volumeEndRange>
  <commaSeparatedStorageGroupList>...</commaSeparatedStorageGroupList>
  <dataFormat>...</dataFormat>
  <metrics>...</metrics>
</volumeParam>

要查看 10.x 的所有主要更改，请参阅以下内容： Powermax-rest-api

中的新增功能对于 RESTAPI，可以使用以下步骤收集特定于您的 Unisphere 版本的文档。此文档可帮助查找调用所需的内容和有效负载结构。 

1. 通过转至以下位置下载 RESTAPI 文档文件：
   • https：//UNIVMAX_IP：UNIVMAX_PORT/univmax/restapi/docs
   • UNIVMAX_IP是 IP 地址，UNIVMAX_PORT是运行 Unisphere 的主机的端口。
2. 将文件移动到要保存文档的位置。
3. 提取.zip文件内容。
4. 在解压文件列表中查找名为“index.html”的文件。
5. 打开“index.html”：
   • 记住此文件的位置，因为这是您访问文档的方式。
   • 它应该会在您的网页浏览器中打开一个窗口。

在创建此知识库文章时，可能的设备级别指标包括：

EPOCH时间戳可以在 EPOCHconverter等其他网站上生成。
请记住，这不是戴尔站点，因此戴尔无法控制其功能或支持。