はじめに
APIを使用したパフォーマンス指標の表示
変更を提案
PDF
Active IQ Unified Manager には、の一連のAPIが用意されています /datacenter データセンター内のクラスタおよびストレージオブジェクトのパフォーマンスデータを表示できるカテゴリ。これらの API は、クラスタ、ノード、 LUN 、ボリューム、アグリゲートなどのさまざまなストレージオブジェクトのパフォーマンスデータを取得します。 Storage VM 、 FC インターフェイス、 FC ポート、イーサネットポート、 IP インターフェイス
。 /metrics および /analytics APIを使用すると、パフォーマンス指標をさまざまなビューで確認できます。データセンター内の次のストレージオブジェクトについて、さまざまなレベルの詳細にドリルダウンできます。
-
クラスタ
-
ノード
-
Storage VMs
-
アグリゲート
-
個のボリューム
-
LUN
-
FC インターフェイス
-
FC ポート
-
イーサネットポート
-
IP インターフェイス
次の表は、間の比較を示しています /metrics および /analytics 取得したパフォーマンスデータの詳細を示すAPI。
| 指標 | 分析 |
|---|---|
1 つのオブジェクトのパフォーマンスの詳細。たとえば、などです |
データセンター内の同じタイプの複数のオブジェクトのパフォーマンスの詳細。たとえば、などです |
読み出しの時間間隔パラメータに基づくストレージオブジェクトのパフォーマンス指標サンプル。 |
特定の期間（ 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 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とパフォーマンスの指標には、たとえば2倍の値があります |
| HTTP 動詞 | パス | 説明 |
|---|---|---|
|
|
クラスタキーの入力パラメータで指定したクラスタのパフォーマンスデータ（サンプルと概要）を取得します。クラスタキーと UUID 、時間範囲、 IOPS 、スループット、サンプル数などの情報が返されます。 |
|
|
は、データセンター内のすべてのクラスタのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタできます。集計 IOPS 、スループット、収集期間（時間数）などの値が返されます。 |
|
|
ノードキーの入力パラメータで指定したノードのパフォーマンスデータ（サンプルとサマリ）を取得します。ノード UUID 、時間範囲、 IOPS 、スループット、レイテンシ、パフォーマンスの概要、収集されたサンプル数、利用率などの情報が返されます。 |
|
|
は、データセンター内のすべてのノードのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタできます。ノードキーやクラスタキーなどの情報、および集計 IOPS 、スループット、収集期間（時間数）などの値が返されます。 |
|
|
aggregate キーの入力パラメータで指定したアグリゲートのパフォーマンスデータ（サンプルとサマリ）を取得します。時間範囲、 IOPS 、レイテンシ、スループット、パフォーマンス容量の概要、各カウンタで収集されたサンプル数、使用率などの情報が返されます。 |
|
|
データセンター内のすべてのアグリゲートのパフォーマンス指標の概要が取得されます。必要な条件に基づいて結果をフィルタできます。アグリゲートキーやクラスタキーなどの情報、および集計 IOPS 、スループット、収集期間（時間数）などの値が返されます。 |
|
|
LUN またはボリュームキーの入力パラメータで指定された LUN またはファイル共有（ボリューム）のパフォーマンスデータ（サンプルとサマリ）を取得します。読み取り、書き込み、合計 IOPS 、レイテンシ、スループットの最小値、最大値、平均値の概要などの情報。 各カウンタについて収集されたサンプル数が返されます。 |
|
|
データセンター内のすべての LUN またはボリュームのパフォーマンス指標の概要を取得します。必要な条件に基づいて結果をフィルタできます。Storage VM やクラスタキーなどの情報、および集計 IOPS 、スループット、収集期間（時間数）などの値が返されます。 |
|
|
Storage VM キーの入力パラメータで指定した Storage VM のパフォーマンスデータ（サンプルと概要）を取得します。など、サポートされている各プロトコルに基づくIOPSの概要 |
|
|
は、データセンター内のすべての 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 、レイテンシ、スループットなど、使用可能なパラメータで結果をフィルタリングできます。 |