Menu
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 automatic 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 that are turned off are gray. Use the color key to identify which graphed line matches a selected metric. The following metrics are available:

    • Game – These metrics show utilization of the fleet's capacity over time.

      • Available player sessions – Number of unused player slots in active game sessions across the fleet. This number includes open slots in all game sessions regardless of whether the game is currently accepting new players.

      • Current player sessions – Number of players currently connected to active game sessions across the fleet.

      • Player session activations – Number of players joining an active game session. This metric is useful for tracking how the influx of new players changes over time.

      • Active game sessions – Number of game sessions currently running across the fleet.

      • Activating game sessions – Number of new game sessions in an Activating status across the fleet. Game sessions cannot accept player connections until they are active.

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

      • Active – Number of server processes in an Active status. Active server processes are able to host game sessions.

      • Healthy – Number of active server processes that reported healthy in the last health check.

      • Percent healthy – Percentage of active server processes that reported healthy in the last health check.

      • Activations – Number of new server processes in an Activating status across the fleet. Server processes cannot host a game session until they are active.

      • Terminations – Number of server processes that were shut down. This metric includes all process terminations regardless of reason.

      • Abnormal Terminations – Number of server processes that did not terminate cleanly; that is, the server process did not call ProcessEnding() and/or terminated with a non-zero exit code.

    • Hardware – These metrics reflect utilization of the fleet's computing resources. CPU utilization is expressed as a percentage.

  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.

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

Events

The Events tab provides a log of all events that have occurred on the fleet, including the event code, message, and time stamp.

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 automatic scaling.

To view current and historical scaling information

  1. Go to the top of the Scaling tab. To view the current capacity status for this fleet, look at the scaling values at the left. 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 automatic scaling or even if desired capacity is set below the minimum.

      • Desired – The number of active instances currently wanted in the fleet. Amazon GameLift's 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 automatic scaling or if desired capacity is set above the maximum.

    • Instance Counts – These metrics track actual changes in capacity over time.

      • Active – Number of instances in the fleet that are running a game server. This number should match the number of Desired instances; if it does not, then Amazon GameLift may be in the process of scaling up or down, or at the fleet's minimum or maximum limit.

      • Idle – Number of active instances in the fleet that are not currently hosting game sessions. This metric indicates available capacity that is not being utilized.

      • Pending – Number of instances Amazon GameLift is currently starting up to host game sessions (scaling up).

      • Terminating – Number of instances Amazon GameLift is currently in the process of shutting down (scaling down).

  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

  1. Go to the top of the Scaling tab. You can manually set the fleet's capacity by changing the current values of the fleet's scaling limits. You can edit these values, which are shown along the left side of the Scaling tab.

  2. To specify the number of instances that you want available to host game sessions, set the value of Desired. Amazon GameLift immediately attempts to scale instances up or down to meet the new value. If the new value you set is above the maximum or below the minimum limits, then Amazon GameLift attempts to scale up or down to that limit.

  3. Set the maximum and minimum scaling limits as needed. If the value of Desired instances was or is now outside the range of your limits, changing these limits causes Amazon GameLift to immediately try to scale up or down to get closer to the Desired value while staying inside the new limit range.

To manage automatic scaling

  • Go to the end of the Scaling tab to find tools for setting up automatic scaling policies. See Set Up Fleet Automatic Scaling for more details on automatic scaling and how to manage policies.

Game sessions

The Game sessions tab lists past and present contains 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.

Logs

The Logs tab lists the locations of log files that Amazon GameLift uploads at the end of a game session. Log paths can only be specified when creating a new fleet from the AWS CLI.