Amazon GameLift
Developer Guide (Version )

View Fleet Details

You can access detailed information on any fleet, including configuration settings, scaling settings, metrics, and game and player data. Access a Fleet detail page from either the console dashboard or the Fleets page by clicking the fleet name.

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

  • Update the fleet's metadata and runtime configuration. Choose Actions: Edit fleet.

  • Change fleet capacity settings. On the Scaling page, edit values from Minimum, Maximum, and Desired instances.

  • Set or change auto-scaling policies. On the Scaling page, add or edit a policy.

  • Shut down a fleet. Choose Actions: Terminate fleet.

Summary

The summary table includes the following information:

  • Status – Current status of the fleet, which may be New, Downloading, Building, and Active. A fleet must be active before it can host game sessions or accept player connections.

  • Fleet ID – Unique identifier assigned to the fleet.

  • EC2 type – Amazon EC2 instance type selected for the fleet when it was created. A fleet's instance type specifies the computing hardware and capacity used for each instance in the fleet and determines the instance limits for the fleet.

  • OS – Operating system on each instances in the fleet. A fleet's OS is determined by the build deployed to it.

  • Active instances – Number of instances in Active status, which means they are currently running game sessions or are ready to run game sessions.

  • Active servers – Number of server processes currently in an Active status in the fleet. The data has a five-minute delay.

  • Active game sessions – Number of game sessions currently running on instances in the fleet. The data has a five-minute delay.

  • Current player sessions – Number of players currently connected along with the total number of player slots in active game sessions across the fleet. For example: 25 (connected players) of 100 (possible players) means the fleet can support 75 additional players. The data has a five-minute delay.

  • Protection – Current setting for game session protection for the fleet.

    Uptime – Total length of time the fleet has been active.

  • Date created – Date and time indicating when the fleet was created.

Metrics

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

To display metrics information in the graph

  1. Click one or more metric name to the left of the graph area to add it to the graph display. Metric names are gray when turned off. Use the color key to identify the graphed line for a selected metric. Descriptions of individual metrics can be found at Amazon GameLift Metrics for Fleets. The following categories of metrics are available:

    • Instance Counts – These metrics track changes in capacity and utilization at the instance level over time (also shown on the Scaling tab).

    • Game – These metrics show fleet activity and utilization at the game session level over time.

    • Server processes – These metrics track the status and health of server processes across the fleet. The Amazon GameLift service regularly polls each active server process for its health.

    • Instance performance – These metrics reflect performance of the fleet's computing resources. See detailed descriptions of each metric at EC2 Instance Metrics.

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

    • Data & 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.

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

    • Show points – Toggle on or off to display discrete data points (as circles) or display lines only.

Events

The Events tab provides a log of all events that have occurred on the fleet, including the event code, message, and time stamp. See Event descriptions in the Amazon GameLift API Reference.

Scaling

The Scaling tab contains information related to fleet capacity, including the current status and a graphical representation of capacity changes over time. It also provides tools to update capacity limits and manage auto-scaling.

To view current and historical scaling information

  1. Go to the top of the Scaling tab. The current capacity status for this fleet is shown in the left column. These values are defined as follows:

    • Scaling Limits – These metrics track the history of changes to capacity limits.

      • Minimum – Hard lower limit on the number of instances to maintain in the fleet. Fleet capacity will not drop below the current minimum during auto-scaling or even if desired capacity is set below the minimum.

      • Desired – The number of active instances currently wanted in the fleet. The goal is to make the number of Active instances (explained later) match the number of desired instances; it achieves this by creating or terminating instances as needed.

      • Maximum – Hard upper limit on the number of instances to maintain in the fleet. Fleet capacity will not exceed the current maximum during auto-scaling or if desired capacity is set above the maximum.

    • Instance Counts – These metrics track changes in capacity and utilization over time. See descriptions of individual metrics at Amazon GameLift Metrics for Fleets.

  2. To view how fleet capacity has changed over time, display in the graph any or all of the scaling metrics listed on the left. Click the metric name to add it to the graph. (Metric names are gray when not in use.) Use the color key to identify which graphed line matches a selected metric.

  3. (Optional) Use the following filters, shown above the graph area, to specify how metric data is displayed in the graph:

    • Data & 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 on or off to display discrete data points (as circles) or display lines only.

To change fleet capacity

Game sessions

The Game sessions tab lists past and present game sessions hosted on the fleet, including some detail information. Click a game session ID to access additional game session information, including player sessions.

  • Status – Game session status. Valid statuses are:

    • Activating – A game session has been initiated and is preparing to run.

    • Active – A game session is running and available to receive players (depending on the session's player creation policy).

    • Terminated – Game session has ended.

  • Name – Game generated for the game session.

  • ID – Unique identifier assigned by Amazon GameLift to the game session.

  • IP address – IP address specified for the game session.

  • Port – Port number used to connect to the game session.

  • Player sessions – Number of players connected to the game sessions along with total possible players the game session can support. For example: 2 (connected players) of 10 (possible players) means the fleet can support 8 additional players.

  • Uptime – Total length of time the game session has been running.

  • Date created – Date and time stamp indicating when the fleet was created.

Build

The Build tab displays the fleet's build-related configuration, which was set when the fleet was created. Select the build ID to see the full build detail page.

If your build has been deleted or an error has occurred while attempting to retrieve your build, you may see one of the following status messages:

  • Deleted – The build for this fleet was deleted. Your fleet will still run properly despite the build having been deleted.

  • Error – An error occurred while attempting to retrieve build information for the fleet.

Capacity allocation

The Capacity allocation tab displays the runtime configuration for the fleet, which specifies what server processes to launch on each instance and how. It includes the path for the game server executable and optional launch parameters. You can change the fleet's capacity allocation either by editing the fleet in the console or by using the AWS CLI to update the runtime configuration.

Ports

The Ports tab displays the fleet's connection permissions, including IP address and port setting ranges. You can change connection permissions by either editing the fleet in the console or using the AWS CLI to update the fleet's port settings.

ARN

The ARN tab lists the Amazon Resource Name (ARN) assigned to this fleet.