Amazon GameLift
Developer Guide (Version )

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

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.

On this page you can also take the following actions:

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

  • Change fleet capacity settings. On the Scaling page, edit the Minimum and Maximum instance counts, or manually set the Desired fleet capacity to a fixed size.

  • Set or change auto-scaling policies. On the Scaling page, enable or disable auto-scaling.

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

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.

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

  • Fleet type – Indicates whether the fleet uses on-demand or spot instances.

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

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

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

  • Player sessions – Number of players 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 displays a graphical representation of fleet metrics over time. To view metrics using Amazon CloudWatch, see Monitor Amazon GameLift with Amazon CloudWatch .

To display metrics information in the graph

  1. From the list shown to the left of the graph area, click a metric name to add it to the graph display. Metric names that are gray are currently not being graphed. The color key identifies which line matches each graphed 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 and Game – These metrics track changes in capacity and utilization over time. See descriptions of individual metrics at Amazon GameLift Metrics for Fleets.

    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.

  2. 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. See View Data on Game and Player Sessions for more details.

Capacity allocation

The Capacity allocation tab displays the runtime configuration for the fleet, which specifies what server processes to launch on each instance. 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.

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.

ARNs

The ARNs tab lists Amazon Resource Name (ARN) associated with this fleet:

  • Fleet ARN – The identifier assigned to this fleet. A fleet's ARN identifies it as an Amazon GameLift resource and specifies the region and AWS account, to ensure that it is a unique identifier.

  • Instance Role ARN – An identifier for an AWS IAM role that manages access to your other AWS resources, if one was provided during fleet creation. When a role ARN is associated with the fleet, the game servers and other applications that are running on the fleet are able to access those other AWS resources. Learn more at Access AWS Resources From Your Fleets.