使用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中所擷取效能資料的詳細資料。
| 指標 | 分析 |
|---|---|
單一物件的效能詳細資料。例如、 |
資料中心內多個相同類型物件的效能詳細資料。例如、 |
儲存物件的效能指標範例、以擷取所需的時間間隔參數為基礎。 |
特定儲存物件類型在特定期間（72小時以上）的高層效能集合值。 |
系統會擷取物件的基本詳細資料、例如節點或叢集的詳細資料。 |
未擷取任何特定詳細資料。 |
針對單一物件擷取累計的計數器、例如最小值、最大值、95百分位數、以及一段時間內的平均效能值、例如讀取、寫入、總計和其他計數器。 |
相同類型的所有物件都會顯示單一彙總值。 |
時間範圍和範例資料是根據下列排程：資料的時間範圍。範例可以是1h、12h、1d、2D、3D、 15d、1W、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 Verb | 路徑 | 說明 |
|---|---|---|
|
|
擷取叢集金鑰輸入參數所指定叢集的效能資料（範例和摘要）。傳回叢集金鑰和UUID、時間範圍、IOPS、處理量及取樣數目等資訊。 |
|
|
擷取資料中心內所有叢集的高層級效能指標。您可以根據所需的條件篩選結果。會傳回彙總IOPS、處理量及收集期間（以小時為單位）等值。 |
|
|
擷取節點金鑰輸入參數所指定節點的效能資料（範例和摘要）。傳回的資訊包括節點UUID、時間範圍、IOPS摘要、處理量、延遲和效能、所收集的樣本數、以及使用百分比。 |
|
|
擷取資料中心中所有節點的高層效能度量。您可以根據所需的條件篩選結果。會傳回節點和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。 |
|
|
擷取Aggregate金鑰輸入參數所指定之Aggregate的效能資料（範例和摘要）。傳回的資訊包括時間範圍、IOPS摘要、延遲、處理量和效能容量、每個計數器所收集的樣本數、以及使用的百分比。 |
|
|
擷取資料中心中所有集合體的高層效能指標。您可以根據所需的條件篩選結果。會傳回諸如Aggregate和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。 |
|
|
擷取LUN或LUN或Volume金鑰輸入參數所指定之檔案共用區（Volume）的效能資料（範例和摘要）。資訊、例如讀取、寫入和IOPS總計、延遲和處理量的最小、最大和平均摘要、 並傳回每個計數器所收集的樣本數。 |
|
|
擷取資料中心內所有LUN或磁碟區的高層效能度量。您可以根據所需的條件篩選結果。系統會傳回儲存VM和叢集金鑰等資訊、以及彙總IOPS、處理量和收集期間（以小時為單位）等值。 |
|
|
擷取儲存VM金鑰輸入參數所指定之儲存VM的效能資料（範例和摘要）。每個支援的傳輸協定（例如）的IOPS摘要 |
|
|
擷取資料中心內所有儲存VM的高階效能指標。您可以根據所需的條件篩選結果。系統會傳回儲存VM UUID、彙總IOPS、延遲、處理量及收集期間（以小時為單位）等資訊。 |
|
|
擷取連接埠金鑰輸入參數所指定之特定乙太網路連接埠的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。 |
|
|
擷取資料中心環境中所有乙太網路連接埠的高效能度量。傳回叢集和節點金鑰及UUID、處理量、收集期間及連接埠使用率百分比等資訊。您可以根據可用的參數（例如連接埠金鑰、使用率百分比、叢集和節點名稱及UUID等）來篩選結果。 |
|
|
擷取介面金鑰輸入參數所指定之特定網路FC介面的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。 |
|
|
擷取資料中心環境中所有乙太網路連接埠的高效能度量。傳回叢集和FC介面金鑰及UUID、處理量、IOPS、延遲和儲存VM等資訊。您可以根據可用的參數來篩選結果、例如叢集和FC介面名稱與UUID、儲存VM、處理量等。 |
|
|
擷取連接埠金鑰輸入參數所指定之特定FC連接埠的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回累計的計數器、例如期間內的最小、最大和平均效能值。 |
|
|
擷取資料中心環境中所有FC連接埠的高層效能指標。傳回叢集和節點金鑰及UUID、處理量、收集期間及連接埠使用率百分比等資訊。您可以根據可用的參數（例如連接埠金鑰、使用率百分比、叢集和節點名稱及UUID等）來篩選結果。 |
|
|
擷取介面金鑰輸入參數所指定之網路IP介面的效能度量。當從支援範圍提供時間間隔（時間範圍）時、API會傳回資訊、例如取樣數量、累計計數器、處理量、以及接收和傳輸的封包數。 |
|
|
擷取資料中心環境中所有網路IP介面的高層效能度量。傳回叢集與IP介面金鑰及UUID、處理量、IOPS及延遲等資訊。您可以根據可用的參數來篩選結果、例如叢集和IP介面名稱及UUID、IOPS、延遲、處理量等。 |