--- title: Amazon GameLift description: >- Manages deployment, operation, and scaling of your session-based multiplayer game servers in the cloud. breadcrumbs: Docs > Integrations > Amazon GameLift --- # Amazon GameLift Integration version1.0.0 ## Overview{% #overview %} Amazon GameLift is a fully managed service for deploying, operating, and scaling your session-based multiplayer game servers in the cloud. Enable this integration to see all your GameLift metrics in Datadog. ## Setup{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services/) first. ### Metric collection{% #metric-collection %} 1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `GameLift` is enabled under the `Metric Collection` tab. 1. Install the [Datadog - Amazon GameLift integration](https://app.datadoghq.com/integrations/amazon-gamelift). ### Log collection{% #log-collection %} #### Enable logging{% #enable-logging %} Configure Amazon GameLift to send logs either to a S3 bucket or to CloudWatch. **Note**: If you log to a S3 bucket, make sure that `amazon_gamelift` is set as *Target prefix*. #### Send logs to Datadog{% #send-logs-to-datadog %} 1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder/). 1. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon GameLift logs in the AWS console: - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-s3-buckets) - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-cloudwatch-log-group) ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **aws.gamelift.activating\_game\_sessions**(count) | The average number of game sessions with status activating . | | **aws.gamelift.activating\_game\_sessions.maximum**(count) | The maximum number of game sessions with status activating . | | **aws.gamelift.activating\_game\_sessions.minimum**(count) | The minimum number of game sessions with status activating . | | **aws.gamelift.active\_game\_sessions**(count) | The average number of game sessions with status active . | | **aws.gamelift.active\_game\_sessions.maximum**(count) | The maximum number of game sessions with status active . | | **aws.gamelift.active\_game\_sessions.minimum**(count) | The minimum number of game sessions with status active . | | **aws.gamelift.active\_instances**(count) | The average number of instances with active status. | | **aws.gamelift.active\_instances.maximum**(count) | The maximum number of instances with active status. | | **aws.gamelift.active\_instances.minimum**(count) | The minimum number of instances with active status. | | **aws.gamelift.active\_server\_processes**(count) | The average number server processes with status active. | | **aws.gamelift.active\_server\_processes.maximum**(count) | The maximum number of server processes with status active. | | **aws.gamelift.active\_server\_processes.minimum**(count) | The minimum number of server processes with status active. | | **aws.gamelift.available\_game\_sessions**(count) | The average number of game session slots on active & healthy processes not being used. | | **aws.gamelift.available\_game\_sessions.maximum**(count) | The maximum number of game session slots on active & healthy processes not being used. | | **aws.gamelift.available\_game\_sessions.minimum**(count) | The minimum number of game session slots on active & healthy processes not being used. | | **aws.gamelift.current\_player\_sessions**(count) | The average number of player sessions with active or reserved status. | | **aws.gamelift.current\_player\_sessions.maximum**(count) | The maximum number of player sessions with active or reserved status. | | **aws.gamelift.current\_player\_sessions.minimum**(count) | The minimum number of player sessions with active or reserved status. | | **aws.gamelift.current\_player\_sessions.sum**(count) | The total number of player sessions with active or reserved status. | | **aws.gamelift.desired\_instances**(count) | The average number of active instances working to maintain the fleet. | | **aws.gamelift.desired\_instances.maximum**(count) | The maximum number of active instances working to maintain the fleet. | | **aws.gamelift.desired\_instances.minimum**(count) | The minimum number of active instances working to maintain the fleet. | | **aws.gamelift.game\_session\_interruptions**(count) | The average number of game session that have been interrupted. | | **aws.gamelift.game\_session\_interruptions.maximum**(count) | The maximum number of game session that have been interrupted. | | **aws.gamelift.game\_session\_interruptions.minimum**(count) | The minimum number of game session that have been interrupted. | | **aws.gamelift.game\_session\_interruptions.sum**(count) | The sum of the number of game session that have been interrupted. | | **aws.gamelift.healthy\_server\_processes**(count) | The average number of server processes that are reporting healthy. | | **aws.gamelift.healthy\_server\_processes.maximum**(count) | The maximum number of server processes that are reporting healthy. | | **aws.gamelift.healthy\_server\_processes.minimum**(count) | The minimum number of server processes that are reporting healthy. | | **aws.gamelift.idle\_instances**(count) | The average number of active instances hosting 0 game sessions. | | **aws.gamelift.idle\_instances.maximum**(count) | The maximum number of active instances hosting 0 game sessions. | | **aws.gamelift.idle\_instances.minimum**(count) | The minimum number of active instances hosting 0 game sessions. | | **aws.gamelift.instance\_interruptions**(count) | The average number of spot instances that have been interrupted. | | **aws.gamelift.instance\_interruptions.maximum**(count) | The maximum number of spot instances that have been interrupted. | | **aws.gamelift.instance\_interruptions.minimum**(count) | The minimum number of spot instances that have been interrupted. | | **aws.gamelift.instance\_interruptions.sum**(count) | The sum of the number of spot instances that have been interrupted. | | **aws.gamelift.max\_instances**(count) | The average of the maximum number of instances allowed for the fleet. | | **aws.gamelift.max\_instances.maximum**(count) | The total maximum number of instances allowed for the fleet. | | **aws.gamelift.max\_instances.minimum**(count) | The minimum of maximum number of instances allowed for the fleet. | | **aws.gamelift.min\_instances**(count) | The average of the minimum number of instances allowed for the fleet. | | **aws.gamelift.min\_instances.maximum**(count) | The maximum of minimum number of instances allowed for the fleet. | | **aws.gamelift.min\_instances.minimum**(count) | The absolute minimum number of instances allowed for the fleet. | | **aws.gamelift.percent\_available\_game\_sessions**(count) | The average number of game session slots on all active server processes that are not being used.*Shown as percent* | | **aws.gamelift.percent\_healthy\_server\_processes**(count) | The average percent of server processes that are reporting healthy.*Shown as percent* | | **aws.gamelift.percent\_healthy\_server\_processes.maximum**(count) | The maximum percent of server processes that are reporting healthy.*Shown as percent* | | **aws.gamelift.percent\_healthy\_server\_processes.minimum**(count) | The minimum percent of server processes that are reporting healthy.*Shown as percent* | | **aws.gamelift.percent\_idle\_instances**(count) | The average percentage of active instances that are idle. | | **aws.gamelift.percent\_idle\_instances.maximum**(count) | The maximum percentage of active instances that are idle. | | **aws.gamelift.percent\_idle\_instances.minimum**(count) | The minimum percentage of active instances that are idle. | | **aws.gamelift.player\_session\_activations**(count) | The average number of player sessions that transitioned from reserved to active. | | **aws.gamelift.player\_session\_activations.maximum**(count) | The maximum number of player sessions that transitioned from reserved to active. | | **aws.gamelift.player\_session\_activations.minimum**(count) | The minimum number of player sessions that transitioned from reserved to active. | | **aws.gamelift.player\_session\_activations.sum**(count) | The sum of the number of player sessions that transitioned from reserved to active. | | **aws.gamelift.server\_process\_abnormal\_terminations**(count) | The average number of server processes that were shut due to abormal circumstances . | | **aws.gamelift.server\_process\_abnormal\_terminations.maximum**(count) | The maximum number of server processes that were shut due to abormal circumstances . | | **aws.gamelift.server\_process\_abnormal\_terminations.minimum**(count) | The minimum number of server processes that were shut due to abormal circumstances . | | **aws.gamelift.server\_process\_abnormal\_terminations.sum**(count) | The sum of the number of server processes that were shut due to abormal circumstances . | | **aws.gamelift.server\_process\_activations**(count) | The average number of server processes that have been activated. | | **aws.gamelift.server\_process\_activations.maximum**(count) | The maximum number of server processes that have been activated. | | **aws.gamelift.server\_process\_activations.minimum**(count) | The minimum number of server processes that have been activated. | | **aws.gamelift.server\_process\_activations.sum**(count) | The sum of the number of server processes that have been activated. | | **aws.gamelift.server\_process\_terminations**(count) | The average number of server processes that have been terminated. | | **aws.gamelift.server\_process\_terminations.maximum**(count) | The maximum number of server processes that have been terminated. | | **aws.gamelift.server\_process\_terminations.minimum**(count) | The minimum number of server processes that have been terminated. | | **aws.gamelift.server\_process\_terminations.sum**(count) | The sum of the number of server processes that have been terminated. | | **aws.gamelift.average\_wait\_time**(count) | The average amount of time a game session requests in the que with status pending have been waiting. | | **aws.gamelift.average\_wait\_time.maximum**(count) | The maximum amount of time a game session requests in the que with status pending have been waiting. | | **aws.gamelift.average\_wait\_time.minimum**(count) | The minimum amount of time a game session requests in the que with status pending have been waiting. | | **aws.gamelift.average\_wait\_time.sum**(count) | The sum of the amount of time a game session requests in the que with status pending have been waiting. | | **aws.gamelift.queue\_depth**(count) | The average number of game session placement requests in the queue with status pending. | | **aws.gamelift.queue\_depth.maximum**(count) | The maximum number of game session placement requests in the queue with status pending. | | **aws.gamelift.queue\_depth.minimum**(count) | The minimum number of game session placement requests in the queue with status pending. | | **aws.gamelift.queue\_depth.sum**(count) | The sum of the number of game session placement requests in the queue with status pending. | | **aws.gamelift.placements\_started**(count) | The average number of game session placement requests that were added to the queue. | | **aws.gamelift.placements\_started.maximum**(count) | The maximum number of game session placement requests that were added to the queue. | | **aws.gamelift.placements\_started.minimum**(count) | The minimum number of game session placement requests that were added to the queue. | | **aws.gamelift.placements\_started.sum**(count) | The sum of the number of game session placement requests that were added to the queue. | | **aws.gamelift.first\_choice\_not\_viable**(count) | The average number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable. | | **aws.gamelift.first\_choice\_not\_viable.maximum**(count) | The maximum number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable. | | **aws.gamelift.first\_choice\_not\_viable.minimum**(count) | The minimum number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable. | | **aws.gamelift.first\_choice\_not\_viable.sum**(count) | The sum of the number of game sessions successfully placed but not in the first choice fleet because the fleet is not viable. | | **aws.gamelift.first\_choice\_out\_of\_capacity**(count) | The average number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources. | | **aws.gamelift.first\_choice\_out\_of\_capacity.maximum**(count) | The maximum number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources. | | **aws.gamelift.first\_choice\_out\_of\_capacity.minimum**(count) | The minimum number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources. | | **aws.gamelift.first\_choice\_out\_of\_capacity.sum**(count) | The sum of the number of game sessions successfully placed but not in the first choice fleet because the fleet has no available resources. | | **aws.gamelift.lowest\_latency\_placement**(count) | The average number of game sessions placed in a region that offers the queue's lowest possible latency. | | **aws.gamelift.lowest\_latency\_placement.maximum**(count) | The maximum number of game sessions placed in a region that offers the queue's lowest possible latency. | | **aws.gamelift.lowest\_latency\_placement.minimum**(count) | The minimum number of game sessions placed in a region that offers the queue's lowest possible latency. | | **aws.gamelift.lowest\_latency\_placement.sum**(count) | The sum of the number of game sessions placed in a region that offers the queue's lowest possible latency. | | **aws.gamelift.lowest\_price\_placement**(count) | The average number of game sessions placed in a region that offers the queue's lowest price for the region. | | **aws.gamelift.lowest\_price\_placement.maximum**(count) | The maximum number of game sessions placed in a region that offers the queue's lowest price for the region. | | **aws.gamelift.lowest\_price\_placement.minimum**(count) | The minimum number of game sessions placed in a region that offers the queue's lowest price for the region. | | **aws.gamelift.lowest\_price\_placement.sum**(count) | The sum of the number of game sessions placed in a region that offers the queue's lowest price for the region. | | **aws.gamelift.minimum\_instances**(count) | The average of the minimum number of instances allowed for the fleet. | | **aws.gamelift.minimum\_instances.maximum**(count) | The maximum of minimum number of instances allowed for the fleet. | | **aws.gamelift.minimum\_instances.minimum**(count) | The absolute minimum number of instances allowed for the fleet. | | **aws.gamelift.placements\_cancelled**(count) | The average number of game session placement requests that were cancelled. | | **aws.gamelift.placements\_cancelled.maximum**(count) | The maximum number of game session placement requests that were cancelled. | | **aws.gamelift.placements\_cancelled.minimum**(count) | The minimum number of game session placement requests that were cancelled. | | **aws.gamelift.placements\_cancelled.sum**(count) | The sum of the number of game session placement requests that were cancelled. | | **aws.gamelift.placements\_failed**(count) | The average number of game session placement requests tha failed. | | **aws.gamelift.placements\_succeeded**(count) | The average number of game session placement requests that resulted in a new session. | | **aws.gamelift.placements\_succeeded.maximum**(count) | The maximum number of game session placement requests that resulted in a new session. | | **aws.gamelift.placements\_succeeded.minimum**(count) | The minimum number of game session placement requests that resulted in a new session. | | **aws.gamelift.placements\_succeeded.sum**(count) | The sum of the number of game session placement requests that resulted in a new session. | | **aws.gamelift.placements\_timed\_out**(count) | The average number of game session placement requests that reached the queue's timeout limit. | | **aws.gamelift.placements\_timed\_out.maximum**(count) | The maximum number of game session placement requests that reached the queue's timeout limit. | | **aws.gamelift.placements\_timed\_out.minimum**(count) | The minimum number of game session placement requests that reached the queue's timeout limit. | | **aws.gamelift.placements\_timed\_out.sum**(count) | The sum of the number of game session placement requests that reached the queue's timeout limit. | | **aws.gamelift.current\_tickets**(count) | Matchmaking requests currently being processed or waiting to be processed. | | **aws.gamelift.matches\_accepted**(count) | Matches that were successfully accepted by all players since the last report. | | **aws.gamelift.matches\_created**(count) | Potential matches that were created since the last report. | | **aws.gamelift.matches\_placed**(count) | Matches that were successfully placed into a game session since the last report. | | **aws.gamelift.matches\_rejected**(count) | For matchmaking configurations that require acceptance, the potential matches that were rejected by at least one player since the last report. | | **aws.gamelift.players\_started**(count) | Players in matchmaking tickets that were added since the last report. | | **aws.gamelift.tickets\_started**(count) | New matchmaking requests that were created since the last report. | | **aws.gamelift.tickets\_failed**(count) | Matchmaking requests that resulted in failure since the last report. | | **aws.gamelift.tickets\_timed\_out**(count) | Matchmaking requests that reached the timeout limit since the last report. | | **aws.gamelift.time\_to\_match**(gauge) | For matchmaking requests that were put into a potential match before the last report, the amount of time between ticket creation and potential match creation.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_success**(gauge) | For matchmaking requests that succeeded before the last report, the amount of time between ticket creation and successful match placement.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_cancel**(gauge) | For matchmaking requests that were canceled before the last report, the amount of time between ticket creation and cancellation.*Shown as second* | | **aws.gamelift.rule\_evaluations\_passed**(count) | Rule evaluations during the matchmaking process that passed since the last report. This metric is limited to the top 50 rules. | | **aws.gamelift.rule\_evaluations\_failed**(count) | Rule evaluations during matchmaking that failed since the last report. This metric is limited to the top 50 rules. | | **aws.gamelift.available\_game\_servers**(count) | Game servers that are available to run a game execution and are not currently occupied with gameplay. | | **aws.gamelift.utilized\_game\_servers**(count) | Game servers that are currently occupied with gameplay. | | **aws.gamelift.draining\_available\_game\_servers**(count) | Game servers on instances scheduled for termination that are currently not supporting gameplay. | | **aws.gamelift.draining\_utilized\_game\_servers**(count) | Game servers on instances scheduled for termination that are currently supporting gameplay. | | **aws.gamelift.percent\_utilized\_game\_servers**(count) | Portion of game servers that are currently supporting game executions.*Shown as percent* | | **aws.gamelift.game\_server\_interruptions**(count) | Game servers on Spot Instances that were interrupted due to limited Spot availability. | ### Events{% #events %} The Amazon GameLift integration does not include any events. ### Service Checks{% #service-checks %} The Amazon GameLift integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).