Unisphere for PowerMax 10.x: RESTAPIを使用してデバイス レベルのメトリックを取得する方法

この記事では、REST APIを使用してUnisphere for PowerMax 10.xインスタンスにデバイスレベルのメトリックを収集する方法について説明します

各RESTAPIコールには、次の3つのものが必要です。

• A URL
• コール タイプ
• ペイロード

ボリューム メトリックを収集するための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" は Maximum または Average にすることもできます (引用符で囲むこともできます)。
• 「startDate」 と 「endDate」 は、ミリ秒単位のエポック タイムスタンプです(日付と時刻が含まれます)。
• "metrics" は複数のメトリックをリストできますが、引用符で囲み、コンマで区切る必要があります。

有効なURL、コールタイプ、およびペイロードがあれば、有効なコールになります。ただし、ボリューム メトリックの場合、バックエンドのデバイスには追加の制限があります。

• ボリュームはSG内にある必要があります。
• SGはMVに含まれている必要があります。
• SGは、システム登録の「ストレージ グループ リアルタイム」メトリック収集リストに含まれている必要があります。
• SGをリアルタイムに追加するパスは次のとおりです。設定>パフォーマンス>システム登録>クリップボードをクリックします

• 最後に、時間範囲を60分以下にすることはできません。
  • エポック時間をミリ秒単位で作成する場合は、開始日と終了日の間隔が 60 分を超えないようにしてください。 
  • コール テスト中は、5分など、より短い時間枠で行うことをお勧めします。 

すべての制限が満たされたら、呼び出しを実行し、デバイス メトリックを含む 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タイムスタンプは、EPOCHconverterなどの他のWebサイトで生成できます。
ここはDellのサイトではないため、Dellがその機能やサポートを管理できないことに注意してください。