Mise à l'échelle automatique avec des politiques basées sur des règles

Les politiques de dimensionnement basées sur des règles d'Amazon GameLift offrent un contrôle précis lors du dimensionnement automatique de la capacité d'une flotte en réponse à l'activité des joueurs. Pour chaque politique, vous pouvez associer la mise à l'échelle à l'une des nombreuses mesures de la flotte, identifier un point de déclenchement et personnaliser l'événement d'augmentation ou de réduction d'échelle correspondant. Les politiques basées sur des règles sont utiles pour compléter la mise à l'échelle basée sur des objectifs afin de faire face à des circonstances particulières.

Une politique basée sur des règles stipule ce qui suit : « Si un indicateur de flotte atteint ou dépasse une valeur seuil pendant un certain temps, modifiez la capacité de la flotte d'une quantité spécifiée. » Cette rubrique décrit la syntaxe utilisée pour construire une déclaration de stratégie et fournit une aide pour la création et la gestion de vos règles basées sur des règles.

Gérer les stratégies basées sur des règles

Créez, mettez à jour ou supprimez des politiques basées sur des règles à l'aide d'un AWS SDK ou du AWS Command Line Interface (AWS CLI) avec l'API de service Amazon GameLift. Vous pouvez consulter toutes les politiques actives dans la GameLift console Amazon.

Pour arrêter temporairement toutes les politiques de dimensionnement d'une flotte, utilisez la AWS CLI commande stop-fleet-actions.

Pour créer ou mettre à jour une politique de dimensionnement basée sur des règles () AWS CLI :

1. Définissez les limites de capacité. Définissez l'une des valeurs limites ou les deux à l'aide de la update-fleet-capacitycommande. Pour plus d'informations, veuillez consulter Définissez les limites GameLift de capacité d'Amazon.

2. Créez une stratégie. Ouvrez une fenêtre de ligne de commande et utilisez la put-scaling-policycommande avec les paramètres de votre politique. Pour mettre à jour une stratégie existante, spécifiez le nom de la stratégie et indiquez une version complète de la stratégie mise à jour.

   --fleet-id <unique fleet identifier>
   --name "<unique policy name>"
   --policy-type <target- or rule-based policy>
   --metric-name <name of metric>
   --comparison-operator <comparison operator>
   --threshold <threshold integer value>
   --evaluation-periods <number of minutes>
   --scaling-adjustment-type <adjustment type>
   --scaling-adjustment <adjustment amount>

   Exemple :

   aws gamelift put-scaling-policy \
       --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
       --name "Scale up when AGS<50" \
       --policy-type RuleBased \
       --metric-name AvailableGameSessions \
       --comparison-operator LessThanThreshold \
       --threshold 50 \
       --evaluation-periods 10 \
       --scaling-adjustment-type ChangeInCapacity \
       --scaling-adjustment 1            

Pour supprimer une politique de dimensionnement basée sur des règles à l'aide de : AWS CLI

• Ouvrez une fenêtre de ligne de commande et utilisez la delete-scaling-policycommande avec l'ID du parc et le nom de la politique.

  Exemple :

  aws gamelift delete-scaling-policy \
      --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
      --name "Scale up when AGS<50"

Syntaxe pour les règles de mise à l'échelle automatique

Pour élaborer une déclaration de politique de dimensionnement basée sur des règles, spécifiez six variables :

Si <nom de métrique> demeure <opérateur de comparaison> <valeur de seuil> pour <période d'évaluation>, remplacez la capacité de la flotte en utilisant <type d'ajustement> sur/par <valeur d'ajustement>.

Par exemple, cette déclaration de politique lance un événement de mise à l'échelle chaque fois que la capacité supplémentaire d'une flotte est inférieure à ce qui est nécessaire pour gérer 50 nouvelles sessions de jeu :

Si AvailableGameSessions reste à less than 50 pendant 10 minutes, modifier à la capacité de la flotte avec ChangeInCapacity par 1 instances.

Nom de la métrique

Pour démarrer un événement de dimensionnement, associez une politique de dimensionnement automatique à l'une des mesures spécifiques au parc suivantes. Pour une description complète des mesures, reportez-vous à la sectionGameLiftMétriques Amazon pour les flottes.

• Activation de sessions de jeu

• Sessions de jeu actives

• Sessions de jeu disponibles

• Pourcentage de sessions de jeu disponibles

• Instances actives

• Sessions de joueur disponibles

• Sessions de joueur actuelles

• Instances inactives

• Pourcentage d'instances inactives

Si la flotte se trouve dans une file d'attente de session de jeu, vous pouvez utiliser les statistiques suivantes :

• Profondeur de la file d'attente : nombre de demandes de sessions de jeu en attente pour lesquelles cette flotte est la meilleure solution d'hébergement disponible.

• Temps d'attente — Temps d'attente propre à la flotte. Durée pendant laquelle la demande de session de jeu plus ancienne attend d'être traitée. Le temps d'attente d'une flotte correspond à la durée passée en file d'attente de la plus ancienne demande actuelle.

