Skip to main content
Active IQ Unified Manager 9.12
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

使用API檢視效能指標

貢獻者
PDF

在中提供一組API Active IQ Unified Manager /datacenter 此類別可讓您檢視叢集和資料中心儲存物件的效能資料。這些API會擷取不同儲存物件的效能資料、例如叢集、節點、LUN、磁碟區、集合體、 儲存VM、FC介面、FC連接埠、乙太網路連接埠及IP介面。

。 /metrics 和 /analytics API提供不同的效能指標檢視、您可以使用這些檢視、深入瞭解資料中心中下列儲存物件的不同層級詳細資料：

  • 叢集

  • 節點

  • 儲存VM

  • 集合體

  • 磁碟區

  • LUN

  • FC介面

  • FC連接埠

  • 乙太網路連接埠

  • IP介面

下表列出兩者之間的比較 /metrics 和 /analytics API中所擷取效能資料的詳細資料。

指標 分析

單一物件的效能詳細資料。例如、 /datacenter/cluster/clusters/{key}/metrics API要求輸入叢集金鑰作為路徑參數、以擷取該特定叢集的度量。

資料中心內多個相同類型物件的效能詳細資料。例如、 /datacenter/cluster/clusters/analytics API會擷取資料中心內所有叢集的集合度量。

儲存物件的效能指標範例、以擷取所需的時間間隔參數為基礎。

特定儲存物件類型在特定期間（72小時以上）的高層效能集合值。

系統會擷取物件的基本詳細資料、例如節點或叢集的詳細資料。

未擷取任何特定詳細資料。

針對單一物件擷取累計的計數器、例如最小值、最大值、95百分位數、以及一段時間內的平均效能值、例如讀取、寫入、總計和其他計數器。

相同類型的所有物件都會顯示單一彙總值。

時間範圍和範例資料是根據下列排程：資料的時間範圍。範例可以是1h、12h、1d、2D、3D、 15d、1W、1公尺、2公尺、3公尺、 6萬。如果範圍超過3天（72小時）、您會得到1小時的樣本、否則只有5分鐘的樣本。每個時間範圍的期間如下：

  • 1小時：最近一小時的指標取樣時間超過5分鐘。

  • 12小時：最近12小時內的指標取樣時間超過5分鐘。

  • 一維：最近一天的指標取樣時間超過5分鐘。

  • 2D：最近2天的測量數據取樣時間超過5分鐘。

  • 3D：最近3天內的指標取樣時間超過5分鐘。

  • 15d：最近15天內的指標、取樣時間超過1小時。

  • 1W：最近一週的指標取樣時間超過1小時。

  • 1M：最近一個月內的數據取樣時間超過1小時。

  • 2百萬：最近2個月的指標取樣時間超過1小時。

  • 3M：最近3個月的指標、取樣時間超過1小時。

  • 6個月：最近6個月的指標取樣時間超過1小時。

    可用值：1小時、12小時、一維、二維、三維、 15d、1W、1公尺、2公尺、3公尺、 6萬

    預設值：1小時

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和效能指標是兩倍的值 100.53。不支援使用管路（|）和萬用字元（*）來篩選這些浮點值。
HTTP Verb 路徑 說明

GET

/datacenter/cluster/clusters/{key}/metrics

擷取叢集金鑰輸入參數所指定叢集的效能資料（範例和摘要）。傳回叢集金鑰和UUID、時間範圍、IOPS、處理量及取樣數目等資訊。

GET

/datacenter/cluster/clusters/analytics

擷取資料中心內所有叢集的高層級效能指標。您可以根據所需的條件篩選結果。會傳回彙總IOPS、處理量及收集期間（以小時為單位）等值。

GET

/datacenter/cluster/nodes/{key}/metrics

擷取節點金鑰輸入參數所指定節點的效能資料（範例和摘要）。傳回的資訊包括節點UUID、時間範圍、IOPS摘要、處理量、延遲和效能、所收集的樣本數、以及使用百分比。

GET

