Unisphere for PowerMax 10.x: Abrufen von Metriken auf Geräteebene über REST API

In diesem Artikel wird beschrieben, wie Sie Metriken auf Geräteebene über die REST API in Unisphere for PowerMax 10.x-Instanzen erfassen.

Jeder RESTAPI-Aufruf benötigt drei Dinge:

• Eine URL
• Ein Anruftyp
• Eine Payload

Um Volume-Kennzahlen zu erfassen, lautet die URL:

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

Der Anruftyp ist: POST
Die Payload ist für JSON wie folgt strukturiert: (Informationen zu XML finden Sie im Abschnitt "Weitere Informationen")

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

Jedes Feld hat Anforderungen. Dies gilt für alle Aufrufe, die die folgenden Felder verwenden: 

• "systemId" erfordert die vollständigen 12 Ziffern der Arrayseriennummer und muss in Anführungszeichen stehen.
• "volumeStartRange" und "volumeEndRange" erfordern beide die 5-stellige Geräte-ID und müssen in Anführungszeichen stehen. (Ja, Sie können mehr als eine haben.)
• "dateFormat" kann Maximum oder Average sein, auch in Anführungszeichen.
• "startDate" und "endDate" sind der EPOCH-Zeitstempel in Millisekunden (dies deckt das Datum und die Uhrzeit ab).
• "Metriken" Sie können mehrere Metriken auflisten, aber sie müssen in Anführungszeichen stehen und durch ein Komma getrennt sein.

Wenn Sie eine gültige URL, einen gültigen Anruftyp und eine gültige Payload haben, haben Sie einen gültigen Anruf. Für Volume-Metriken gibt es jedoch zusätzliche Einschränkungen für das Gerät am Back-end:

• Das Volume muss sich in einer SG befinden.
• Die SG muss sich in einem MV befinden.
• Die Storage-Gruppe muss in der Metrikerfassungsliste "Storage group real-time" in den Systemregistrierungen enthalten sein.
• Der Pfad zum Hinzufügen einer Storage-Gruppe zu Echtzeit lautet: Einstellungen >Leistung>Systemregistrierung> Klicken Sie auf die Zwischenablage

• Schließlich darf der Zeitbereich NICHT mehr als 60 Minuten betragen.
  • Achten Sie bei der Erstellung Ihrer EPOCK-Zeiten in Millisekunden darauf, dass das Start- und Enddatum nicht mehr als 60 Minuten auseinander liegen. 
  • Es wird empfohlen, während des Anruftests ein kleineres Zeitfenster, z. B. fünf Minuten, durchzuführen. 

Sobald alle Einschränkungen erfüllt sind, können Sie den Aufruf ausführen und erhalten einen HTTP 200-Antwortcode mit den Gerätemetriken:

 

Hier sind einige zusätzliche Informationen, die möglicherweise benötigt werden:

XML-Payload-Format für Metrikaufruf auf Geräteebene:

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

Informationen zu allen wichtigen Änderungen in 10.x finden Sie unter: What-s-new-in-powermax-rest-api

Für RESTAPI kann die für Ihre Unisphere-Version spezifische Dokumentation mithilfe der folgenden Schritte erfasst werden. Diese Dokumentation kann dabei helfen, herauszufinden, was für Aufrufe und die Payload-Struktur erforderlich ist. 

1. Laden Sie die RESTAPI-Dokumentdatei herunter, indem Sie zu folgendem Befehl navigieren:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs (Englisch)
   • Das UNIVMAX_IP ist die IP-Adresse und UNIVMAX_PORT ist der Port des Hosts, auf dem Unisphere ausgeführt wird.
2. Verschieben Sie die Datei an den Speicherort, an dem die Dokumentation aufbewahrt werden soll.
3. Extrahieren Sie den Inhalt der .zip Datei.
4. Suchen Sie in der Liste der extrahierten Dateien nach der Datei mit dem Namen "index.html".
5. Öffnen Sie die "index.html":
   • Merken Sie sich, wo diese Datei ist, da Sie auf diese Weise auf die Dokumentation zugreifen.
   • Es sollte sich ein Fenster in Ihrem Webbrowser öffnen.

Zum Zeitpunkt der Erstellung dieses KB-Artikels sind folgende Kennzahlen auf Geräteebene möglich:

EPOCH-Zeitstempel können auf anderen Websites wie EPOCHconverter generiert werden. 
Beachten Sie, dass es sich hierbei NICHT um eine Website von Dell handelt, sodass Dell keine Kontrolle über deren Funktionalität oder Support hat.