Opérateur de comparaison

Indique à Amazon GameLift comment comparer les données métriques à la valeur du seuil. Les opérateurs de comparaison valides incluent supérieur à (>), inférieur à (= <), greater than or equal (>) et inférieur ou égal (<=).

Valeur de seuil

Lorsque la valeur de métrique spécifiée atteint ou dépasse la valeur seuil, un événement de mise à l'échelle démarre. Cette valeur est toujours un nombre entier positif.

Période d'évaluation

La métrique doit atteindre ou dépasser la valeur seuil pendant toute la durée de la période d'évaluation avant de démarrer un événement de dimensionnement. La longueur de la période d'évaluation est consécutive ; si la métrique s'écarte du seuil, la période d'évaluation recommence.

Type et valeur d'ajustement

Cet ensemble de variables fonctionne ensemble pour spécifier la manière dont Amazon GameLift doit ajuster la capacité de la flotte lorsqu'un événement de dimensionnement commence. Choisissez parmi trois types de réglage possibles :

• Modification de la capacité : augmentez ou diminuez la capacité actuelle d'un nombre spécifié d'instances. Définissez la valeur d'ajustement en fonction du nombre d'instances à ajouter ou à retirer du parc. Les valeurs positives ajoutent des instances, tandis que les valeurs négatives retirent des instances. Par exemple, une valeur de « -10 » permet de réduire le parc de 10 instances, quelle que soit la taille totale du parc.

• Pourcentage de variation de la capacité — Augmentez ou diminuez la capacité actuelle d'un pourcentage spécifié. Définissez la valeur d'ajustement en fonction du pourcentage dont vous souhaitez augmenter ou diminuer la capacité du parc. Les valeurs positives ajoutent des instances, tandis que les valeurs négatives retirent des instances. Par exemple, pour un parc de 50 instances, une variation en pourcentage de « 20 » ajoute 10 instances au parc.

• Capacité exacte : augmentez ou diminuez la capacité actuelle jusqu'à une valeur spécifique. Définissez la valeur d'ajustement sur le nombre exact d'instances que vous voulez maintenir dans le parc.

Conseils pour une mise à l'échelle automatique basée sur des règles

Les suggestions suivantes peuvent vous aider à tirer le meilleur parti du dimensionnement automatique grâce à des politiques basées sur des règles.

Utilisation de plusieurs stratégies

Vous pouvez appliquer simultanément plusieurs politiques de mise à l'échelle automatique pour un parc. Le scénario le plus courant consiste à avoir une stratégie basée sur la cible pour gérer la plupart des besoins de dimensionnement et d'utiliser des stratégies basées sur des règles pour gérer les cas limites. Il n'y a aucune limite à l'utilisation de plusieurs politiques.

Dans le cas de stratégies multiples, chaque stratégie se comporte de manière indépendante. Il n'existe aucun moyen de contrôler la séquence des événements de dimensionnement. Par exemple, si plusieurs règles régissent la mise à l'échelle, il est possible que l'activité des joueurs déclenche simultanément plusieurs événements de mise à l'échelle. Évitez les politiques qui se déclenchent mutuellement. Par exemple, vous pouvez créer une boucle infinie si vous créez des politiques d'augmentation et de réduction qui fixent la capacité au-delà du seuil correspondant l'une à l'autre.

Définir une capacité maximale et minimale

Chaque parc comporte une limite de capacité maximale et minimale. Cette fonctionnalité est importante lors de l'utilisation de la mise à l'échelle automatique. La mise à l'échelle automatique ne définit jamais la capacité à une valeur en dehors de cette plage. Par défaut, les flottes nouvellement créées ont un minimum de 0 et un maximum de 1. Pour que votre politique de dimensionnement automatique affecte la capacité comme prévu, augmentez la valeur maximale.

La capacité du parc est également limitée par les limites du type d'instance du parc et par les quotas de service de votreCompte AWS. Vous ne pouvez pas définir de minimum et de maximum en dehors de ces limites et de ces quotas de compte.

Métriques de suivi après une modification de la capacité

Après avoir modifié la capacité en réponse à une politique de mise à l'échelle automatique, Amazon GameLift attend 10 minutes avant de répondre aux déclencheurs de la même politique. Cette attente donne à Amazon le GameLift temps d'ajouter les nouvelles instances, de lancer les serveurs de jeu, de connecter les joueurs et de commencer à collecter des données à partir des nouvelles instances. Pendant ce temps, Amazon GameLift évalue la politique par rapport à la métrique et suit la période d'évaluation de la politique, qui recommence après un événement de mise à l'échelle. Cela signifie qu'une politique de dimensionnement peut lancer un autre événement de dimensionnement immédiatement après la fin du délai d'attente.

Il n'y a pas de temps d'attente entre les événements de dimensionnement et le début des différentes politiques de dimensionnement automatique.