Partager via


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

APPLIES TO : Essentiel | Essentiel v2 | Standard | Standard v2 | Premium | Premium v2

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.

Important

Les modifications apportées à l’infrastructure de votre service Gestion des API (telles que la configuration de domaines personnalisés, l’ajout de certificats d’autorité de certification, la mise à l’échelle, la configuration du réseau virtuel, les modifications de zone de disponibilité et les ajouts de régions) peuvent prendre 15 minutes ou plus, en fonction du niveau de service et de la taille du déploiement. Attendez-vous à des temps plus longs pour une instance avec un plus grand nombre d’unités d’échelle ou de configuration multirégion. Les modifications propagées apportées à Gestion des API sont exécutées avec soin pour préserver la capacité et la disponibilité.

Pendant la mise à jour du service, d’autres modifications de l’infrastructure de service ne peuvent pas être apportées. Toutefois, vous pouvez configurer des API, des produits, des stratégies et des paramètres utilisateur. Le service n’aura pas de temps d’arrêt de passerelle et Gestion des API continuera à traiter les demandes d’API sans interruption (sauf dans le niveau Développeur).

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.
  • 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 d’autres emplacements peuvent être mises à l’échelle manuellement ou à l’aide d’outils de mise à l’échelle personnalisés.
  • Si votre instance de service est configurée avec des zones de disponibilité à l’emplacement principal, nous vous recommandons de laisser le paramètre automatique par défaut pour les zones de disponibilité. Si vous sélectionnez des zones spécifiques, le nombre d’unités Gestion des API dans les règles et limites de mise à l’échelle automatique doit être un multiple du nombre de zones configurées.

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 Déploiement + infrastructure>Mise à l’échelle (automatique), puis sélectionnez Autoscale personnalisé.

    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 Remarques
    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é La métrique de capacité est l’une des métriques Gestion des API reflétant l’utilisation des ressources par une instance Gestion des API Azure. Choisissez une métrique de capacité prise en charge dans votre niveau de service Gestion des API.
    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) soixante Dans la plupart des cas, la période de refroidissement de 60 minutes empêche de déclencher 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 Remarques
    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.