Event
Log entry describing an event that involves Amazon GameLift resources (such as a fleet). In addition to tracking activity, event codes and messages can provide additional information for troubleshooting and debugging problems.
Contents
Note
In the following list, the required parameters are described first.
- Count
-
The number of times that this event occurred.
Type: Long
Valid Range: Minimum value of 1. Maximum value of 101.
Required: No
- EventCode
-
The type of event being logged.
Fleet state transition events:
-
FLEET_CREATED -- A fleet resource was successfully created with a status of
NEW
. Event messaging includes the fleet ID. -
FLEET_STATE_DOWNLOADING -- Fleet status changed from
NEW
toDOWNLOADING
. Amazon GameLift is downloading the compressed build and running install scripts. -
FLEET_STATE_VALIDATING -- Fleet status changed from
DOWNLOADING
toVALIDATING
. Amazon GameLift has successfully installed build and is now validating the build files. -
FLEET_STATE_BUILDING -- Fleet status changed from
VALIDATING
toBUILDING
. Amazon GameLift has successfully verified the build files and is now launching a fleet instance. -
FLEET_STATE_ACTIVATING -- Fleet status changed from
BUILDING
toACTIVATING
. Amazon GameLift is launching a game server process on the fleet instance and is testing its connectivity with the Amazon GameLift service. -
FLEET_STATE_ACTIVE -- The fleet's status changed from
ACTIVATING
toACTIVE
. The fleet is now ready to host game sessions. -
FLEET_STATE_ERROR -- The Fleet's status changed to
ERROR
. Describe the fleet event message for more details.
Fleet creation events (ordered by fleet creation activity):
-
FLEET_BINARY_DOWNLOAD_FAILED -- The build failed to download to the fleet instance.
-
FLEET_CREATION_EXTRACTING_BUILD -- The game server build was successfully downloaded to an instance, and Amazon GameLiftis now extracting the build files from the uploaded build. Failure at this stage prevents a fleet from moving to ACTIVE status. Logs for this stage display a list of the files that are extracted and saved on the instance. Access the logs by using the URL in PreSignedLogUrl.
-
FLEET_CREATION_RUNNING_INSTALLER -- The game server build files were successfully extracted, and Amazon GameLift is now running the build's install script (if one is included). Failure in this stage prevents a fleet from moving to ACTIVE status. Logs for this stage list the installation steps and whether or not the install completed successfully. Access the logs by using the URL in PreSignedLogUrl.
-
FLEET_CREATION_COMPLETED_INSTALLER -- The game server build files were successfully installed and validation of the installation will begin soon.
-
FLEET_CREATION_FAILED_INSTALLER -- The installed failed while attempting to install the build files. This event indicates that the failure occurred before Amazon GameLift could start validation.
-
FLEET_CREATION_VALIDATING_RUNTIME_CONFIG -- The build process was successful, and the GameLift is now verifying that the game server launch paths, which are specified in the fleet's runtime configuration, exist. If any listed launch path exists, Amazon GameLift tries to launch a game server process and waits for the process to report ready. Failures in this stage prevent a fleet from moving to
ACTIVE
status. Logs for this stage list the launch paths in the runtime configuration and indicate whether each is found. Access the logs by using the URL in PreSignedLogUrl. -
FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND -- Validation of the runtime configuration failed because the executable specified in a launch path does not exist on the instance.
-
FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE -- Validation of the runtime configuration failed because the executable specified in a launch path failed to run on the fleet instance.
-
FLEET_VALIDATION_TIMED_OUT -- Validation of the fleet at the end of creation timed out. Try fleet creation again.
-
FLEET_ACTIVATION_FAILED -- The fleet failed to successfully complete one of the steps in the fleet activation process. This event code indicates that the game build was successfully downloaded to a fleet instance, built, and validated, but was not able to start a server process. For more information, see Debug Fleet Creation Issues.
-
FLEET_ACTIVATION_FAILED_NO_INSTANCES -- Fleet creation was not able to obtain any instances based on the input fleet attributes. Try again at a different time or choose a different combination of fleet attributes such as fleet type, instance type, etc.
-
FLEET_INITIALIZATION_FAILED -- A generic exception occurred during fleet creation. Describe the fleet event message for more details.
VPC peering events:
-
FLEET_VPC_PEERING_SUCCEEDED -- A VPC peering connection has been established between the VPC for an Amazon GameLift fleet and a VPC in your Amazon account.
-
FLEET_VPC_PEERING_FAILED -- A requested VPC peering connection has failed. Event details and status information provide additional detail. A common reason for peering failure is that the two VPCs have overlapping CIDR blocks of IPv4 addresses. To resolve this, change the CIDR block for the VPC in your Amazon account. For more information on VPC peering failures, see https://docs.amazonaws.cn/AmazonVPC/latest/PeeringGuide/invalid-peering-configurations.html
-
FLEET_VPC_PEERING_DELETED -- A VPC peering connection has been successfully deleted.
Spot instance events:
-
INSTANCE_INTERRUPTED -- A spot instance was interrupted by EC2 with a two-minute notification.
-
INSTANCE_RECYCLED -- A spot instance was determined to have a high risk of interruption and is scheduled to be recycled once it has no active game sessions.
Server process events:
-
SERVER_PROCESS_INVALID_PATH -- The game server executable or script could not be found based on the Fleet runtime configuration. Check that the launch path is correct based on the operating system of the Fleet.
-
SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT -- The server process did not call
InitSDK()
within the time expected (5 minutes). Check your game session log to see whyInitSDK()
was not called in time. -
SERVER_PROCESS_PROCESS_READY_TIMEOUT -- The server process did not call
ProcessReady()
within the time expected (5 minutes) after callingInitSDK()
. Check your game session log to see whyProcessReady()
was not called in time. -
SERVER_PROCESS_CRASHED -- The server process exited without calling
ProcessEnding()
. Check your game session log to see whyProcessEnding()
was not called. -
SERVER_PROCESS_TERMINATED_UNHEALTHY -- The server process did not report a valid health check for too long and was therefore terminated by GameLift. Check your game session log to see if the thread became stuck processing a synchronous task for too long.
-
SERVER_PROCESS_FORCE_TERMINATED -- The server process did not exit cleanly within the time expected after
OnProcessTerminate()
was sent. Check your game session log to see why termination took longer than expected. -
SERVER_PROCESS_PROCESS_EXIT_TIMEOUT -- The server process did not exit cleanly within the time expected (30 seconds) after calling
ProcessEnding()
. Check your game session log to see why termination took longer than expected.
Game session events:
-
GAME_SESSION_ACTIVATION_TIMEOUT -- GameSession failed to activate within the expected time. Check your game session log to see why
ActivateGameSession()
took longer to complete than expected.
Other fleet events:
-
FLEET_SCALING_EVENT -- A change was made to the fleet's capacity settings (desired instances, minimum/maximum scaling limits). Event messaging includes the new capacity settings.
-
FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED -- A change was made to the fleet's game session protection policy setting. Event messaging includes both the old and new policy setting.
-
FLEET_DELETED -- A request to delete a fleet was initiated.
-
GENERIC_EVENT -- An unspecified event has occurred.
Type: String
Valid Values:
GENERIC_EVENT | FLEET_CREATED | FLEET_DELETED | FLEET_SCALING_EVENT | FLEET_STATE_DOWNLOADING | FLEET_STATE_VALIDATING | FLEET_STATE_BUILDING | FLEET_STATE_ACTIVATING | FLEET_STATE_ACTIVE | FLEET_STATE_ERROR | FLEET_STATE_PENDING | FLEET_STATE_CREATING | FLEET_STATE_CREATED | FLEET_STATE_UPDATING | FLEET_INITIALIZATION_FAILED | FLEET_BINARY_DOWNLOAD_FAILED | FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND | FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE | FLEET_VALIDATION_TIMED_OUT | FLEET_ACTIVATION_FAILED | FLEET_ACTIVATION_FAILED_NO_INSTANCES | FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED | SERVER_PROCESS_INVALID_PATH | SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT | SERVER_PROCESS_PROCESS_READY_TIMEOUT | SERVER_PROCESS_CRASHED | SERVER_PROCESS_TERMINATED_UNHEALTHY | SERVER_PROCESS_FORCE_TERMINATED | SERVER_PROCESS_PROCESS_EXIT_TIMEOUT | SERVER_PROCESS_SDK_INITIALIZATION_FAILED | SERVER_PROCESS_MISCONFIGURED_CONTAINER_PORT | GAME_SESSION_ACTIVATION_TIMEOUT | FLEET_CREATION_EXTRACTING_BUILD | FLEET_CREATION_RUNNING_INSTALLER | FLEET_CREATION_VALIDATING_RUNTIME_CONFIG | FLEET_VPC_PEERING_SUCCEEDED | FLEET_VPC_PEERING_FAILED | FLEET_VPC_PEERING_DELETED | INSTANCE_INTERRUPTED | INSTANCE_RECYCLED | INSTANCE_REPLACED_UNHEALTHY | FLEET_CREATION_COMPLETED_INSTALLER | FLEET_CREATION_FAILED_INSTALLER | COMPUTE_LOG_UPLOAD_FAILED | GAME_SERVER_CONTAINER_GROUP_CRASHED | PER_INSTANCE_CONTAINER_GROUP_CRASHED | GAME_SERVER_CONTAINER_GROUP_REPLACED_UNHEALTHY | LOCATION_STATE_PENDING | LOCATION_STATE_CREATING | LOCATION_STATE_CREATED | LOCATION_STATE_ACTIVATING | LOCATION_STATE_ACTIVE | LOCATION_STATE_UPDATING | LOCATION_STATE_ERROR | LOCATION_STATE_DELETING | LOCATION_STATE_DELETED
Required: No
-
- EventId
-
A unique identifier for a fleet event.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
- EventTime
-
Time stamp indicating when this event occurred. Format is a number expressed in Unix time as milliseconds (for example
"1469498468.057"
).Type: Timestamp
Required: No
- Message
-
Additional information related to the event.
Type: String
Length Constraints: Minimum length of 1.
Required: No
- PreSignedLogUrl
-
Location of stored logs with additional detail that is related to the event. This is useful for debugging issues. The URL is valid for 15 minutes. You can also access fleet creation logs through the Amazon GameLift console.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
- ResourceId
-
A unique identifier for an event resource, such as a fleet ID.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: