APIを使用したパフォーマンス指標の表示
変更を提案
PDF
Active IQ Unified Managerには、カテゴリの一連のAPIが用意されています。このAPIを `/datacenter`使用して、データセンター内のクラスタおよびストレージオブジェクトのパフォーマンスデータを表示できます。これらのAPIは、クラスタ、ノード、LUN、ボリューム、アグリゲート、Storage VM、FCインターフェイス、FCポート、イーサネットポート、IPインターフェイスなど、さまざまなストレージオブジェクトのパフォーマンスデータを取得します。
`/metrics`APIと `/analytics`APIでは、パフォーマンス指標がさまざまに表示されます。これを使用すると、データセンター内の次のストレージオブジェクトについて、さまざまなレベルの詳細にドリルダウンできます。
-
クラスタ
-
ノード
-
Storage VM
-
アグリゲート
-
ボリューム
-
LUN
-
FCインターフェイス
-
FCポート
-
イーサネットポート
-
IPインターフェイス
次の表に、取得したパフォーマンスデータの詳細に関するAPIと /analytics`APIの比較を示します `/metrics。
| 指標 | 分析 |
|---|---|
単一オブジェクトのパフォーマンスの詳細。たとえば、APIで `/datacenter/cluster/clusters/{key}/metrics`は、その特定のクラスタの指標を取得するためのパスパラメータとしてclusterキーを入力する必要があります。 |
データセンター内の同じタイプの複数のオブジェクトのパフォーマンスの詳細。たとえば、 `/datacenter/cluster/clusters/analytics`APIはデータセンター内のすべてのクラスタの総合的な指標を取得します。 |
読み出しの時間間隔パラメータに基づく、ストレージオブジェクトのパフォーマンス指標のサンプル。 |
特定のタイプのストレージオブジェクトの一定期間（72時間以上）のパフォーマンスの集計値の概要。 |
オブジェクトの基本的な詳細（ノードやクラスタの詳細など）が読み出されます。 |
特定の詳細は取得されません。 |
1つのオブジェクトについて、最小値、最大値、95パーセンタイル値、一定期間の平均パフォーマンス値などの累積カウンタ（読み取り、書き込み、合計、その他のカウンタなど）が読み出されます。 |
同じタイプのすべてのオブジェクトについて、集約された単一の値が表示されます。 |
時間範囲とサンプルデータは、次のスケジュールに基づいています。データの時間範囲。例としては、1h、12h、1d、2d、3d、15d、1w、1m、2m、3m、6mがあります。範囲が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、すべてのノードについて（とりわけ）次の値が取得されます。
{ "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のリスト
次の表に、と `/analytics`のAPIの詳細を示し `/metrics`ます。
|
|
これらのAPIから返されるIOPSとパフォーマンスの指標は、のように2倍の値です |
| HTTP動詞 | パス | 製品説明 |
|---|---|---|
|
|
クラスタキーの入力パラメータで指定されたクラスタのパフォーマンスデータ（サンプルと概要）を取得します。クラスタキーとUUID、時間範囲、IOPS、スループット、サンプル数などの情報が返されます。 |
|
|
データセンター内のすべてのクラスタのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタリングできます。集計されたIOPS、スループット、収集期間（時間）などの値が返されます。 |
|
|
ノードキーの入力パラメータで指定されたノードのパフォーマンスデータ（サンプルと概要）を取得します。ノードUUID、時間範囲、IOPS、スループット、レイテンシ、パフォーマンスの概要、収集されたサンプル数、使用率などの情報が返されます。 |
|
|
データセンター内のすべてのノードのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタリングできます。ノードキーやクラスタキーなどの情報と、IOPS、スループット、収集期間（時間数）などの値が返されます。 |
|
|
アグリゲートキーの入力パラメータで指定されたアグリゲートのパフォーマンスデータ（サンプルと概要）を取得します。期間、IOPS、レイテンシ、スループット、パフォーマンス容量の概要、各カウンタで収集されたサンプル数、使用率などの情報が返されます。 |
|
|
データセンター内のすべてのアグリゲートのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタリングできます。アグリゲートキーやクラスタキーなどの情報と、IOPS、スループット、収集期間（時間数）などの値が返されます。 |
|
|
LUNまたはボリュームキーの入力パラメータで指定されたLUNまたはファイル共有（ボリューム）のパフォーマンスデータ（サンプルと概要）を取得します。読み取り、書き込み、合計のIOPS、レイテンシ、スループットの最小値、最大値、平均値の概要、各カウンタで収集されたサンプル数などの情報が返されます。 |
|
|
データセンター内のすべてのLUNまたはボリュームのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタリングできます。Storage VMやクラスタのキーなどの情報と、IOPS、スループット、収集期間（時間数）などの値が返されます。 |
|
|
Storage VMキーの入力パラメータで指定されたStorage VMのパフォーマンスデータ（サンプルと概要）を取得します。サポートされる各プロトコルに基づくIOPSの概要（や、 `nfs`スループット、レイテンシ、収集されたサンプル数など） `nvmf, fcp, iscsi,`が返されます。 |
|
|
データセンター内のすべての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インターフェイスのパフォーマンス指標を取得します。サポートされている範囲から間隔（時間範囲）を指定すると、サンプル数、累積カウンタ、スループット、送受信されたパケット数などの情報が返されます。 |
|
|
データセンター環境内のすべてのネットワークIPインターフェイスについて、パフォーマンス指標の概要を取得します。クラスタとIPインターフェイスキーとUUID、スループット、IOPS、レイテンシなどの情報が返されます。クラスタとIPインターフェイスの名前とUUID、IOPS、レイテンシ、スループットなど、使用可能なパラメータで結果をフィルタリングできます。 |