Unisphere til PowerMax 10.x: Sådan får du målinger på enhedsniveau via RESTAPI

I denne artikel gennemgås, hvordan du indsamler målepunkter på enhedsniveau via REST API til Unisphere for PowerMax 10.x-forekomster.

Hvert RESTAPI-kald har brug for tre ting:

• En URL-adresse
• En opkaldstype
• En nyttelast

Hvis du vil indsamle volumenmetrics, er webadressen:

• https://< IPorFQDN>:8443/univmax/restapi/ydeevne/volumen/målinger

Opkaldstypen er: POST
Dataene er struktureret på følgende måde for JSON: (Se afsnittet "Yderligere oplysninger" for XML)

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

Hvert felt har krav. Dette gælder for alle opkald, der bruger disse felter: 

• "systemId" kræver de fulde 12 cifre i systemets serienummer og skal være angivet i anførselstegn.
• "volumeStartRange" og "volumeEndRange" kræver begge det 5-cifrede enheds-id, og det skal være i anførselstegn. (Ja, du kan have mere end én).
• "dateFormat" kan være Maksimum eller Gennemsnit, også i anførselstegn.
• "startDate" og "endDate" er EPOCH-tidsstemplet i millisekunder (dette dækker dato og klokkeslæt).
• "Metrics" Du kan angive flere metrics, men de skal være i anførselstegn og adskilt med et komma.

Ved at have en gyldig URL, opkaldstype og nyttelast har du et gyldigt opkald. For volumenmålinger er der dog yderligere begrænsninger for enheden på backend:

• Lydstyrken skal være i en SG.
• SG skal være i en MV.
• SG skal være på listen "Storage group real-time" i systemregistreringer.
• Stien til at tilføje en SG til realtid er: Indstillinger >Præstation>Systemregistrering> Klik på udklipsholderen

• Endelig kan tidsintervallet IKKE være mere end 60 minutter.
  • Når du opbygger dine EPOCK-tider i millisekunder, skal du sørge for, at der ikke er mere end 60 minutter mellem start- og slutdatoerne. 
  • Det anbefales at foretage et kortere tidsvindue, f.eks. fem minutter, under opkaldstest. 

Når alle begrænsningerne er opfyldt, kan du køre opkaldet og få en HTTP 200-svarkode med enhedsmålingerne:

 

Her er nogle yderligere oplysninger, der kan være nødvendige:

XML-dataformat til opkald på enhedsniveau:

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

Hvis du vil se alle de større ændringer i 10.x, skal du se følgende: Hvad er nyt i powermax-rest-api

For RESPAI kan den dokumentation, der er specifik for din Unisphere-version, indsamles ved hjælp af følgende trin. Denne dokumentation kan hjælpe dig med at finde ud af, hvad der skal bruges til opkald og datastrukturen. 

1. Download RESTAPI-dokumentationsfilen ved at gå til:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • Den UNIVMAX_IP er IP-adressen, og UNIVMAX_PORT er porten på værten, der kører Unisphere.
2. Flyt filen til den placering, hvor du vil beholde dokumentationen.
3. Udpak indholdet af den .zip fil.
4. Se efter filen med navnet "index.html" på listen over udpakkede filer.
5. Åbn "index.html":
   • Husk, hvor denne fil er, da det er sådan, du får adgang til dokumentationen.
   • Det skal åbne et vindue i din webbrowser.

På tidspunktet for oprettelsen af denne KB-artikel er de mulige metrikværdier på enhedsniveau:

EPOCH-tidsstempler kan genereres på andre websteder som EPOCHconverter. 
Husk, at dette IKKE er et Dell-websted, så Dell har ingen kontrol over dets funktionalitet eller support.