For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/amazon-gamelift.md. A documentation index is available at /llms.txt.

Amazon GameLift

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

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

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that GameLift is enabled under the Metric Collection tab.
  2. Install the Datadog - Amazon GameLift integration.

Log collection

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

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. 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:

Data Collected

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

The Amazon GameLift integration does not include any events.

Service Checks

The Amazon GameLift integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.