Capacité d’une instance du service Gestion des API Azure
S’APPLIQUE À : Développeur | Essentiel | Essentiel v2 | Standard | Standard v2 | Premium
API Management fournit mesures Azure Monitor pour détecter l’utilisation de la capacité du système, ce qui vous aide à résoudre les problèmes de passerelle et à prendre des décisions éclairées pour mettre à l’échelle ou mettre à niveau une instance API Management pour prendre en charge plus de charge.
Cet article explique les mesures de capacité et leur comportement, montre comment accéder aux mesures de capacité dans le portail Azure et suggère quand envisager une mise à l’échelle ou une mise à niveau de votre instance d’API Management.
Remarque
Cette fonctionnalité n’est actuellement pas disponible dans les espaces de travail.
Important
Cet article explique comment surveiller et faire évoluer votre instance Azure API Management en fonction des mesures de capacité. Toutefois, lorsqu’une instance atteint sa capacité, elle n’est pas limitée pour empêcher la surcharge. Au lieu de cela, il agit comme un serveur web surchargé : latence accrue, connexions supprimées et erreurs de délai d’expiration. Les clients d’API doivent être prêts à gérer ces problèmes comme ils le font avec d’autres services externes, par exemple en utilisant des stratégies de nouvelle tentative.
Prérequis
Pour suivre les étapes décrites dans cet article, vous devez disposer d’une instance API Management dans l’un des niveaux qui prennent en charge les mesures de capacité. Pour en savoir plus, voir Créer une instance de gestion des API Azure.
Mesures de la capacité disponible
Différentes mesures de capacité sont disponibles dans les niveaux de service v2 et classiques.
Dans les niveaux v2, les mesures suivantes sont disponibles :
Pourcentage d’UC de la passerelle – pourcentage de capacité d’UC utilisée par les unités de passerelle.
Pourcentage de mémoire de la passerelle – Pourcentage de la capacité de mémoire utilisée par les unités de la passerelle.
Les agrégations disponibles pour ces mesures sont les suivantes.
- Moyenne : pourcentage moyen de capacité utilisé dans les processus de passerelle dans chaque unité d’une instance gestion des API.
- Max – pourcentage de capacité dans le processus de passerelle avec la plus grande consommation.
L’utilisation de la mémoire et de l’UC indique la consommation des ressources par :
- Les services de plan de données de Gestion des API, tels que le traitement des demandes, qui incluent le transfert de demandes ou l’exécution d’une stratégie.
- Les services de plan de gestion de Gestion des API, tels que les actions de gestion appliquées via le portail Azure ou Azure Resource Manager, ou une charge provenant du portail des développeurs.
- Les processus de système d’exploitation sélectionnés, y compris les processus qui impliquent le coût des négociations TLS sur les nouvelles connexions.
- Mises à jour de plateforme, telles que les mises à jour du système d’exploitation sur les ressources de calcul sous-jacentes pour l’instance.
- Nombre d’API déployées, indépendamment de l’activité, qui peuvent consommer de la capacité supplémentaire.
Comportement de la métrique de capacité
Dans la réalité, les mesures de capacité peuvent être influencées par de nombreuses variables, par exemple :
- des modèles de connexion (nouvelle connexion basée sur une requête ou réutilisation de la connexion existante)
- la taille d’une requête et d’une réponse
- des stratégies configurées sur chaque API ou le nombre de clients envoyant des requêtes.
Plus les opérations sur les requêtes sont complexes, plus la consommation de la capacité sera élevée. Par exemple, les stratégies de transformation complexes utilisent davantage d’UC qu’un simple transfert de requête. Les réponses de service principal lentes augmentent également la consommation.
Important
Les mesures de capacité ne sont pas des mesures directes du nombre de requêtes traitées.
Les mesures de capacité peuvent également connaître des pics intermittents ou être supérieures à zéro même si aucune requête n’est en cours de traitement. Cela se produit en raison d’actions propres au système ou à la plateforme et ne doit pas être pris en compte lorsque vous envisagez de mettre à l’échelle une instance.
Bien que les mesures de capacité soient conçues pour mettre en évidence les problèmes de votre instance d’API Management, il arrive que ces problèmes ne se traduisent pas par des changements dans ces mesures. En outre, des mesures de capacité faibles ne signifient pas nécessairement que votre instance d’API Management ne rencontre aucun problème.
Utiliser le Portail Azure pour étudier les mesures de capacité
Accédez aux mesures dans le portail pour comprendre la quantité de capacité utilisée au fil du temps.
- Accédez à votre instance APIM dans le portail Azure.
- Dans le menu de gauche, sous Supervision, sélectionnez Métriques.
- Sélectionnez le pourcentage d’UC de passerelle ou le pourcentage de mémoire de la mesure de passerelle dans les mesures disponibles. Choisissez l’agrégation moyenne par défaut ou sélectionnez l’agrégation Max pour voir l’utilisation maximale.
- Choisissez une plage horaire dans la barre supérieure de la section.
Important
Actuellement, la métrique de capacité apparaît également dans le portail pour les instances des niveaux v2. Toutefois, il n’est pas pris en charge pour une utilisation dans les niveaux v2 et affiche la valeur 0.
Remarque
Vous pouvez définir une alerte Métrique vous permettant de savoir à quel moment un événement inattendu survient. Par exemple, recevez des notifications lorsque votre instance d’API Management a dépassé le pic prévu d’utilisation de l’UC ou de la mémoire pendant plus de 20 minutes.
Utiliser la capacité pour les décisions de mise à l’échelle
Utilisez les mesures de capacité pour décider s’il faut faire évoluer une instance d’API Management pour répondre à une charge plus importante. Voici quelques considérations générales :
- Examinez les tendances à long terme et la moyenne.
- ignorez les pics soudains qui sont la plupart du temps liés à une augmentation de charge (consultez la section Comportement de la métrique de capacité pour plus d’informations).
- En règle générale, mettez à niveau ou faites évoluer votre instance lorsque la valeur d’une mesure de capacité dépasse 60 à 70 % pendant une longue période (par exemple, 30 minutes). Des valeurs différentes peuvent être plus adaptées à votre service ou scénario.
- Si votre instance est configurée avec une seule unité, mettez à niveau ou faites évoluer votre instance lorsqu’une valeur de mesure de capacité dépasse 40 % pendant une longue période. Cette recommandation est basée sur la nécessité de réserver de la capacité pour les mises à jour du système d’exploitation invité dans la plateforme de service sous-jacente.
Conseil
Si vous êtes en mesure d’estimer votre trafic au préalable, testez votre instance Gestion des API sur les charges de travail attendues. Vous pouvez augmenter progressivement la charge de la requête sur votre locataire, afin de déterminer la valeur de la métrique de capacité qui correspond à votre charge de pointe. Suivez les étapes de la section précédente pour utiliser le Portail Azure afin de déterminer la capacité consommée à un moment donné.