Unisphere para PowerMax 10.x: Cómo obtener métricas a nivel de dispositivo a través de la API REST

En este artículo, se analiza cómo recopilar métricas en el nivel de dispositivo a través de la API REST en Unisphere para instancias de PowerMax 10.x.

Cada llamada a la API REST necesita tres cosas:

• Una URL
• Un tipo de llamada
• Una carga útil

Para recopilar métricas de volumen, la dirección URL es:

• https://< IPorFQDN>:8443/univmax/restapi/performance/Volume/metrics

El tipo de llamada es: POST
La carga útil se estructura de la siguiente manera para JSON: (Para XML, consulte la sección "Información adicional")

{
"systemId": "000xxxxxxxxx",
"volumeStartRange": "xxxxx",
"volumeEndRange": "xxxxx",
"dataFormat": "Maximum",
"endDate":xxxxxxxxxxxxxx,
"metrics": [
"metric1",
"metric2",
"metric3",
"etc"
],
"startDate": xxxxxxxxxxxxxxx
}

Cada campo tiene requisitos. Esto se aplica a cualquier llamada que utilice estos campos: 

• "systemId" requiere los 12 dígitos completos del número de serie del arreglo y debe estar entre comillas.
• "volumeStartRange" y "volumeEndRange" requieren el ID de dispositivo de 5 dígitos y debe estar entre comillas. (Sí, puede tener más de uno).
• "dateFormat" puede ser máximo o promedio, también entre comillas.
• "startDate" y "endDate" son los registros de fecha y hora de EPOCH en milisegundos (esto abarca la fecha y la hora).
• "Métricas" Puede enumerar varias métricas, pero deben estar entre comillas y separadas por comas.

Al tener una URL, un tipo de llamada y una carga útil válidos, tiene una llamada válida. Sin embargo, para las métricas de volumen, existen restricciones adicionales para el dispositivo en el back-end:

• El volumen debe estar en un SG.
• El SG debe estar en un MV.
• El SG debe estar en la lista de recopilación de métricas "Storage group real-time" en los registros del sistema.
• La ruta para agregar un SG a tiempo real es la siguiente: Configuración >Rendimiento>Registro del> sistema Haga clic en el portapapeles

• Por último, el rango de tiempo NO PUEDE ser superior a 60 minutos.
  • Cuando cree los tiempos de EPOCK en milisegundos, asegúrese de que las fechas de inicio y finalización no tengan más de 60 minutos de diferencia. 
  • Se recomienda realizar una ventana de tiempo más pequeña, como cinco minutos, durante la prueba de llamadas. 

Una vez que se cumplan todas las restricciones, puede ejecutar la llamada y obtener un código de respuesta HTTP 200 con las métricas del dispositivo:

 

A continuación, se muestra información adicional que puede ser necesaria:

Formato de carga útil XML para la llamada de métricas de nivel de dispositivo:

<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>

Para ver todos los cambios importantes con 10.x, consulte lo siguiente: novedades de la API

REST de PowerMax Para la API REST, la documentación específica de su versión de Unisphere se puede recopilar mediante los siguientes pasos. Esta documentación puede ayudar a encontrar lo que se necesita para las llamadas y la estructura de carga útil. 

1. Para descargar el archivo de documentos de la API REST, vaya a:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs (en inglés)
   • El UNIVMAX_IP es la dirección IP y UNIVMAX_PORT es el puerto del host que ejecuta Unisphere.
2. Mueva el archivo a la ubicación en la que desea conservar la documentación.
3. Extraiga el contenido del archivo .zip.
4. Busque el archivo denominado "index.html" en la lista de archivos extraídos.
5. Abra el "index.html":
   • Recuerde dónde se encuentra este archivo, ya que así es como accede a la documentación.
   • Debería abrir una ventana en su navegador web.

En el momento de crear este artículo de la base de conocimientos, las posibles métricas a nivel de dispositivo son las siguientes:

Las marcas de tiempo de EPOCH se pueden generar en otros sitios web como EPOCHconverter. 
Tenga en cuenta que este NO es un sitio de Dell, por lo que Dell no tiene control sobre su funcionalidad ni soporte.