Unisphere pour PowerMax 10.x : Comment obtenir des statistiques au niveau de l’appareil via l’API REST

Cet article explique comment collecter des métriques au niveau de l’appareil via l’API REST sur des instances Unisphere for PowerMax 10.x.

Chaque appel RESTAPI requiert trois éléments :

• Une URL
• Un type d’appel
• Une charge utile

Pour collecter des metrics de volume, l’URL est la suivante :

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

Le type d’appel est : POST
La charge utile est structurée comme suit pour JSON : (Pour XML, reportez-vous à la section « Informations supplémentaires »)

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

Chaque champ est assorti d’exigences. Cela s’applique à tous les appels utilisant les champs suivants : 

• « systemId » requiert les 12 chiffres complets du numéro de série de la baie et doit être entre guillemets.
• « volumeStartRange » et « volumeEndRange » nécessitent tous deux l’ID de périphérique à 5 chiffres et il doit être entre guillemets. (Oui, vous pouvez en avoir plusieurs.)
• « dateFormat » peut être Maximum ou Average, également entre guillemets.
• « startDate » et « endDate » sont l’horodatage EPOCH en millisecondes (il couvre la date et l’heure).
• « Metrics » Vous pouvez lister plusieurs metrics, mais ils doivent être entre guillemets et séparés par une virgule.

En ayant une URL, un type d’appel et une charge utile valides, vous disposez d’un appel valide. Toutefois, pour les metrics de volume, il existe des restrictions supplémentaires pour le périphérique sur le back-end :

• Le volume doit se trouver dans un SG.
• Le SG doit se trouver dans un MV.
• Le groupe de stockage doit se trouver dans la liste de collecte de metrics « Groupe de stockage en temps réel » dans les enregistrements du système.
• Le chemin à suivre pour ajouter un SG à Real-time est le suivant : Paramètres >Performance>Enregistrement> du système Cliquez sur le presse-papiers

• Enfin, la plage horaire NE PEUT PAS dépasser 60 minutes.
  • Lorsque vous créez vos temps EPOCK en millisecondes, assurez-vous que les dates de début et de fin ne sont pas séparées de plus de 60 minutes. 
  • Il est recommandé de réduire la période, par exemple cinq minutes, lors des tests d’appel. 

Une fois toutes les restrictions respectées, vous pouvez exécuter l’appel et obtenir un code de réponse HTTP 200 avec les métriques de l’appareil :

 

Voici quelques informations supplémentaires qui peuvent être nécessaires :

Format de charge utile XML pour l’appel de mesure au niveau de l’appareil :

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

Pour afficher toutes les modifications majeures apportées à la version 10.x, reportez-vous aux sections suivantes : nouveautés-de-la-capacité-de-powermax-rest-api

Pour l’API REST, vous pouvez collecter la documentation spécifique à votre version de Unisphere en procédant comme suit. Cette documentation peut vous aider à trouver ce qui est nécessaire pour les appels et la structure de la charge utile. 

1. Téléchargez le fichier de documentation de l’API REST en accédant à :
   • https ://UNIVMAX_IP :UNIVMAX_PORT/univmax/restapi/docs (en anglais seulement)
   • Le UNIVMAX_IP est l’adresse IP et UNIVMAX_PORT est le port de l’hôte exécutant Unisphere.
2. Déplacez le fichier à l’emplacement où vous souhaitez conserver la documentation.
3. Extrayez le contenu du fichier .zip.
4. Recherchez le fichier nommé « index.html » dans la liste des fichiers extraits.
5. Ouvrez le « index.html » :
   • Souvenez-vous de l’emplacement de ce fichier, car c’est ainsi que vous accédez à la documentation.
   • Une fenêtre devrait s’ouvrir dans votre navigateur Web.

Au moment de la création de cet article de la base de connaissances, les mesures possibles au niveau de l’appareil sont les suivantes :

Les horodatages EPOCH peuvent être générés sur d’autres sites Web comme EPOCHconverter. 
Gardez à l’esprit qu’il ne s’agit PAS d’un site Dell. Dell n’a donc aucun contrôle sur ses fonctionnalités ou son support.