Unisphere per PowerMax 10.x: Come ottenere metriche a livello di dispositivo tramite RESTAPI

Questo articolo esamina come raccogliere metriche a livello di dispositivo tramite l'API REST su istanze di Unisphere for PowerMax 10.x.

Ogni chiamata RESTAPI richiede tre elementi:

• Un URL
• Tipo di chiamata A
• Un payload

Per raccogliere le metriche del volume, l'URL è:

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

Il tipo di chiamata è: POST
Il payload è strutturato come segue per JSON: (Per i file XML, vedere la sezione "Informazioni aggiuntive")

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

Ogni campo ha dei requisiti. Ciò vale per tutte le chiamate che utilizzano questi campi: 

• "systemId" richiede tutte le 12 cifre del numero di serie dell'array e deve essere racchiuso tra virgolette.
• "volumeStartRange" e "volumeEndRange" richiedono entrambi l'ID dispositivo a 5 cifre e deve essere racchiuso tra virgolette. (Sì, puoi averne più di uno.)
• "dateFormat" può essere Massimo o Medio, anche tra virgolette.
• "startDate" e "endDate" sono i timestamp di EPOCH in millisecondi (questo copre la data e l'ora).
• "Metriche" È possibile elencare più metriche, ma devono essere racchiuse tra virgolette e separate da una virgola.

Con un URL, un tipo di chiamata e un payload validi, si dispone di una chiamata valida. Tuttavia, per le metriche dei volumi, esistono ulteriori restrizioni per il dispositivo sul back-end:

• Il volume deve essere in uno SG.
• Il gruppo di storage deve trovarsi in un MV.
• Il gruppo di storage deve essere incluso nell'elenco di raccolta delle metriche "Storage group real-time" nelle registrazioni di sistema.
• Il percorso per aggiungere uno SG a Real-time è: Impostazioni >Prestazione>Registrazione> del sistema Fare clic sugli appunti

• Infine, l'intervallo di tempo NON può essere superiore a 60 minuti.
  • Quando si creano i tempi EPOCK in millisecondi, assicurarsi che le date di inizio e fine non distinguano più di 60 minuti. 
  • Si consiglia di eseguire una finestra temporale inferiore, ad esempio cinque minuti, durante il test delle chiamate. 

Una volta soddisfatte tutte le restrizioni, è possibile eseguire la chiamata e ottenere un codice di risposta HTTP 200 con le metriche del dispositivo:

 

Di seguito sono riportate alcune informazioni aggiuntive che potrebbero essere necessarie:

Formato payload XML per la chiamata alle metriche a livello di 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>

Per visualizzare tutte le modifiche principali con la versione 10.x, fare riferimento a quanto segue: What-s-new-in-powermax-rest-api

Per RESTAPI, la documentazione specifica per la versione di Unisphere può essere raccolta utilizzando la seguente procedura. Questa documentazione può aiutare a trovare ciò che è necessario per le chiamate e la struttura del payload. 

1. Scaricare il file della documentazione RESTAPI accedendo a:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • Il UNIVMAX_IP è l'indirizzo IP e UNIVMAX_PORT è la porta dell host che esegue Unisphere.
2. Spostare il file nella posizione in cui si desidera conservare la documentazione.
3. Estrarre il contenuto .zip file.
4. Cercare il file denominato "index.html" nell'elenco dei file estratti.
5. Aprire il "index.html":
   • Ricordare dove si trova questo file, in quanto è così che si accede alla documentazione.
   • Dovrebbe aprirsi una finestra nel tuo browser web.

Al momento della creazione di questo articolo della Knowledge Base, le metriche possibili a livello di dispositivo sono:

I timestamp EPOCH possono essere generati su altri siti Web come EPOCHconverter. 
Tenere presente che questo NON è un sito Dell, pertanto Dell non detiene alcun controllo sulla sua funzionalità o supporto.