Unisphere para PowerMax 10.x: Como obter métricas no nível do dispositivo por meio da API REST

Este artigo analisa como coletar medições no nível do dispositivo por meio da API REST para instâncias do Unisphere for PowerMax 10.x.

Cada chamada RESTAPI precisa de três coisas:

• Uma URL
• Um tipo de chamada
• Uma carga útil

Para coletar medições de volume, a URL é:

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

O tipo de chamada é: POST
O payload está estruturado da seguinte forma para JSON: (Para XML, consulte a seção "Informações adicionais")

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

Cada campo tem requisitos. Isso se aplica a todas as chamadas que usam estes campos: 

• "systemId" requer os 12 dígitos completos do número de série do array e deve estar entre aspas.
• "volumeStartRange" e "volumeEndRange" exigem o ID do dispositivo de 5 dígitos e devem estar entre aspas. (Sim, você pode ter mais de um.)
• "dateFormat" pode ser Maximum ou Average, também entre aspas.
• "startDate" e "endDate" são o registro de data e hora da EPOCH em milissegundos (isso abrange a data e a hora).
• "Métricas" Você pode listar várias métricas, mas elas devem estar entre aspas e separadas por vírgulas.

Ao ter um URL, tipo de chamada e payload válidos, você tem uma chamada válida. No entanto, para medições de volume, há restrições adicionais para o dispositivo no back-end:

• O volume deve estar em um SG.
• O SG deve estar em um MV.
• O SG deve estar na lista de coleta de medições "Storage group real-time" nos registros do sistema.
• O caminho para adicionar um SG ao Real-time é: Configurações >Desempenho>Registro> do sistema Clique na área de transferência

• Por fim, o intervalo de tempo NÃO pode ser superior a 60 minutos.
  • Ao criar seus tempos EPOCK em milissegundos, certifique-se de que as datas de Início e Término não estejam separadas por mais de 60 minutos. 
  • É recomendável fazer uma janela de tempo menor, como cinco minutos, durante o teste da chamada. 

Depois que todas as restrições forem atendidas, você poderá executar a chamada e obter um código de resposta HTTP 200 com as métricas do dispositivo:

 

Aqui estão algumas informações adicionais que podem ser necessárias:

Formato de payload XML para chamada de medição no nível do 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 todas as principais alterações do 10.x, consulte o seguinte: what-s-new-in-powermax-rest-api

Para RESTAPI, a documentação específica para sua versão do Unisphere pode ser coletada usando as etapas a seguir. Esta documentação pode ajudar a encontrar o que é necessário para chamadas e a estrutura de carga útil. 

1. Faça download do arquivo docs RESTAPI acessando:
   • Disponível em: https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • O UNIVMAX_IP é o endereço IP e UNIVMAX_PORT é a porta do host que executa o Unisphere.
2. Mova o arquivo para o local que você deseja manter a documentação.
3. Extraia o conteúdo do arquivo .zip.
4. Procure o arquivo chamado "index.html" na lista de arquivos extraídos.
5. Abra o "index.html":
   • Lembre-se de onde esse arquivo está, pois é assim que você acessa a documentação.
   • Ele deve abrir uma janela no seu navegador da web.

No momento da criação deste artigo da KB, as possíveis medições no nível do dispositivo são:

Os carimbos de data/hora EPOCH podem ser gerados em outros sites, como o EPOCHconverter. 
Lembre-se de que este NÃO é um site da Dell, portanto, a Dell não detém controle sobre sua funcionalidade ou suporte.