Design a game session queue - Amazon GameLift

Design a game session queue

This topic describes how to design a queue that delivers a player experience with minimal latency and that efficiently uses hosting resources. For more information about game session queues and how they work, see Setting up Amazon GameLift queues for game session placement.

These Amazon GameLift features require queues:

Define your queue's scope

Your game's player population might have groups of players who shouldn't play together. For example, if you publish your game in two languages each language should have it's own game servers.

To set up game session placement for your player population, create a separate queue for each player segment. Scope each queue to place players into the correct game servers. Some common ways to scope queues include:

  • By geographic locations. When deploying your game servers in multiple geographic areas, you might build queues for players in each location to reduce player latency.

  • By build or script variations. If you have more than one variation of your game server, you might be supporting player groups that can't play in the same game sessions. For example, game server builds or scripts might support different languages or device types.

  • By event types. You might create a special queue to manage games for participants in tournaments or other special events.

Create a player latency policy

If your placement requests include player latency data, the algorithm finds game sessions in locations with the lowest average latency for all players. Placing game sessions based on average player latency prevents Amazon GameLift from placing most players in games with high latency. However, Amazon GameLift still places players with extreme latency. To accommodate these players, create player latency policies.

A player latency policy prevents Amazon GameLift from placing a requested game session anywhere that players in the request would experience latency over the maximum value. Player latency policies can also prevent Amazon GameLift from matching game session requests with higher latency players.


To manage latency specific rules, such as requiring similar latency across all players in a group, you can use Amazon GameLift FlexMatch to create latency-based matchmaking rules.

For example, consider this queue with a 5-minute timeout and the following player latency policies:

  1. Spend 120 seconds searching for a location where all player latencies are less than 50 milliseconds.

  2. Spend 120 seconds searching for a location where all player latencies are less than 100 milliseconds.

  3. Spend the remaining queue time until timeout searching for a location where all player latencies are less than 200 milliseconds.

An example screen in the console configuring the queue described previously.

Build a multi-location queue

We recommend a multi-location design for all queues. This design can improve placement speed and hosting resiliency. A multi-location design is required to use player latency data to put players into game sessions with minimal latency. If you're building multi-location queues that use Spot Instance fleets, follow the instructions in Tutorial: Set up a game session queue for Spot Instances.

One way to create a multi-location queue is to add a multi-location fleet to a queue. That way, the queue can place game sessions in any of the fleet's locations. You can also add other fleets with different configurations or home locations for redundancy. If you're using a multi-location Spot Instance fleet, follow best practices and include an On-Demand Instance fleet with the same locations.

The following example outlines the process of designing a basic multi-location queue. In this example, we use two fleets: one Spot Instance fleet and one On-Demand Instance fleet. Each fleet has the following AWS Regions for placement locations: us-east-1, us-east-2, ca-central-1, and us-west-2.

To create a basic multi-location queue with multi-location fleets
  1. Choose a location to create the queue in. You can minimize request latency by placing the queue in a location near where you deployed the client service. In this example, we create the queue in us-east-1.

  2. Create a new queue and add your multi-location fleets as queue destinations. The destination order determines how Amazon GameLift places game sessions. In this example, we list the Spot Instance fleet first and the On-Demand Instance fleet second.

  3. Define the queue's game session placement priority order. This order determines where the queue searches first for an available game server. In this example, we use the default priority order.

  4. Define the location order. If you don't define the location order, Amazon GameLift uses the locations in alphabetical order.

An example screen in the console configuring the queue placement locations and destinations as described in the previous procedure.
An example screen in the console configuring the Game session placement priority and Location order as described in the previous procedure.

Prioritize game session placement

Amazon GameLift uses the FleetIQ algorithm to determine where to place a new game session based on an ordered set of criteria. You can use the default priority order, or you can customize the order.

Default priority order

For placement requests that include player latency data, FleetIQ prioritizes the game session placement criteria in the following default order:

  1. Latency – Lowest average latency for all players in the request.

  2. Cost – Lowest hosting cost, if latency is equal in multiple locations. Hosting cost is primarily based on a combination of the instance type and location.

  3. Destination – Destination order, if latency and cost are equal in multiple locations. FleetIQ prioritizes destinations based on the order listed in the queue configuration.

  4. Location – Location order, if latency, cost, and destination are equal in multiple locations. FleetIQ prioritizes locations based on the order listed in the queue configuration.

Custom priority order

To customize a queue's priority order in the Amazon GameLift console, drag the priority value to the position that you want it in. To customize a queue's priority order using the AWS Command Line Interface (AWS CLI), use the create-game-session-queue command with the --priority-configuration option. You can use this command to create a new queue or to update an existing queue.

The FleetIQ algorithm appends any criteria not explicitly mentioned to the end of your list, based on the default order. If you include the location criterion in your priority configuration, you must also provide an ordered list of locations.

Design multiple queues as needed

Depending on your game and players, you might want to create more than one game session queue. When your game client service requests a new game session, it specifies which game session queue to use. To help you determine whether to use multiple queues, consider:

  • Variations of your game server. You can create a separate queue for each variation of your game server. All fleets in a queue must deploy compatible game servers. This is because players who use the queue to join games must be able to play on any of the queue's game servers.

  • Different player groups. You can customize how Amazon GameLift places game sessions based on player group. For example, you might need queues customized for certain game modes that require a special instance type or runtime configuration. Or, you might want a special queue to manage placements for a tournament or other event.

  • Game session queue metrics. You can set up queues based on how you want to collect game session placement metrics. For more information, see Amazon GameLift metrics for queues.

Evaluate queue metrics

Use metrics to evaluate how well your queues are performing. You can view metrics related to queues in the Amazon GameLift console or in Amazon CloudWatch. For a list and descriptions of queue metrics, see Amazon GameLift metrics for queues.

Queue metrics can provide insight about the following:

  • Overall queue performance – Queue metrics indicate how successfully a queue responds to placement requests. These metrics can also help you identify when and why placements fail. For queues with manually scaled fleets, the AverageWaitTime and QueueDepth metrics can indicate when you should adjust capacity for a queue.

  • FleetIQ algorithm performance – For placement requests using the FleetIQ algorithm, metrics show how often the algorithm finds ideal game session placement. The placement may prioritize using resources with the lowest player latency or resources with the lowest cost. There are also error metrics that identify common reasons why Amazon GameLift can't find an ideal placement. For more information about metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • Location specific placements – For multi-location queues, metrics show successful placements by location. For queues that use the FleetIQ algorithm, this data provides useful insight into where player activity occurs.

When evaluating metrics for FleetIQ algorithm performance, consider the following tips:

  • To track the queue's rate of finding an ideal placement, use the PlacementsSucceeded metric in combination with the FleetIQ metrics for lowest latency and lowest price.

  • To boost a queue's rate of finding an ideal placement, review the following error metrics:

    • If the FirstChoiceOutOfCapacity is high, adjust capacity scaling for the queue's fleets.

    • If the FirstChoiceNotViable error metric is high, look at your Spot Instance fleets. Spot Instance fleets are considered not viable when the interruption rate for a particular instance type is too high. To resolve this issue, change the queue to use Spot Instance fleets with different instance types. We recommend that you include Spot Instance fleets with different instance types in each location.