Unisphere для PowerMax 10.x: Як отримати метрики на рівні пристрою через RESTAPI

У цій статті розглядається, як збирати показники на рівні пристрою через REST API в Unisphere для екземплярів PowerMax 10.x.

Кожен дзвінок RESTAPI потребує трьох речей:

• URL-адреса
• Тип дзвінка
• Корисне навантаження

Для збору показників обсягу використовується така URL-адреса:

• https://< IPorFQDN>:8443/univmax/restapi/продуктивність/Обсяг/метрики

Тип виклику: 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" може бути максимальним або середнім, також у лапках.
• "startDate" та "endDate" - це часова позначка EPOCH у мілісекундах (вона охоплює дату та час).
• "Показники" Можна перелічити кілька показників, але вони мають бути взяті в лапки та розділені комою.

Маючи дійсну URL-адресу, тип виклику та корисне навантаження, ви отримаєте дійсний дзвінок. Однак для метрик обсягу є додаткові обмеження для пристрою на бекенді:

• Обсяг повинен бути в СГ.
• СГ повинен знаходитися в МВ.
• СГ має бути у списку збору метрик «Група зберігання в реальному часі» у системних реєстраціях.
• Шлях до додавання СГ у режимі реального часу такий: Параметри >Продуктивність>Реєстрація> в системі Натисніть на буфер обміну

• Нарешті, часовий діапазон НЕ МОЖЕ бути більше 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, зверніться до наступного: what-s-new-in-powermax-rest-api

Для RESTAPI документацію, специфічну для вашої версії Unisphere, можна зібрати, виконавши наступні кроки. Ця документація може допомогти знайти те, що потрібно для викликів, і структуру корисного навантаження. 

1. Завантажте файл RESTAPI docs, перейшовши за посиланням:
   • Джерело: 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 не контролює його функціональність або підтримку.