Partage via


Mettre à l’échelle automatiquement une instance du service Gestion des API Azure

S’APPLIQUE À : De base | Standard | Premium

Une instance du service Gestion des API Azure peut se mettre à l’échelle automatiquement en fonction d’un ensemble de règles. Ce comportement peut être activé et configuré via la mise à l’échelle automatique d’Azure Monitor.

Cet article décrit le processus de configuration de la mise à l’échelle automatique et suggère une configuration optimale des règles de cette mise à l’échelle.

Notes

  • Dans les niveaux de service qui prennent en charge plusieurs unités de mise à l’échelle, vous pouvez également mettre à l’échelle manuellement votre instance du service Gestion des API.
  • Un service Gestion des API dans le niveau Consommation est automatiquement mis à l’échelle en fonction du trafic, et ne nécessite pas de configuration supplémentaire.
  • Actuellement, la mise à l’échelle automatique n’est pas prise en charge pour la passerelle d’espace de travail dans les espaces de travail Gestion des API.

Prérequis

Pour suivre les étapes décrites dans cet article, vous devez :

Limitations de la mise à l’échelle automatique du service Gestion des API Azure

Certaines limitations et conséquences des décisions de mise à l’échelle doivent être prises en compte avant de configurer le comportement de mise à l’échelle automatique.

  • Le niveau tarifaire de votre instance Gestion des API détermine le nombre maximal d’unités qu’il est possible d’atteindre par une mise à l’échelle. Par exemple, le niveau Standard peut être mis à l’échelle vers 4 unités. Vous pouvez ajouter n’importe quel nombre d’unités au niveau Premium.
  • Le processus de mise à l'échelle prend au moins 20 minutes.
  • Si le service est verrouillé par une autre opération, la demande de mise à l’échelle échoue et une nouvelle tentative est effectuée automatiquement.
  • Si votre instance de service est déployée dans plusieurs régions (emplacements), seules les unités figurant dans l’emplacement principal peuvent être mises à l’échelle automatiquement avec la mise à l’échelle automatique Azure Monitor. Les unités dans d’autres emplacements ne peuvent être mises à l’échelle que manuellement.
  • Si votre instance de service est configurée avec des zones de disponibilité dans l’emplacement principal, tenez compte du nombre de zones lors de la configuration de la mise à l’échelle automatique. Le nombre d’unités de Gestion des API dans les règles et les limites de mise à l’échelle automatique doit être un multiple du nombre de zones.

Activer et configurer la mise à l’échelle automatique pour une instance du service Gestion des API

Suivez ces étapes pour configurer la mise à l’échelle automatique pour un service Gestion des API Azure :

  1. Connectez-vous au portail Azure et accédez à votre instance de Gestion des API.

  2. Dans le menu de gauche, sélectionnez Scale-out (mise à l’échelle automatique), puis sélectionnez Mise à l’échelle automatique personnalisée.

    Capture d’écran des options de scale-out dans le portail.

  3. Dans la condition de mise à l'échelle Par défaut, sélectionnez Mise à l'échelle selon une métrique, puis sélectionnez Ajouter une règle.

    Capture d’écran de la configuration de la condition de mise à l’échelle par défaut dans le portail.

  4. Définissez une nouvelle règle de scale-out.

    Par exemple, une règle de scale-out peut déclencher l’ajout d’une (1) unité de Gestion des API quand la métrique de capacité moyenne au cours des 30 minutes précédentes dépasse 70 %. Le tableau suivant présente un exemple de configuration d’une telle règle. Prenez en compte les limitations décrites plus haut quand vous configurez une règle de scale-out dans votre environnement.

    Paramètre Valeur Notes
    Source de la mesure Ressource actuelle Définissez la règle selon des métriques de la ressource Gestion des API actuelle.
    Critères
    Nom de métrique Capacité Une métrique de capacité est une métrique de gestion des API qui reflète l’utilisation des ressources par une instance du service Gestion des API Azure.
    Emplacement Sélectionnez l’emplacement principal de l’instance Gestion des API
    Opérateur Supérieur à
    Seuil de métrique 70 % Seuil pour la métrique de capacité moyenne. Pour plus d’informations sur la définition de ce seuil, consultez Utiliser la capacité pour les décisions de mise à l’échelle.
    Durée (en minutes) 30 L’intervalle de temps pour calculer la moyenne de la métrique de capacité est spécifique aux modèles d’utilisation. Plus la durée est longue, plus la réaction sera fluide. Les pics intermittents auront moins d’effet sur la décision de scale-out. Ceci va cependant retarder le déclenchement de la montée en puissance.
    Statistique de fragment de temps Moyenne
    Action
    Opération Augmenter le nombre de
    Nombre d’instances 1 Effectue un scale-out de l’instance de Gestion des API Azure de 1 unité.
    Refroidissement (minutes) 60 Au moins 20 minutes sont nécessaires pour effectuer un scale-out du service Gestion des API. Dans la plupart des cas, la période de retour au calme de 60 minutes empêche le déclenchement de nombreux scale-outs.
  5. Sélectionnez Ajouter pour enregistrer la règle.

  6. Pour ajouter une autre règle, sélectionnez Ajouter une règle.

    Cette fois, vous devez définir une règle de scale-in. Elle garantit que des ressources ne sont pas gaspillées quand l’utilisation des API diminue.

  7. Définissez une nouvelle règle de scale-in.

    Par exemple, une règle de scale-in peut déclencher la suppression d’une (1) unité de Gestion des API quand la métrique de capacité moyenne au cours des 30 minutes précédentes est inférieure à 35 %. Le tableau suivant présente un exemple de configuration d’une telle règle.

    Paramètre Valeur Notes
    Source de la mesure Ressource actuelle Définissez la règle selon des métriques de la ressource Gestion des API actuelle.
    Critères
    Agrégation du temps Moyenne
    Nom de métrique Capacité Métrique identique à celle utilisée pour la règle de scale-out.
    Emplacement Sélectionnez l’emplacement principal de l’instance Gestion des API
    Opérateur Inférieur à
    Seuil 35 % Comme pour la règle de scale-out, cette valeur dépend fortement des modèles d’utilisation de l’instance du service Gestion des API.
    Durée (en minutes) 30 Valeur identique à celle utilisée pour la règle de scale-out.
    Statistique de fragment de temps Moyenne
    Action
    Opération Diminuer le nombre de Le contraire de ce qui a été utilisé pour la règle de scale-out.
    Nombre d’instances 1 Valeur identique à celle utilisée pour la règle de scale-out.
    Refroidissement (minutes) 90 Le scale-in doit se faire de façon plus prudente qu’un scale-out : la période de retour au calme doit donc être plus longue.
  8. Sélectionnez Ajouter pour enregistrer la règle.

  9. Dans Limites de l’instance, sélectionnez les valeurs Minimum, Maximum et Par défaut des unités du service Gestion des API.

    Notes

    Le scale-out d’une instance du service Gestion des API est limité quant au nombre d’unités. La limite dépend du niveau de service.

    Capture d’écran montrant comment définir des limites d’instance dans le portail.

  10. Sélectionnez Enregistrer. Votre mise à l’échelle automatique est configurée.