Problèmes rencontrés avec les clients API REST et Embedded Unisphere
Summary: Problèmes rencontrés avec les clients externes de l’API REST et Unisphere intégré
Symptoms
Les symptômes de ce problème varient.
Un trop grand nombre d’appels du client API Rest peut entraîner les problèmes ci-dessous
- Écarts dans les données de performance dans les tableaux de bord des métriques Unisphere,
- Unisphere affiche régulièrement qu’une baie n’est pas enregistrée sur l’interface graphique.
- En particulier, les services mis hors ligne sur le conteneur intégré PR_Storstpd.
Pour résoudre ces symptômes, un examen du journal de l’API Rest est nécessaire.
Cette option n’est pas activée par défaut pour activer cette option , accédez à Unisphere > support> modify server logging > enable RestApi> logs cochez cette case.
Cette opération ne peut pas être effectuée à partir de la baie et doit être activée par le client à partir de son Unisphere intégré. Voir les captures d’écran ci-dessous pour le chemin
Une fois cette option activée, un fichier sous le dossier /server0 à partir d’un emcgrab à partir de vapp Manager ou smas.logs aura un fichier appelé restapi généré.
Cause
Ces problèmes peuvent être dus au non-respect des pratiques d’excellence décrites ci-dessous dans le Guide d’installation de Unisphere for PowerMax. (voir résolution)
Une autre cause peut être que les points de terminaison versionnés ne sont pas utilisés comme indiqué ci-dessous
. Pris en charge :/92/sloprovisioning/symmetrix/
Non pris en charge :/sloprovisioning/symmetrix/
Un autre facteur à prendre en compte est s’il y a des appels d’API répétés avec un nombre de MS par rapport à la moyenne, voir ci-dessous 2021-06-30 11:10:55,510 INFO [em.bp.RESTAPIUSAGE] (default task-46) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.x.xxx GET 314 ms 200 null null null2021-06-30 11:11:35,937 INFO [em.bp.RESTAPIUSAGE] (default task-43) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 299 ms 200 null null null2021-06-30 11:11:35,938 INFO [em.bp.RESTAPIUSAGE] (default task-37) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.x.xx.xx GET 327 ms 200 null null null2021-06-30 11:11:35,939 INFO [em.bp.RESTAPIUSAGE] (default task-19) 2021-06-30 10:55:55,533 INFO [em.bp.RESTAPIUSAGE] (default task-32) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 320 ms 200 null null null2021-06-30 10:55:55,534 INFO [em.bp.RESTAPIUSAGE] (default task-10) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 320 ms 200 null null null2021-06-30 10:56:35,795 INFO [em.bp.RESTAPIUSAGE] (default task-14) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 40584 ms 200 null null null2021-06-30 10:56:35,795 INFO [em.bp.RESTAPIUSAGE] (default task-15) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 40584 ms 200 null null null2021-06-30 10:56:35,798 INFO [em.bp.RESTAPIUSAGE] (default task-34) /sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId} UNKNOWN/10.xx.xx.xx GET 40454 ms 200 null null
L’exemple ci-dessus n’est pas non plus pris en charge, car il ne s’agit pas d’un point de terminaison versionné, voir/.sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId}
Cela devrait être 92/sloprovisioning/symmetrix/{symmetrixId}/volume/{volumeId}
Resolution
Assurez-vous que les pratiques d’excellence sont suivies avec les appels de l’API REST. Voir le Guide d’installation de Unisphere for PowerMax 9.2.1 et versions antérieures
Unisphere for PowerMax prend en charge jusqu’à 10 utilisateurs simultanés, avec une certaine dégradation des performances se produisant avec plus de 5
utilisateurs administrateurs de stockage.
Notez les recommandations suivantes sur les limites du client API REST, qui doivent être respectées afin d’obtenir des performances optimales
:
● Chaque session d’API REST compte comme un utilisateur simultané pendant que les appels REST sont en cours d’exécution.
● 5 clients API REST maximum peuvent se connecter simultanément au serveur Unisphere.
● Un maximum de 50 appels GET par seconde peuvent être effectués sur le serveur Unisphere. Ceux-ci peuvent être constitués d’appels GET API REST
performants et d’appels GET API REST non performants.
● Un maximum de 5 appels POST ou PUT non performants peuvent être exécutés simultanément sur le serveur Unisphere.
● Il est recommandé d’utiliser des appels d’API REST en bloc, dans la mesure du possible.
REMARQUE : Si les recommandations ci-dessus ne sont pas suivies, une dégradation des performances du serveur Unisphere for PowerMax peut survenir.
Assurez-vous que les points de terminaison versionnés sont également utilisés