/datacenter/cluster/nodes/analytics

擷取資料中心中所有節點的高層效能度量。您可以根據所需的條件篩選結果。會傳回節點和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。

GET

/datacenter/storage/aggregates/{key}/metrics

擷取Aggregate金鑰輸入參數所指定之Aggregate的效能資料（範例和摘要）。傳回的資訊包括時間範圍、IOPS摘要、延遲、處理量和效能容量、每個計數器所收集的樣本數、以及使用的百分比。

GET

/datacenter/storage/aggregates/analytics

擷取資料中心中所有集合體的高層效能指標。您可以根據所需的條件篩選結果。會傳回諸如Aggregate和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。

GET

/datacenter/storage/luns/{key}/metrics

/datacenter/storage/volumes/{key}/metrics

擷取LUN或LUN或Volume金鑰輸入參數所指定之檔案共用區（Volume）的效能資料（範例和摘要）。資訊、例如讀取、寫入和IOPS總計、延遲和處理量的最小、最大和平均摘要、 並傳回每個計數器所收集的樣本數。

GET

/datacenter/storage/luns/analytics

/datacenter/storage/volumes/analytics

擷取資料中心內所有LUN或磁碟區的高層效能度量。您可以根據所需的條件篩選結果。系統會傳回儲存VM和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。

GET

/datacenter/svm/svms/{key}/metrics

擷取儲存VM金鑰輸入參數所指定之儲存VM的效能資料（範例和摘要）。每個支援的傳輸協定（例如）的IOPS摘要 nvmf, fcp, iscsi, 和 `nfs`會傳回處理量、延遲及所收集的樣本數目。

GET

/datacenter/svm/svms/analytics

擷取資料中心內所有儲存VM的高階效能指標。您可以根據所需的條件篩選結果。系統會傳回儲存VM UUID、彙總IOPS、延遲、處理量及收集期間（以小時為單位）等資訊。

GET

/datacenter/network/ethernet/ports/{key}/metrics

擷取連接埠金鑰輸入參數所指定之特定乙太網路連接埠的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。

GET

/datacenter/network/ethernet/ports/analytics

擷取資料中心環境中所有乙太網路連接埠的高效能度量。傳回叢集和節點金鑰及UUID、處理量、收集期間及連接埠使用率百分比等資訊。您可以根據可用的參數（例如連接埠金鑰、使用率百分比、叢集和節點名稱及UUID等）來篩選結果。

GET

/datacenter/network/fc/interfaces/{key}/metrics

擷取介面金鑰輸入參數所指定之特定網路FC介面的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。

GET

/datacenter/network/fc/interfaces/analytics

擷取資料中心環境中所有乙太網路連接埠的高效能度量。傳回叢集和FC介面金鑰及UUID、處理量、IOPS、延遲和儲存VM等資訊。您可以根據可用的參數來篩選結果、例如叢集和FC介面名稱與UUID、儲存VM、處理量等。

GET

/datacenter/network/fc/ports/{key}/metrics

擷取連接埠金鑰輸入參數所指定之特定FC連接埠的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。

GET

/datacenter/network/fc/ports/analytics

擷取資料中心環境中所有FC連接埠的高層效能指標。傳回叢集和節點金鑰及UUID、處理量、收集期間及連接埠使用率百分比等資訊。您可以根據可用的參數（例如連接埠金鑰、使用率百分比、叢集和節點名稱及UUID等）來篩選結果。

GET

/datacenter/network/ip/interfaces/{key}/metrics

擷取介面金鑰輸入參數所指定之網路IP介面的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回資訊、例如取樣數量、累計計數器、處理量、以及接收和傳輸的封包數。

GET

/datacenter/network/ip/interfaces/analytics

擷取資料中心環境中所有網路IP介面的高層效能度量。傳回叢集與IP介面金鑰及UUID、處理量、IOPS及延遲等資訊。您可以根據可用的參數來篩選結果、例如叢集和IP介面名稱及UUID、IOPS、延遲、處理量等。