Unisphere dla PowerMax 10.x: Jak uzyskać metryki na poziomie urządzenia za pomocą RESTAPI

W tym artykule omówiono sposób zbierania metryk na poziomie urządzenia za pośrednictwem interfejsu API REST do instancji Unisphere for PowerMax 10.x.

Każde wywołanie RESTAPI wymaga trzech rzeczy:

• Adres URL
• Typ połączenia
• Ładunek danych

Aby zebrać metryki woluminu, adres URL to:

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

Typ połączenia to: POST
Ładunek danych w formacie JSON ma następującą strukturę: (W przypadku języka XML zobacz sekcję "Informacje dodatkowe")

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

Każde pole ma wymagania. Dotyczy to wszystkich połączeń wykorzystujących następujące pola: 

• Wartość "systemId" wymaga pełnych 12 cyfr numeru seryjnego macierzy i musi być ujęta w cudzysłów.
• "volumeStartRange" i "volumeEndRange" wymagają 5-cyfrowego identyfikatora urządzenia i muszą być podane w cudzysłowie. (Tak, możesz mieć więcej niż jedną).
• "dateFormat" może mieć wartość maksymalną lub średnią, również w cudzysłowie.
• "startDate" i "endDate" to znacznik czasu EPOCH w milisekundach (obejmuje to datę i godzinę).
• "Metryki" Możesz podać wiele wskaźników, ale muszą one być podane w cudzysłowie i oddzielone przecinkami.

Mając prawidłowy adres URL, typ wywołania i ładunek, masz prawidłowe wywołanie. Jednak w przypadku metryk woluminów istnieją dodatkowe ograniczenia dotyczące urządzenia na zapleczu:

• Wolumin musi znajdować się w grupie pamięci masowej.
• Grupa pamięci masowej musi znajdować się w MV.
• Grupa pamięci masowej musi znajdować się na liście zbierania metryk "Grupa pamięci masowej w czasie rzeczywistym" w rejestracjach systemów.
• Ścieżka dodawania grupy pamięci masowej do czasu rzeczywistego jest następująca: Ustawienia >Wydajność>Rejestracja> systemu Kliknij schowek

• Wreszcie, zakres czasowy NIE MOŻE być dłuższy niż 60 minut.
  • Tworząc czasy EPOCK w milisekundach, upewnij się, że daty rozpoczęcia i zakończenia nie są oddalone od siebie o więcej niż 60 minut. 
  • Zaleca się wykonanie mniejszego okna czasowego, takiego jak pięć minut, podczas testowania połączenia. 

Po spełnieniu wszystkich ograniczeń możesz uruchomić połączenie i uzyskać kod odpowiedzi HTTP 200 z metrykami urządzenia:

 

Oto kilka dodatkowych informacji, które mogą być potrzebne:

Format ładunku XML dla wywołania metryki na poziomie urządzenia:

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

Aby zobaczyć wszystkie główne zmiany w wersji 10.x, zapoznaj się z następującymi artykułami: what-s-new-in-powermax-rest-api

W przypadku RESTAPI można zebrać dokumentację dotyczącą danej wersji Unisphere, wykonując następujące czynności. Ta dokumentacja może pomóc w znalezieniu tego, co jest potrzebne do wywołań i struktury ładunku. 

1. Pobierz plik z dokumentacją RESTAPI, przechodząc do:
   • Źródło: https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • UNIVMAX_IP to adres IP, a UNIVMAX_PORT to port hosta z oprogramowaniem Unisphere.
2. Przenieś plik do lokalizacji, w której chcesz zachować dokumentację.
3. Wyodrębnij zawartość pliku .zip.
4. Poszukaj pliku o nazwie "index.html" na liście wyodrębnionych plików.
5. Otwórz okno "index.html":
   • Pamiętaj, gdzie znajduje się ten plik, ponieważ w ten sposób uzyskasz dostęp do dokumentacji.
   • Powinien otworzyć okno w przeglądarce internetowej.

W momencie tworzenia tego artykułu bazy wiedzy możliwe metryki na poziomie urządzenia to:

Znaczniki czasu EPOCH można wygenerować na innych stronach internetowych, takich jak EPOCHconverter. 
Należy pamiętać, że NIE jest to witryna firmy Dell, więc firma Dell nie ma kontroli nad jej funkcjonalnością ani pomocą techniczną.