Unisphere for PowerMax 10.x: Statistieken op apparaatniveau krijgen via RESTAPI

In dit artikel wordt beschreven hoe u metrische gegevens op apparaatniveau verzamelt via REST API naar Unisphere voor PowerMax 10.x-exemplaren.

Elke RESTAPI-oproep heeft drie dingen nodig:

• Een URL
• Een oproeptype
• Een payload

Voor het verzamelen van volumestatistieken is de URL:

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

Het gesprekstype is: POST
: De payload is als volgt gestructureerd voor JSON: (Voor XML, zie de sectie "Aanvullende informatie")

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

Elk vakgebied heeft eisen. Dit geldt voor alle oproepen met behulp van deze velden: 

• "systemId" vereist de volledige 12 cijfers van het serienummer van de array en moet tussen aanhalingstekens staan.
• "volumeStartRange" en "volumeEndRange" vereisen beide de 5-cijferige apparaat-ID en deze moet tussen aanhalingstekens staan. (Ja, u kunt er meer dan één hebben.)
• "dateFormat" kan Maximum of Average zijn, ook tussen aanhalingstekens.
• "startDate" en "endDate" zijn de EPOCH-tijdstempel in milliseconden (dit omvat de datum en tijd).
• "Metrics" U kunt meerdere statistieken vermelden, maar deze moeten tussen aanhalingstekens staan en gescheiden worden door een komma.

Door een geldige URL, gesprekstype en payload te hebben, hebt u een geldige oproep. Voor volumestatistieken zijn er echter aanvullende beperkingen voor het apparaat op de back-end:

• Het volume moet in een SG zijn.
• De SG moet in een MV zitten.
• De SG moet in de statistiekverzamelingslijst "Storagegroep realtime" staan in systeemregistraties.
• Het pad om een SG toe te voegen aan Real-time is: Instellingen >Voorstelling>Systeemregistratie> Klik op het klembord

• Ten slotte kan het tijdsbereik NIET meer dan 60 minuten zijn.
  • Wanneer u uw EPOCK-tijden in milliseconden samenstelt, moet u ervoor zorgen dat de begin- en einddatum niet meer dan 60 minuten uit elkaar liggen. 
  • Het wordt aanbevolen om tijdens het testen van oproepen een korter tijdvenster te gebruiken, zoals vijf minuten. 

Zodra aan alle beperkingen is voldaan, kunt u het gesprek uitvoeren en een HTTP 200-antwoordcode ontvangen met de apparaatstatistieken:

 

Hier is wat aanvullende informatie die mogelijk nodig is:

XML Payload-indeling voor metrische aanroep op apparaatniveau:

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

Raadpleeg het volgende om alle belangrijke wijzigingen met 10.x te zien: Wat is er nieuw in PowerMax-REST-API

Voor RESTAPI kan de documentatie die specifiek is voor uw Unisphere-versie worden verzameld met behulp van de volgende stappen. Deze documentatie kan helpen bij het vinden van wat nodig is voor oproepen en de payloadstructuur. 

1. Download het RESTAPI-documentenbestand door te gaan naar:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • De UNIVMAX_IP is het IP-adres en UNIVMAX_PORT is de poort van de host waarop Unisphere wordt uitgevoerd.
2. Verplaats het bestand naar de locatie waar u de documentatie wilt bewaren.
3. Pak de inhoud van het .zip bestand uit.
4. Zoek het bestand met de naam "index.html" in de lijst met uitgepakte bestanden.
5. Open het index.html:
   • Onthoud waar dit bestand zich bevindt, want dit is hoe u toegang krijgt tot de documentatie.
   • Het zou een venster in uw webbrowser moeten openen.

Op het moment dat dit KB-artikel wordt gemaakt, zijn de mogelijke metrische gegevens op apparaatniveau:

EPOCH-tijdstempels kunnen worden gegenereerd op andere websites zoals EPOCHconverter. 
Houd er rekening mee dat dit GEEN Dell site is, dus Dell heeft geen controle over de functionaliteit of ondersteuning ervan.