Menu
Amazon GameLift
Developer Guide (Version )

View Queue Details

You can access detailed information on any queue, including the queue configuration and metrics. To open a Queue detail page, go to the main Queues page and choose a queue name.

The queue detail page displays a summary table and tabs containing additional information. On this page you can do the following:

  • Update the queue's configuration, list of destinations and player latency policies. Choose Actions, Edit queue.

  • Remove a queue. After a queue is removed, all requests for new game sessions that reference that queue name will fail. (Note that deleted queues can be restored by simply creating a queue with the deleted queue's name.) Choose Actions, Delete queue.

Summary

The summary table includes the following information:

  • Queue name – The name assigned to the queue. Requests for new game sessions specify a queue by this name.

  • Queue timeout – Maximum length of time, in seconds, that a game session placement request remains in the queue before timing out.

  • Destinations in queue – Number of fleets listed in the queue configuration. New game sessions can be placed on any fleet in the queue.

Destinations

The Destinations tab shows all fleets or aliases listed for the queue. Fleets are identified by either a fleet ARN or an alias ARN, which specifies the fleet or alias ID and the region.

When Amazon GameLift searches the destinations for available resources to host a new game session, it searches in the order listed here. As long as there is capacity on the first destination listed, new game sessions are placed there. This is the default order for destinations. You can have individual game session placement requests override the default order by providing player latency data. This data tells Amazon GameLift to search for an available destination with the lowest average player latency. For help understanding how queues process game session placement requests, see Create Game Sessions with Queues.

To add, edit, or delete destinations, choose Actions, Edit queue.

Player Latency Policies

The Player latency policies tab shows all policies that have been defined for the queue. Policies are listed in the order they are enforced during a game session placement effort.

To add, edit, or delete player latency policies, choose Actions, Edit queue.

Queue Metrics

The Metrics tab shows a graphical representation of queue metrics over time.

To display metrics information in the graph

  1. Click one or more of the metric names that are listed to the left of the graph area. Metric names shown in black are displayed in the graph, while those shown in gray are turned off. Use the color key to identify which graphed line matches a selected metric. The following metrics are available:

    • Queue – These metrics show game session placement activity across the entire queue.

      • Average wait time – Average length of time that the requests currently in the queue have been waiting for placement.

      • Queue depth – Total number of requests that are currently in the queue.

      • Placements started – Number of new requests that were added to the queue.

      • Placements succeeded – Number of requests that resulted in successfully starting a new game session.

      • Placements cancelled – Number of requests that were cancelled before succeeding.

      • Placements time out – Number of requests that waited for the full timeout period without resulting in a new game session.

      • Placements failed – Number of requests that failed for other reasons.

         

    • Fleet-specific (listed by ARN) – These metrics show game session placement activity broken down by hosting location. Each placement request in a queue is assigned a "preferred" fleet, which is based on either the default queue order (the first available fleet listed) or on the request's player latency data. These metrics show how successfully the queue is handling the task of placing new game sessions on the best available fleet.

      • Queue depth – Number of game session placement requests that are waiting to be hosted on this fleet.

      • Average wait time – Average length of time that a game session request is currently spending in the queue.

  2. Use the following filters, shown above the graph area, to change how metric data is displayed:

    • Data and Period – Offers two options for selecting a date range:

      • Use Relative to select a period of time relative to the current time, such as Last hour, Last day, Last week.

      • Use Absolute to specify a period with an arbitrary start and end date/time.

    • Granularity – Select a length of time to aggregate data points.

    • Refresh rate – Select how often you want the graph display to be updated.

    • Format – Select which time format to use in the graph display: UTC (universal coordinated time) or Browser time (local time).

    • Show points – Toggle to display discrete data points as circles or display lines only.