PowerMax 10.x 的 Unisphere：如何透過 RESTAPI 取得裝置層級指標

本文評論如何透過 PowerMax 10.x 例項的 Unisphere 透過 REST API 收集裝置層級指標。

每次 RESTAPI 呼叫都需要三個項目：

• 一個網址
• 呼叫類型
• 有效負載

若要收集卷指標，URL 為：

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

呼叫類型為：POST
JSON 的有效負載結構如下：（有關 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」 可以是「最大值」或「平均」，也可使用引號引起來。
• 「startDate」 和 「endDate」 是以毫秒為單位的 EPOCH 時間戳記 （這涵蓋了日期和時間）。
• 您可以列出多個指標的「指標」， 但這些指標必須位於引號中，並以逗號分隔。

通過具有有效的 URL、調用類型和負載，您就擁有了有效的調用。但是，對於卷指標，後端的設備還有其他限制：

• 磁碟區必須位於 SG 中。
• SG 必須位於 MV 中。
• SG 必須位於系統註冊的「儲存群組即時」指標收集清單中。
• 將 SG 新增至即時的路徑為：設定 >演奏>系統註冊>按一下剪貼簿

• 最後，時間範圍不能超過 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」：
   • 請記住此檔案的位置，因為這是您存取文件的方式。
   • 它應該在您的 Web 瀏覽器中打開一個視窗。

在建立本知識文章時，可能的裝置層級指標為：

EPOCH時間戳可以在 EPOCH轉換器等其他網站生成。
請記住，這不是 Dell 據點，因此 Dell 無法控制其功能或支援。