Unisphere для PowerMax 10.x. Как получить метрики на уровне устройства с помощью RESTAPI

В этой статье рассматривается сбор метрик уровня устройства с помощью API REST в Unisphere для экземпляров PowerMax 10.x.

Для каждого вызова RESTAPI необходимы три вещи:

• 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-значный идентификатор устройства, и он должен быть заключен в кавычки. (Да, их может быть несколько.)
• "dateFormat" может быть Maximum или Average, также в кавычках.
• «startDate» и «endDate» — метка времени EPOCH в миллисекундах (охватывает дату и время).
• «Метрики» можно перечислить несколько метрик, но они должны быть заключены в кавычки и разделены запятой.

Если у вас есть действительный URL-адрес, тип вызова и полезные данные, у вас есть допустимый вызов. Однако для метрик объема существуют дополнительные ограничения для устройства на серверной части:

• Том должен находиться в SG.
• SG должен находиться в MV.
• SG должна находиться в списке сбора метрик «Группа хранения в режиме реального времени» в системных регистрациях.
• Способ добавления SG в Real-time: Параметры >Производительность>Регистрация> системы Нажмите на буфер обмена

• Наконец, временной диапазон НЕ МОЖЕТ быть больше 60 минут.
  • При построении времени EPOCK в миллисекундах убедитесь, что между датами начала и окончания интервал не превышает 60 минут. 
  • Рекомендуется использовать меньший временной промежуток, например пять минут, во время тестирования вызовов. 

Как только все ограничения будут выполнены, вы можете запустить звонок и получить код ответа 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».
   • Запомните, где находится этот файл, так как именно так осуществляется доступ к документации.
   • Откроется окно в веб-браузере.

На момент создания этой статьи базы знаний возможны следующие метрики на уровне устройства:

Временные метки EPOCH могут быть сгенерированы на других веб-сайтах, таких как EPOCHconverter. 
Обратите внимание, что это НЕ сайт Dell, поэтому Dell не имеет никакого контроля над его функциональностью или поддержкой.