View data on game and player sessions - Amazon GameLift
DetailsPlayer sessions
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

View data on game and player sessions

You can view information about the games sessions and individual players. For more information about game sessions and player sessions, see How players connect to games.

To view game session and player data

  1. In the Amazon GameLift console, in the navigation pane, choose Fleets.

  2. From the Fleets list, choose the fleet that hosted the game sessions you want to view information for.

  3. In the chosen fleet's detail page, open the Game sessions tab. This tab lists all game sessions that were hosted on the fleet, along with summary information.

  4. Choose a game session to view additional information.

  5. If the game session has player session data, choose View player sessions to go to the player sessions lookup page.

Details

Overview

This section displays a summary of your game session information.

  • Status – Game session status.

    • Activating – The instance is initiating a game session.

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

    • Terminated – the game session has ended.

  • ARN – The Amazon Resource Name of the game session.

  • Name – Name generated for the game session.

  • Location – The location that Amazon GameLift hosted the game session in.

  • Creation time – Date and time that Amazon GameLift created the stream session.

  • Ending time – Date and time that the game session ended.

  • DNS name – The host name of the game session.

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

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

  • Creator ID – A unique identifier of the player that initiated the game session.

  • Player session creation policy – Indicates if the game session is accepting new players.

  • Game scaling protection policy – The type of game session protection to set on all new instances that Amazon GameLift starts in the fleet.

Game data

Game property data, formatted as a string, to send to your game session on start.

Game properties

Game property data, formatted as key/value pairs, to send to your game session on start.

Matchmaking data

If the game session was created with FlexMatch, matchmaking data describes information about the matchmaking configuration and rule set. This includes each match's player attributes and team assignments. Data is in JSON format. For more information about FlexMatch matchmaking, see Build a matchmaker.

Player sessions

For game sessions that include player session data for each player, you can view detailed information for each player session. In the Amazon GameLift console, choose Player session lookup.

Provide any the following information to look up player sessions for past or present game sessions. You can optionally filter results by player session status.

  • A player session ID to get information on a specific player session.

  • A game session ID to get information on all player sessions for the requested game session. The results represent all players who reserved a slot or connected to the game session.

  • A player ID to get information on all player sessions for the requested player. The results represent all game sessions that the player participated in.

Note

The lookup tool searches for all player session activity across the currently selected Amazon Web Services Region. If you have multiple fleets in the Region, the results include player session activity across all fleets. For multi-location fleets, the results also include player session activity across all remote locations.

The following player session data is collected for each game session:

  • Player session ID – The identifier assigned to the player session.

  • Player ID – A unique identifier for the player. Choose this ID to get additional player information.

  • Game session ID – The identifier assigned to the game session.

  • Fleet ID – The identifier assigned to the fleet that hosted the game session.

  • Status – The status of the player session. The following are possible statuses:

    • Reserved – Player session has been reserved, but the players isn't connected.

    • Active – Player session is connected to the game server.

    • Completed – Player session has ended; player is no longer connected.

    • Timed Out – Player failed to connect.

  • Creation time – The time the player connected to the game session.

  • Ending time – The time the player disconnected from the game session.

  • Connection data – IP address, DNS name and port that the player used to connect to the game session.

  • Player data – Information about the player that was provided during player session creation.