--- title: Amazon GameLift description: >- Manages deployment, operation, and scaling of your session-based multiplayer game servers in the cloud. breadcrumbs: Docs > Integrations > Amazon GameLift --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Amazon GameLift Integration version1.0.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ## 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.md) 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.md). 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.md#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.md#collecting-logs-from-cloudwatch-log-group) ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **aws.gamelift.activating\_game\_sessions**(gauge) | The number of game sessions with status activating. | | **aws.gamelift.active\_game\_server\_container\_groups**(gauge) | The number of container groups that are active and ready to host game sessions. | | **aws.gamelift.active\_game\_sessions**(gauge) | The number of game sessions with status active. | | **aws.gamelift.active\_instances**(gauge) | The number of instances with active status. | | **aws.gamelift.active\_server\_processes**(gauge) | The number of server processes with status active. | | **aws.gamelift.available\_game\_servers**(gauge) | The number of FleetIQ game servers that are available to run a game execution and are not currently occupied with gameplay. | | **aws.gamelift.available\_game\_sessions**(gauge) | The number of game session slots on active and healthy server processes that are not being used. | | **aws.gamelift.available\_player\_sessions**(gauge) | The number of player session slots that are available on active game sessions. | | **aws.gamelift.average\_wait\_time**(gauge) | The average amount of time a game session placement request in the queue with status pending has been waiting.*Shown as second* | | **aws.gamelift.average\_wait\_time.maximum**(gauge) | The maximum amount of time a game session placement request in the queue with status pending has been waiting.*Shown as second* | | **aws.gamelift.average\_wait\_time.minimum**(gauge) | The minimum amount of time a game session placement request in the queue with status pending has been waiting.*Shown as second* | | **aws.gamelift.concurrent\_activatable\_game\_sessions**(gauge) | The number of active and healthy server processes that are not currently being used to host a game session and can immediately start a new game session. | | **aws.gamelift.container\_cpu\_reservation**(gauge) | The percentage of CPU resources reserved by containers.*Shown as percent* | | **aws.gamelift.container\_cpu\_reservation.maximum**(gauge) | The maximum percentage of CPU resources reserved by containers.*Shown as percent* | | **aws.gamelift.container\_cpu\_utilization\_per\_instance**(gauge) | The average CPU utilization across all containers on an instance.*Shown as percent* | | **aws.gamelift.container\_cpu\_utilization\_per\_instance.maximum**(gauge) | The maximum CPU utilization across all containers on an instance.*Shown as percent* | | **aws.gamelift.container\_memory\_reservation**(gauge) | The percentage of memory resources reserved by containers.*Shown as percent* | | **aws.gamelift.container\_memory\_reservation.maximum**(gauge) | The maximum percentage of memory resources reserved by containers.*Shown as percent* | | **aws.gamelift.container\_memory\_utilization**(gauge) | The percentage of reserved memory being used by containers.*Shown as percent* | | **aws.gamelift.container\_memory\_utilization.maximum**(gauge) | The maximum percentage of reserved memory being used by containers.*Shown as percent* | | **aws.gamelift.container\_network\_in**(count) | The number of bytes received by containers.*Shown as byte* | | **aws.gamelift.container\_network\_out**(count) | The number of bytes sent by containers.*Shown as byte* | | **aws.gamelift.container\_storage\_read\_bytes**(count) | The number of bytes read from storage by containers.*Shown as byte* | | **aws.gamelift.container\_storage\_write\_bytes**(count) | The number of bytes written to storage by containers.*Shown as byte* | | **aws.gamelift.cpu\_utilization**(gauge) | The percentage of physical CPU time used by EC2 instances backing the fleet location.*Shown as percent* | | **aws.gamelift.cpu\_utilization.maximum**(gauge) | The maximum percentage of physical CPU time used by EC2 instances backing the fleet location.*Shown as percent* | | **aws.gamelift.current\_player\_sessions**(gauge) | The number of player sessions with active or reserved status. | | **aws.gamelift.current\_tickets**(gauge) | The number of matchmaking requests currently being processed or waiting to be processed. | | **aws.gamelift.desired\_instances**(gauge) | The target number of active instances that GameLift is working to maintain in the fleet. | | **aws.gamelift.disk\_read\_bytes**(count) | The bytes read from all instance store volumes available to the EC2 instances backing the fleet.*Shown as byte* | | **aws.gamelift.disk\_read\_ops**(count) | The completed read operations from all instance store volumes available to the EC2 instances backing the fleet.*Shown as operation* | | **aws.gamelift.disk\_write\_bytes**(count) | The bytes written to all instance store volumes available to the EC2 instances backing the fleet.*Shown as byte* | | **aws.gamelift.disk\_write\_ops**(count) | The completed write operations to all instance store volumes available to the EC2 instances backing the fleet.*Shown as operation* | | **aws.gamelift.draining\_available\_game\_servers**(gauge) | The number of FleetIQ game servers on instances scheduled for termination that are not currently supporting gameplay. | | **aws.gamelift.draining\_utilized\_game\_servers**(gauge) | The number of FleetIQ game servers on instances scheduled for termination that are currently supporting gameplay. | | **aws.gamelift.first\_choice\_not\_viable**(count) | The number of game sessions placed but not in the first-choice fleet because the fleet was not viable. | | **aws.gamelift.first\_choice\_out\_of\_capacity**(count) | The number of game sessions placed but not in the first-choice fleet because the fleet had no available resources. | | **aws.gamelift.game\_server\_interruptions**(count) | The number of FleetIQ game servers on spot instances that were interrupted due to limited spot availability. | | **aws.gamelift.game\_session\_interruptions**(count) | The number of game sessions on spot instances that have been interrupted. | | **aws.gamelift.game\_session\_placed**(count) | The number of game sessions that were placed by location. | | **aws.gamelift.healthy\_server\_processes**(gauge) | The number of active server processes that are reporting healthy. | | **aws.gamelift.idle\_game\_server\_container\_groups**(gauge) | The number of container groups that are active but not currently hosting game sessions. | | **aws.gamelift.idle\_instances**(gauge) | The number of active instances hosting zero game sessions. | | **aws.gamelift.instance\_cpu\_utilization**(gauge) | The CPU utilization of EC2 instances backing a container fleet.*Shown as percent* | | **aws.gamelift.instance\_cpu\_utilization.maximum**(gauge) | The maximum CPU utilization of EC2 instances backing a container fleet.*Shown as percent* | | **aws.gamelift.instance\_interruptions**(count) | The number of spot instances that have been interrupted. | | **aws.gamelift.instance\_network\_in**(count) | The number of bytes received on all network interfaces by EC2 instances backing a container fleet.*Shown as byte* | | **aws.gamelift.instance\_network\_out**(count) | The number of bytes sent on all network interfaces by EC2 instances backing a container fleet.*Shown as byte* | | **aws.gamelift.instance\_spot\_interruptions**(count) | The number of spot instances backing a container fleet that have been interrupted. | | **aws.gamelift.instance\_storage\_read\_bytes**(count) | The bytes read from instance store volumes by EC2 instances backing a container fleet.*Shown as byte* | | **aws.gamelift.instance\_storage\_read\_ops**(count) | The completed read operations from instance store volumes by EC2 instances backing a container fleet.*Shown as operation* | | **aws.gamelift.instance\_storage\_write\_bytes**(count) | The bytes written to instance store volumes by EC2 instances backing a container fleet.*Shown as byte* | | **aws.gamelift.instance\_storage\_write\_ops**(count) | The completed write operations to instance store volumes by EC2 instances backing a container fleet.*Shown as operation* | | **aws.gamelift.lowest\_latency\_placement**(count) | The number of game sessions placed in a region that offers the queue's lowest possible latency. | | **aws.gamelift.lowest\_price\_placement**(count) | The number of game sessions placed in a fleet with the queue's lowest possible price for the chosen region. | | **aws.gamelift.match\_acceptances\_timed\_out**(count) | The number of potential matches that timed out during acceptance. | | **aws.gamelift.matches\_accepted**(count) | The number of matches that were successfully accepted by all players. | | **aws.gamelift.matches\_created**(count) | The number of potential matches that were created. | | **aws.gamelift.matches\_placed**(count) | The number of matches that were successfully placed into a game session. | | **aws.gamelift.matches\_rejected**(count) | The number of potential matches that were rejected by at least one player. | | **aws.gamelift.matchmaking\_search\_time**(gauge) | The average time spent searching for matches in matchmaking.*Shown as second* | | **aws.gamelift.matchmaking\_search\_time.maximum**(gauge) | The maximum time spent searching for matches in matchmaking.*Shown as second* | | **aws.gamelift.matchmaking\_search\_time.minimum**(gauge) | The minimum time spent searching for matches in matchmaking.*Shown as second* | | **aws.gamelift.max\_instances**(gauge) | The maximum number of instances allowed for the fleet. | | **aws.gamelift.min\_instances**(gauge) | The minimum number of instances allowed for the fleet. | | **aws.gamelift.network\_in**(count) | The number of bytes received on all network interfaces by EC2 instances backing the fleet location.*Shown as byte* | | **aws.gamelift.network\_out**(count) | The number of bytes sent on all network interfaces by EC2 instances backing the fleet location.*Shown as byte* | | **aws.gamelift.pending\_game\_server\_container\_groups**(gauge) | The number of container groups that are in the process of starting up. | | **aws.gamelift.pending\_instances**(gauge) | The number of instances in pending status that are not yet active. | | **aws.gamelift.percent\_available\_game\_sessions**(gauge) | The percentage of game session slots on all active server processes that are not currently being used.*Shown as percent* | | **aws.gamelift.percent\_available\_game\_sessions.maximum**(gauge) | The maximum percentage of game session slots on all active server processes that are not currently being used.*Shown as percent* | | **aws.gamelift.percent\_healthy\_server\_processes**(gauge) | The percentage of active server processes that are reporting healthy.*Shown as percent* | | **aws.gamelift.percent\_healthy\_server\_processes.maximum**(gauge) | The maximum percentage of active server processes that are reporting healthy.*Shown as percent* | | **aws.gamelift.percent\_idle\_instances**(gauge) | The percentage of all active instances that are idle.*Shown as percent* | | **aws.gamelift.percent\_idle\_instances.maximum**(gauge) | The maximum percentage of all active instances that are idle.*Shown as percent* | | **aws.gamelift.percent\_utilized\_game\_servers**(gauge) | The portion of FleetIQ game servers that are currently supporting game executions.*Shown as percent* | | **aws.gamelift.percent\_utilized\_game\_servers.maximum**(gauge) | The maximum portion of FleetIQ game servers that are currently supporting game executions.*Shown as percent* | | **aws.gamelift.placement\_ap\_east1**(count) | The number of game session placement requests routed to the ap-east-1 Region. | | **aws.gamelift.placement\_ap\_northeast1**(count) | The number of game session placement requests routed to the ap-northeast-1 Region. | | **aws.gamelift.placement\_ap\_northeast2**(count) | The number of game session placement requests routed to the ap-northeast-2 Region. | | **aws.gamelift.placement\_ap\_south1**(count) | The number of game session placement requests routed to the ap-south-1 Region. | | **aws.gamelift.placement\_ap\_southeast1**(count) | The number of game session placement requests routed to the ap-southeast-1 Region. | | **aws.gamelift.placement\_ap\_southeast2**(count) | The number of game session placement requests routed to the ap-southeast-2 Region. | | **aws.gamelift.placement\_ca\_central1**(count) | The number of game session placement requests routed to the ca-central-1 Region. | | **aws.gamelift.placement\_eu\_central1**(count) | The number of game session placement requests routed to the eu-central-1 Region. | | **aws.gamelift.placement\_eu\_west1**(count) | The number of game session placement requests routed to the eu-west-1 Region. | | **aws.gamelift.placement\_eu\_west2**(count) | The number of game session placement requests routed to the eu-west-2 Region. | | **aws.gamelift.placement\_sa\_east1**(count) | The number of game session placement requests routed to the sa-east-1 Region. | | **aws.gamelift.placement\_us\_east1**(count) | The number of game session placement requests routed to the us-east-1 Region. | | **aws.gamelift.placement\_us\_east2**(count) | The number of game session placement requests routed to the us-east-2 Region. | | **aws.gamelift.placement\_us\_west1**(count) | The number of game session placement requests routed to the us-west-1 Region. | | **aws.gamelift.placement\_us\_west2**(count) | The number of game session placement requests routed to the us-west-2 Region. | | **aws.gamelift.placements\_canceled**(count) | The number of game session placement requests that were canceled before timing out. | | **aws.gamelift.placements\_failed**(count) | The number of game session placement requests that failed for any reason. | | **aws.gamelift.placements\_started**(count) | The number of new game session placement requests that were added to the queue. | | **aws.gamelift.placements\_succeeded**(count) | The number of game session placement requests that resulted in a new game session. | | **aws.gamelift.placements\_timed\_out**(count) | The number of game session placement requests that reached the queue's timeout limit. | | **aws.gamelift.player\_gateway\_bytes\_in**(count) | The number of bytes received from players and forwarded to game servers through the DDoS protection layer.*Shown as byte* | | **aws.gamelift.player\_gateway\_bytes\_out**(count) | The number of bytes received from game servers and forwarded to players through the DDoS protection layer.*Shown as byte* | | **aws.gamelift.player\_gateway\_bytes\_throttled**(count) | The number of inbound bytes dropped due to rate limiting by the DDoS protection layer.*Shown as byte* | | **aws.gamelift.player\_gateway\_packets\_in**(count) | The number of UDP packets received from players and forwarded to game servers through the DDoS protection layer. | | **aws.gamelift.player\_gateway\_packets\_out**(count) | The number of UDP packets received from game servers and forwarded to players through the DDoS protection layer. | | **aws.gamelift.player\_gateway\_packets\_throttled**(count) | The number of inbound packets dropped due to rate limiting by the DDoS protection layer. | | **aws.gamelift.player\_gateway\_player\_sessions**(gauge) | The number of player sessions currently protected by the DDoS protection layer. | | **aws.gamelift.player\_session\_activations**(count) | The number of player sessions that transitioned from reserved to active. | | **aws.gamelift.players\_started**(count) | The number of players in matchmaking tickets that were added. | | **aws.gamelift.queue\_depth**(gauge) | The number of game session placement requests in the queue with status pending. | | **aws.gamelift.recycled\_instances**(count) | The number of spot instances that have been recycled and replaced. | | **aws.gamelift.recycled\_spot\_instances**(count) | The number of spot instances backing a container fleet that have been recycled and replaced. | | **aws.gamelift.rule\_evaluations\_failed**(count) | The number of rule evaluations during matchmaking that failed. | | **aws.gamelift.rule\_evaluations\_passed**(count) | The number of rule evaluations during the matchmaking process that passed. | | **aws.gamelift.server\_process\_abnormal\_terminations**(count) | The number of server processes that were shut down due to abnormal circumstances. | | **aws.gamelift.server\_process\_activations**(count) | The number of server processes that have been activated. | | **aws.gamelift.server\_process\_terminations**(count) | The number of server processes that have been terminated. | | **aws.gamelift.terminating\_game\_server\_container\_groups**(gauge) | The number of container groups that are in the process of shutting down. | | **aws.gamelift.terminating\_instances**(gauge) | The number of instances in terminating status. | | **aws.gamelift.tickets\_failed**(count) | The number of matchmaking requests that resulted in failure. | | **aws.gamelift.tickets\_started**(count) | The number of new matchmaking requests that were created. | | **aws.gamelift.tickets\_timed\_out**(count) | The number of matchmaking requests that reached the timeout limit. | | **aws.gamelift.time\_to\_match**(gauge) | The average time between ticket creation and potential match creation for matchmaking requests that were put into a potential match.*Shown as second* | | **aws.gamelift.time\_to\_match.maximum**(gauge) | The maximum time between ticket creation and potential match creation for matchmaking requests that were put into a potential match.*Shown as second* | | **aws.gamelift.time\_to\_match.minimum**(gauge) | The minimum time between ticket creation and potential match creation for matchmaking requests that were put into a potential match.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_cancel**(gauge) | The average time between ticket creation and cancellation for matchmaking requests that were canceled.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_cancel.maximum**(gauge) | The maximum time between ticket creation and cancellation for matchmaking requests that were canceled.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_cancel.minimum**(gauge) | The minimum time between ticket creation and cancellation for matchmaking requests that were canceled.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_success**(gauge) | The average time between ticket creation and successful match placement for matchmaking requests that succeeded.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_success.maximum**(gauge) | The maximum time between ticket creation and successful match placement for matchmaking requests that succeeded.*Shown as second* | | **aws.gamelift.time\_to\_ticket\_success.minimum**(gauge) | The minimum time between ticket creation and successful match placement for matchmaking requests that succeeded.*Shown as second* | | **aws.gamelift.unhealthy\_game\_server\_container\_groups\_replaced**(count) | The number of container groups that were replaced due to health check failures. | | **aws.gamelift.unhealthy\_instances\_replaced**(count) | The number of instances that were replaced due to health check failures. | | **aws.gamelift.utilized\_game\_servers**(gauge) | The number of FleetIQ game servers that are currently occupied with gameplay. | ### 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/).