Unisphere for PowerMax 10.x: Jak získat metriky na úrovni zařízení prostřednictvím rozhraní RESTAPI

V tomto článku se dozvíte, jak shromažďovat metriky na úrovni zařízení prostřednictvím rozhraní REST API do Unisphere pro instance úložiště PowerMax 10.x.

Každé volání RESTAPI potřebuje tři věci:

• Adresa URL
• Typ hovoru A
• Datová část

Pokud chcete shromažďovat metriky objemu, adresa URL:

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

Typ hovoru je: POST
Datová část je pro JSON strukturovaná takto: (Informace o XML naleznete v části "Další informace")

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

Každé pole má své požadavky. To platí pro všechna volání, která používají tato pole: 

• "systemId" vyžaduje celých 12 číslic sériového čísla pole a musí být v uvozovkách.
• "volumeStartRange" i "volumeEndRange" vyžadují 5místné ID zařízení a musí být v uvozovkách. (Ano, můžete mít více než jednu.)
• "dateFormat" může být Maximum nebo Average, také v uvozovkách.
• "startDate" a "endDate" jsou časové razítko EPOCH v milisekundách (to zahrnuje datum a čas).
• "Metriky" Můžete uvést více metrik, ale musí být v uvozovkách a odděleny čárkou.

Tím, že máte platnou adresu URL, typ volání a datovou část, máte platné volání. Pro metriky objemu ale existují další omezení pro zařízení na back-endu:

• Svazek musí být v SG.
• SG musí být v MV.
• SG musí být v seznamu shromažďování metrik "Storage group real-time" v systémových registracích.
• Cesta k přidání SG do reálného času je: Nastavení >Představení>Registrace> systému Klikněte na schránku

• A konečně, časový rozsah NEMŮŽE být delší než 60 minut.
  • Při sestavování časů EPOCK v milisekundách se ujistěte, že počáteční a koncové datum nejsou od sebe vzdáleny více než 60 minut. 
  • Během testování hovorů se doporučuje provádět kratší časový interval, například pět minut. 

Po splnění všech omezení můžete spustit volání a získat kód odpovědi HTTP 200 s metrikami zařízení:

 

Tady je několik dalších informací, které mohou být potřeba:

Formát datové části XML pro volání metrik na úrovni zařízení:

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

Chcete-li zobrazit všechny hlavní změny verze 10.x, přečtěte si následující: what-s-new-in-powermax-rest-api

Pro rozhraní RESTAPI lze pomocí následujících kroků shromáždit dokumentaci specifickou pro vaši verzi Unisphere. Tato dokumentace vám může pomoct najít, co je potřeba pro volání a strukturu datové části. 

1. Stáhněte si soubor RESTAPI docs na adrese:
   • Zdroj: https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • UNIVMAX_IP je IP adresa a UNIVMAX_PORT port hostitele se spuštěným nástrojem Unisphere.
2. Přesuňte soubor do umístění, kam chcete uložit dokumentaci.
3. Rozbalte obsah souboru .zip.
4. V seznamu extrahovaných souborů vyhledejte soubor s názvem "index.html".
5. Otevřete okno "index.html":
   • Nezapomeňte, kde se tento soubor nachází, protože tak získáte přístup k dokumentaci.
   • Mělo by se otevřít okno ve vašem webovém prohlížeči.

V době vytvoření tohoto článku znalostní databáze jsou možné metriky na úrovni zařízení:

Časová razítka EPOCH lze generovat na jiných webových stránkách, jako je EPOCHconverter. 
Pamatujte, že se NEJEDNÁ o web společnosti Dell, takže společnost Dell nemá žádnou kontrolu nad jeho funkčností ani podporou.